DeepLink Plan - Creating Tracking Links in Bulk Using the Generator Template
The Tracking Link Generator Template is a Google spreadsheet file for creating Airbridge tracking links using the tracking link API and Google Apps Script. It allows you to easily generate tracking links in bulk.
Complete the following steps before using the Generator Template.
1. Go to Google Workspace Marketplace and install the Airbridge Tracking Link Generator. We recommend logging in to your Google account first before clicking Install.
2. When the pop-up window opens asking for your permission, click Continue.
3. Choose a Google account to continue.
4. Scroll down and click Allow.
5. When the pop-up window opens confirming the install, click Done.
The App Name and Tracking Link API Token can be found on the [Settings]>[Tokens] page. You can copy the values by clicking on them.
Click the link below to create a copy of the Airbridge Tracking Link Generator Template (DeepLink Plan).
Follow the steps below to create tracking links using the Generator Template.
1. Create a copy of the Airbridge Tracking Link Generator Template (DeepLink Plan). The new copy will be saved in your Google Drive. You'll need to be logged in to your Google account.
2. In the [Required info] tab, enter the App Name and Tracking Link API Token, which can be found on the [Settings]>[Token] page of the Airbridge dashboard.
3. Enter the parameter values in the [Create Tracking Links] tab. The Channel parameter is a required field. Others are not required to create a tracking link. Only lowercase letters, numbers, and underscores are supported. Do not enter special characters or spaces.
For more details about the parameters, refer to this section of the article.
4. Select [Extensions]>[Airbridge Tracking Link Generator]>[Generate Tracking Links] from the top menu bar to create tracking links.
If you don't see the [Extensions]>[Airbridge Tracking Link Generator]>[Generate Tracking Links] in the menu bar, refresh the sheet or reinstall the Airbridge Tracking Link Generator.
Editing parameters of a tracking link
Once a tracking link is created, the changes made to the parameter values in the Generator Template won't be applied. If you want to make changes to the parameters of a tracking link, delete the tracking link and create a new one.
When you create a tracking link using the Tracking Link Generator Template, up to 2 types of tracking links are generated.
A tracking link with click as
ad_typeA short version of the tracking link
The tracking links created from the Generator Template can be found on the [Tracking Link]>[Link Management] page in the Airbridge dashboard. Even if you delete a tracking link from the Generator Template, it will remain on the [Link Management] page. For more details on how to manage the tracking links, refer to this article.
Refer to the information below to learn about different parameters.
The Channel parameter is a required field. Only lowercase letters, numbers, and underscores are supported. Do not enter special characters or spaces.
Campaign optimization parameters are used to collect data for campaign optimization. The parameters can be selected as GroupBys or a filter option in the Airbridge reports.
Parameter | Description |
|---|---|
Campaign | Campaign name |
Ad group | Ad group name |
Ad creative | Ad creative name |
Content | Ad type |
Keyword | Ad keyword |
Sub-publisher | Sub-publisher of the ad channel |
The destination path is the URL where users are directed after clicking an ad with the tracking link embedded.
Destination |
Description |
Note |
|---|---|---|
Web Landing URL | The destination all users are sent to, regardless of their operating system or whether they have the app installed | If the Web Landing URL is entered, other destinations cannot be entered |
Deep Link | The in-app page that users are sent to if they have the app installed |
|
Stopover Airpage | When selecting “Add Airpage,” iOS users who click the tracking link from an app other than Safari are sent to a Stopover Airpage before being redirected to the intended destination to avoid bound-offs | |
Android Fallback Path | The destination where Android users who haven’t installed the app are sent to | - Users are sent to Google Play Store when entering - Users are sent to the Google Play Custom Store Listing page when entering the entire webpage URL starting with “http” |
iOS Fallback Path | The destination where iOS users who haven’t installed the app are sent to | - Users are sent to App Store when entering - Users are sent to the App Store Custom Product Page when entering the entire webpage URL starting with “http” - Users are sent to the desired destination when entering the URL |
Desktop Fallback Path | The destination where desktop users who haven’t installed the app are sent to | - Users are sent to the Airpage when leaving the field blank - Users are sent to the desired webpage when entering the webpage URL |
There are 2 ways to configure the social share preview of the tracking link for custom channels.
Configuring the thumbnail, title, and description by entering values
You can configure the social share preview by entering values for the [Image URL], [Title], and [Description] fields.
Attention
If you leave any field for the [Image URL], [Title], and [Description] columns blank, unintended images, titles, or descriptions may appear.
Using the OG tags from the desktop webpage URL
When selecting “Use OG tags” for the [OG tags of the web desktop URL] field, the image, title, and description in the social share preview are pulled from the OG tags of the web landing URL or the desktop fallback URL. This option can't be used if you enter the image, title, and description into the respective fields.
When selecting “Use OG tags” without configuring the destination for user redirection (web landing URL or the desktop fallback path), Airbridge will pull the OG tag information of the website URL configured on the [App Settings] page in the Airbridge dashboard to create the social share preview.
If unintended thumbnails, titles, and descriptions appear, the following tips might be helpful.
Make sure the desktop URL is correctly entered. It must include
http://orhttps://.Make sure you don't enter any value for the [Image URL], [Title], and [Description] fields.
Make sure the OG tags of the desktop URL are properly configured. The problem could stem from the URL or network error. Refer to this article to learn more.
The social share preview settings cannot be changed using the Generator Template if you have selected "Use OG tags” for the [OG tags of the web desktop URL] field to configure the social share preview. If you need to change the settings, go to [Tracking Link]>[Link Management] in the Airbridge dashboard, find the tracking link, click [Action]>[View details · Edit]>[Social Share Preview], and update the settings. If you have updated the OG tag information, click Refresh on the [Link Management] page to make sure the social share previews appear accordingly.
Enter the short link ID for tracking link branding. If not entered, it will be randomly set and can’t be changed afterward.
To be able to use this feature, you need to set your custom domain in your Airbridge dashboard. Refer to this article for custom domain configuration.
If you want to edit the parameter values of tracking links you created in the Generator Template, you can do so in the [Change Parameters] tab of the Generator Template.
While the Tracking Link API is used to create tracking links in the [Create Tracking Links] tab, the REGEXREPLACE function allows for quick parameter value replacement in the [Change Parameters] tab.
Moreover, unlike the [Create Tracking Links] tab, the [Change Parameters] tab is not subject to Google Apps Script's script runtime limitation.
1. From the [Create tracking links] tab, enter link names for tracking links in the Link Name column. The link names serve as the identifier for individual tracking links and shall be unique.
Link names must be unique
If a single link name is entered for multiple tracking links, you can't edit the parameter values of different tracking links in the [Change Parameters] tab properly because only the first tracking link with the entered link name from the list will be considered for the parameter value replacement.
2. In the [Change parameters] tab, select the tracking link name from the Link Name drop-down list of which you want to edit the parameter value.
3. Enter the parameter values in the white fields. The grey fields indicate the parameters that are not configured in the selected tracking link.
4. The updated tracking links appear in column K. They are click-types and are updated in real-time whenever the parameter values are updated.
Was this page helpful?