We validate your tracking link while registering it on Moloco Cloud DSP to prevent an issue with an incorrect tracking link.

Currently, there are 6 types of error messages you may see when registering the tracking link – invalid link, invalid scheme, invalid host, invalid path, missing required parameter, and invalid parameter.

Invalid link

• You'll see this error message when we can't parse your tracking link properly. The tracking link macros need to be Moloco-supported (List of available macros by Moloco). If any macros within the tracking link are not supported by Moloco, then you'll see this error message.

  https://app.appsflyer.com/com.appsflyer.adNetworkTest ?
  af_sub4={{mtid}} 
  &c={{campaign.title}} 
  &af_siteid={{af_site_id}} // NOT SUPPORTED BY MOLOCO
  &af_ad_type={{creative.type}} 
  &af_cost_currency={{price.cost_currency}} 
  &af_cost_value={{price.cost_amount}} 
  &af_ad_id={{creative.cr_id}}
  &af_cost_model={{price.cost_type}} 
  &af_ad={{creative.title}} 
  &pid=moloco_int 
  &af_click_lookback=7d 
  &clickid={{request.id}} 
  &advertising_id={{device.gaid}} 
  &af_c_id={{campaign.id}} 
  &af_ip={{device.ip}} 
  &af_ua={{device.user_agent}}

• For example, {{af_site_id}} is not one of Moloco's supported macros. In this case, you may want to input either a Moloco macro or a hardcoded value.
• We recommend double-checking the tracking link with the MMP representative to make sure there isn't any missing or incorrect value in the link's structure.

Invalid scheme

• You'll see this error message when the URL scheme is invalid. URL scheme is placed in the very beginning part of the URL before ://. 
• For example,  http is an invalid URL scheme. If you register a tracking link starting with http  then you will see this message: Use ‘https’ instead of ‘http’ in the URL
• You can simply replace the invalid scheme to the valid one in the error message.

Invalid host

• You'll see this error message when the URL's host doesn't match with the tracking company you've selected. URL host is the link domain value after ://.
• Each MMP has its own value or logic for the host of its tracking links. For example, Appsflyer tracking links usually have app.appsflyer.com as their host except for the Onelink™. If you select Appsflyer as the tracking company but set up a tracking link starting with https://app.adjust.com/ then you'll see this error.
• Double-check if you've selected the right tracking company or if there's any typo in the host.

Invalid path

• You'll see this error message when the URL's path has an unusual value. The path is the value after the host and MMP tracking links usually contain app information in the path.
• As you can see in the image above, the Appsflyer tracking link has the app's Google Play Store bundle ID. If it has an unusual value such as 1111, then the error message will be shown.
• Inquire your MMP representative to check if the path has an incorrect value or not.

Missing required parameter

• You'll see this error message if the tracking link doesn't have mandatory parameters. The parameter is a part of the tracking link that follows ? in your links.  You can see that there are sets of key=value separated by & like the image below. The value placed before = is MMP's parameter and it determines the name of the columns where MMP will store the data. 
  
  
  
• We have some mandatory parameters to send the data significant for the attribution. By clicking Add all missing parameters text, we'll automatically add the missing required parameter to your tracking link.

Invalid parameter

• You'll see this error if the value paired with each parameter is invalid. The value of the tracking link parameter is usually set with macros Moloco provides. And we can dynamically replace the macro with the corresponding campaign's value, such as the campaign name. 

• You can easily find solutions for each case in the error message like the example below. If the error message shows multiple solutions, refer to this section with full lists and descriptions of Moloco macros and MMP parameters to decide on the macro to select among those.
  • The value of this parameter isn’t valid. It should equal/contain one of the following:
    • [solution 1]
    • [solution 2]
    • [solution 3]

[Appsflyer only] Wrong App ID

• The tracking link's app_id value must be identical to the MMP bundle ID of the app it is linked to. Double check to be sure the two values are identical. 

[Adjust only] Missing host value for app

• You must have registered host values for Universal and Branded tracking links at the app registration stage. Go to Apps and click Create to register a new app first. On the New App page, selecting ADJUST for MMP displays Universal link host and Branded link host where you can enter the host value for your Universal and Branded links respectively.

[Adjust only] Wrong host value

The Universal or Branded tracking link's host value must be identical to the host value registered for the app it is linked to. Double check to be sure the two values are identical.