Additional parameters are mainly used to transmit data from the tracking application to an external tool. This can be an analytical tool, such as Google Analytics or a CRM system. With the feature described in this article, you can add additional parameters to the target URLs of all tracking URLs automatically. By doing so, you do not need to hardcode them into target URLs anymore, which makes it a lot easier to manage them.
When using additional parameters you should keep in mind existing parameter forwarding settings:
Parameter forwarding on click redirects
High priority parameter forwarding has a higher priority than additional parameters. Additional parameter value can be overwritten if the same name is configured to be forwarded with higher priority
You will find the additional parameter feature on the page on which you define your advertiser’s tracking settings. You reach this page by clicking on ‘manage advertiser’ in the advertiser section main navigation menu. On the page with the overview of all the advertisers on your platform, click on the icon next to the relevant advertiser. You will find the additional parameter feature in the middle of the page.
On the middle of the tracking settings page, you will find a table called ‘additional parameters’ that will look more or less like this:
This table gives you an overview of all the additional parameters that have already been added to the target URL of tracking URLs of your advertiser. You will find all their properties in the columns. Let’s go through them from left to right:
First, you will find the name of the parameter. This name will also be directly used in the target URL.
The value type defines whether a static value will be transmitted or a dynamic one. A dynamic value is a value drawn from the platform, such as the name of a tracking channel or the ID of an ad media kit. Another option for the value type is the so called external reference mapping. If you choose this type, the parameter will transmit a value that has been registered on the platform via the so called external reference mapping tool.
Obviously, the value type defines what you will find under ‘value’. If you choose a static value type, you will find the actual value here. If you choose a dynamic or the external reference mapping value type, you will find a placeholder indicating the value that will be transmitted in the target URL.
In some cases, the additional parameter will already be hardcoded in the target URL. If there is a ‘yes’ under ‘replace if exist’, the hardcoded parameter will be replaced by the parameter registered here. If there is a ‘no’, this won’t happen.
Under ‘manage’ you have the options to edit and delete the additional parameter.
To attach a new parameter, click on the button ‘add parameter’. If you do so, a page will be loaded looking more or less like this:
Make sure you go through the following steps:
Give your parameter a name. The name will be used in the landing page to identify the parameter.
Choose if the value of the parameter is static, dynamic or whether it should transmit a value registered in the external reference mapping feature.
Choose the parameter value:
In case of a static parameter value, you can just type in the value you want to use.
In case of a dynamic parameter value, please select the value from the drop down menu. The available dynamic parameter values are discussed in the table below. When you have created custom macros, you can also select them here.
In case you want to transmit a value registered in the external reference mapping feature, select the mapping you created.
The position is only relevant if you need to make sure the additional parameter is immediately placed before or after an external parameter. If not, just use the default option ‘automatically’. If you select one of the other options, please make sure you also add the external parameter as well.
Finally, define whether you want the platform to overwrite the value in case it is hardcoded in the target URL of the click URL.
After you have defined these settings, click on the button ‘preview’ to create a preview of the target URL. Please note it will include all the parameters you have added for your advertiser. When you are happy with the preview, make sure you click on ‘add parameter’ in the lower right corner.
Value | Explanation | Example |
---|---|---|
Ad media code | The code containing the channel, the ID of the platform, the partner ID, the ad space ID and the ID of the ad media item. | aff.1234.1234.1234.1234 |
Ad media ID | The ID of the ad media item. | 1234 |
Ad media kit ID | The ID of the ad media kit containing the ad media item. | 1234 |
Ad media kit name | The name of the ad media kit containing the ad media item. | Christmas campaign |
Ad media name | The name of the ad media item. | Main christmas banner |
Ad media size | The size of the ad media item. | 200x300 |
Ad media type | The type of the ad media item: banner, link, HTML or mobile ad media. | banner |
Ad space category | The category of the ad space. | Content |
Ad space ID | The ID of the ad space. | 1234 |
Ad space subcategory | The subcategory of the ad space. | Consumer guides & bloggers |
Advertiser external ID | The ID of the advertiser used by the tracking application. | i123456789 |
Advertiser ID | The ID of the advertiser used on the platform, also called MID. | 1234 |
AMC platform alias | The ID of the platform used in the ad media code. | marketplatform |
AMC net alias | The ID of the platform. | 1234 |
Click ID | The ID generated to identify the click on the ad media item. | 123456789 |
Company name (with UID) | The name of the partner's company, along the partner ID. | Blogging worldwide inc., 1234 |
Company name (without UID) | The name of the partner's company, without the partner ID. | Blogging worldwide inc. |
Device type | The name of the device type used. | Mobile |
Device type abbreviation | The abbreviation of the device type used. | M |
Partner name (with UID) | The name of the partner, along with the partner ID. | Harry Harrions, 1234 |
Partner name (without UID) | The name of the partner, without the partner ID. | 1234 |
Partner ID | The ID of the partner. | 1234 |
Tracking channel | The abbreviation of the tracking channel to which the ad space is allocated. | con |
In some cases, you will need a combination of different dynamic and static values to be transmitted for one parameter. In this case, you can use the so called custom macros. To create one, hit the button ‘manage macros’ in the right corner below the additional paramter panel. If you do so, a page will be loaded looking more or less like this:
Make sure you take the following steps:
Give the custom macro a name. This name will appear in the list of possible dynamic values.
Under ‘dynamic value’, select the dynamic value you want your custom macro to include. Once you have selected the dynamic value, click on ‘add’. To add more dynamic values, simply select and add them in the same manner. Please note that you make sure you add the value that should be up front first. In some cases, this might be a static value.
To add a static value, just enter it under ‘static value’ and click on add.
As soon as you add a dynamic or a static value, it will appear in the preview below. In case you find an error in the preview, use the icon to remove all the values.
Once you are ready, hit the button ‘add macro’ in the right lower corner of the panel. If you do so, it will appear in the table below called ‘custom macros’. Here, you will also be able to delete custom macros created previously, by hitting the icon in the column ‘delete’. Make sure you confirm your action in the system window. Please note you can’t edit existing custom macros.
In the table with the overview of the additional parameters, you will find a column called ‘manage’. Via the icon, you can load the same page on which you add a parameter. Please note that in the right top corner of the page, you will find the date on which the last changes to the parameter were made, along with the name of the user who made them. To edit, just make your changes and hit the ‘add parameter’ button again to save them.
To delete a parameter, use the icon in the same column and confirm your action in the system window.
Well, you can always check the preview below the table with the overview of the additional parameters. But if you want to be sure, you will have to do the following:
Click on ‘partner’ in the main menu and proceed to click on ‘manage partner’. Make sure you find a partner that has an ad space with an active relationship to the advertiser for which you created the additional parameter. If you are not sure how to login as a partner, make sure you follow the instructions in this article.
In the partner UI, go to the ad media section and select the advertiser for which you have added parameters. The parameters will be added to the target URL of all ad media items, so you can pick out any ad media item you want. For comprehensive instructions on the ad media in the partner UI, please read this article.
Once you have selected an individual ad media item or an ad media kit, you will see a table looking more or less like this:
In the left lower corner of every panel related to an individual ad media item, you will find three menu items: the click URL, the link options and the landing page. To check whether the additional parameters have been added, you can either click on it and see whether the parameters appear in your browser, or you can rightclick on the menu item, save the target URL and copy it to an editor.