Creating Tracking Links using Text Editors
Attention
Agency users can't access the campaign data collected via the tracking links that are created using text editors. When creating tracking links, use theAirbridge dashboard, the generator template, or the for seamless data access.
You can create tracking links that work without APIs using text editors such as Notepad and Google Spreadsheet. First, build the basic framework and then add parameters to meet your marketing needs.
Creating tracking links without APIs is recommended if:
You are frequently changing the URL parameter;
You want to create tracking links using your custom template;
You can’t or don’t want to use the tracking link generator template due to security reasons.
Caution
The tracking links created using the Airbridge dashboard, the tracking link generator template, or the tracking link generator API use APIs and can be looked up in the [Tracking Link List] menu. The tracking links created without APIs using text editors can’t be looked up in the [Tracking Link List] menu.
1. Open a text editor such as Notepad and input https:// and the tracking link domain abr.ge/.
2. Input @ and your App Name. The App Name can be found in the [Settings]>[App Settings] menu.
3. Input / and the channel name. Read the following instructions to learn how to input the channel name.
Navigate to [Integrations]>[Ad Channel Integration] to find the channel name and input the name correctly in the tracking link.
To learn more about integrated channels, read this article.
Caution
When creating tracking links for integrated channels, it is advised to create them using the Airbridge dashboard, as certain parameters are only available via APIs.
When creating tracking links without APIs using text editors, the available campaign and channel parameters are limited. Refer to this section to find the list of available parameters.
Input the custom channel name that your organization uses internally. To learn more about custom channels, read this article.
If you want to create a tracking link to use it for a CTA element, input the UTM parameter or airbridge.websdk instead of the channel name. For more details, read this section.
The basic structure of the tracking link should look like the following:
https://abr.ge/@your_app_name/example_channel
your_app_name is the App Name you can find in the [App Settings] menu, and example_channel is the channel you want to track your ads.
Once you have built the basic framework, add different parameters depending on your marketing needs. The order of the parameters within a tracking link does not affect how the tracking link works.
Input ? or & and deeplink_url. Then input = and the deep link URL. The tracking link with the deep link URL parameter should look like the following:
http://abr.ge/@your_app_name/example_channel?deeplink_url={your_deeplink_url}
{your_deeplink_url}is the deep link URL, which is the destination you want to send the users who click the link.
Only the scheme deep link that starts with the URI scheme set in Airbridge can be used as your deep link URL. If you don’t have a deep link URL, navigate to [Tracking Link]>[Deep Link], configure the deep link settings, and request your developer for the deep link URL.
The deep link URL must be encoded before being added to the tracking link - otherwise, the tracking link won’t work. Refer to this section if you want to send users to different destinations using a single deep link.
Tracking links with fallback destination parameters will send users to the app store page or the web URL registered in Airbridge. Navigate to [Settings]>[App Settings]>[App Info] tab to find the app store page and the web URL registered in Airbridge.
Add ?or & and input fallback_android=google-play. The tracking link with the fallback destination for Android users should look like the following:
http://abr.ge/@your_app_name/example_channel?fallback_android=google-play
If you replace google-play with your app’s Google Play Store URL, users will be redirected to the Google Play Store web page.
Add ? or & and input fallback_ios=itunes-appstore. The tracking link with the fallback destination for iOS users should look like the following:
http://abr.ge/@your_app_name/example_channel?fallback_ios=itunes-appstore
If you replace itunes-appstorewith your app’s App Store URL, users will be redirected to the App Store web page.
Add ?or & and input fallback_desktop. Then add = and your desktop fallback URL. The tracking link with the fallback destination for desktop users should look like the following:
http://abr.ge/@your_app_name/example_channel?fallback_desktop={your_desktop_fallback_url}
The desktop fallback URL must be encoded when added. Otherwise, the tracking link won’t work as intended. If you want to send users to different destinations using a dynamic parameter, read this section.
The tracking link with fallback destinations for Android, iOS, and desktop users should look like the following:
https://abr.ge/@your_app_name/example_channel?fallback_android=google-play&fallback_ios=itunes-appstore&fallback_desktop={your_desktop_fallback_url}
{your_desktop_fallback_url}is the web URL you want to send desktop users.
If no fallback destination is added, users are redirected to the following destinations depending on the channel type added in the tracking link. It is advised to add fallback destinations for enhanced user experience.
Integrated ad channel: Users are redirected to the web page of the app store URL or web URL registered in Airbridge. Navigate to [Settings]>[App Settings]>[App Info] tab to find the app store page and the web URL registered in Airbridge.
Custom channel: Users are redirected to Airpage, which will show a QR code that sends users to the app store page to boost app installs.
When creating tracking links without APIs using text editors, the available campaign and channel parameters are limited. The following tables show the campaign and channel parameters that are available.
Parameter | Description | Example |
campaign | Campaign name | campaign=example_campaign |
ad_group | Ag group name | ad_group=example_ad_group |
ad_creative | Ad creative name | ad_creative=example_ad_creative |
campaign_id | Campaign ID | campaign_id=example_campaign_id |
ad_group_id | Ad group ID | ad_group_id=example_ad_group_id |
ad_creative_id | Ad creative ID | ad_creative_id=example_ad_creative_id |
content | Content type | content=example_content |
term | Ad keyword | term=example_term |
Parameter | Description | Example |
click_id | Unique channel ID | click_id=example_click_id |
sub_id | Unique sub-publisher ID | sub_id=example_sub_id |
sub_id_1 | Unique sub-publisher’s publisher ID | sub_id_1=example_sub_id_1 |
If you want to add the keyword parameter, your tracking link should look like the following:
https://abr.ge/@your_app_name/example_channel?term={your_term}
{your_term}is the ad keyword you want to track.
Read the following instructions to create tracking links that meet your specific marketing needs.
You can use tracking links for CTA elements such as web page banners or buttons.
If there are UTM parameters in the web page URL in which the CTA element is included, input each UTM parameter value as a designated parameter value of the tracking link. You may need to request the developer to parse the UTM parameter values first.
The following table shows which UTM parameter to input as which parameter in your tracking link.
UTM Parameter | Input as |
|---|---|
utm_source | channel parameter |
utm_campaign | campaign parameter |
utm_medium | sub_id parameter |
utm_term | term parameter |
utm_content | content parameter |
For example, if the utm_campaign value is your_campaign, your tracking link should look like the following:
https://abr.ge/@your_app_name/example_channel?campaign={your_campaign}
If there are no UTM parameters in the web page URL in which the CTA element is included, input /airbridge.websdk instead of the channel name. If a user opens that web page after being engaged with an ad on an integrated ad channel, that ad channel will be credited for the conversion following the attribution logic of Airbridge. If no ad channel is credited for the conversion, the winning channel will be reported as “airbridge.websdk.”
The tracking link should look like the following:
https://abr.ge/@your_app_name/airbridge.websdk
If you want to send users to different destinations with a single tracking link, input the dynamic parameter value as the deep link URL parameter or the desktop fallback parameter.
You need to request the developer for the dynamic parameter value per URL. The channel and campaign parameters can also be input as dynamic parameters, which you need to request from the developer.
If you input a dynamic parameter value as the deep link URL, your tracking link should look like the following:
https://abr.ge/@your_app_name/example_channel?deeplink_url={your_dynamic_deeplink_url}
{your_dynamic_deeplink_url} is the dynamic parameter value of the deep link URL that will send users who installed your app to different destinations when they click the link.
When sharing a custom channel tracking link created using a text editor on social media, unintended information may be displayed in the link preview. To avoid any trouble, we advise you to go through the following checklist to double-check what information will be displayed in the link preview before sharing the tracking link on social media.
Configure the fallback destination or check the standard settings in the [Tracking Link]>[Social Share Preview] page.
Check whether the fallback destination has been correctly entered.
Check whether the OG tags of the website that are entered as the fallback destination are properly configured.
このページは役に立ちましたか？