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.

Pre-setup

Complete the following steps before using the Generator Template.

Install the Airbridge Tracking Link Generator

Go to Google Workspace Marketplace and install the Airbridge Tracking Link Generator. We recommend logging in to your Google account first before clicking Install.
When the pop-up window opens asking for your permission, click Continue.
Choose a Google account to continue.
Scroll down and click Allow.
When the pop-up window opens confirming the install, click Done.

Find the App Name and Tracking Link API Token

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.

Creating Tracking Links in Bulk

Depending on the type of channel that you want to use the tracking link for, you need to use the appropriate template for creating tracking links. There are 2 versions of the Generator Template:

Click on the links above to create a copy of them. Make sure you are using the right one, considering the purpose of the tracking link. For example, if you want to create a tracking link to track your campaign on an Integrated Channel, you MUST use the Generator Template for Integrated Channels. If you use the Generator Template for Custom Channels instead, the tracking links may not work as intended.

Creating tracking links for Integrated Channels

To track campaigns on paid ad channels that are integrated with Airbridge, you must create tracking links for Integrated Channels. The ad channels that are integrated with Airbridge can be looked up on the [Integration]>[Ad Channel Integration] page in the Airbridge dashboard. You can also refer to this article. Read on to learn how to create and manage tracking links for Integrated Channels.

Creating tracking links using the Generator Template for Integrated Channels

Click the link below and click Create copy. The new copy will be saved in your Google Drive.
- Tracking Link Generator Template for Integrated Channels

If you want to create tracking links for Custom Channels, you must use a copy of the Tracking Link Generator Template for Custom Channels. Refer to this section of this article.

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.

Enter the parameter values in the [Create tracking links] tab. The Channel parameter is a required field. When clicking the Channel field, the drop-down menu will show all channels that are integrated with Airbridge, which are also visible on the [Ad Channel Integration] page in the Airbridge dashboard.

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 linkOnce 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.

Managing tracking links created with the Generator Template for Integrated Channels

When you create a tracking link using the Tracking Link Generator Template for Integrated Channels, up to 3 types of tracking links are generated, depending on the touchpoint type (ad_type).

Click
Impression
Server-to-Server (S2S) Click

Difference in the number of tracking links generated by ChannelEach channel supports different touchpoint types for which tracking links are generated. Therefore, the number of tracking links generated varies by channel.For example, tracking links for only ad clicks might be generated for Channel A, while tracking links for all 3 touchpoint types might be generated for Channel B.

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.

Creating tracking links for Custom Channels

To track campaigns on owned or earned media channels with Airbridge, you must create tracking links for Custom Channels. For more details on Custom Channels, refer to this article. Read on to learn how to create and manage tracking links for Custom Channels.

Creating tracking links using the Generator Template for Custom Channels

Click the link below and click Create copy. The new copy will be saved in your Google Drive.
- Tracking Link Generator Template for Custom Channels

If you want to create tracking links for Integrated Channels, you must use a copy of the Tracking Link Generator Template for Integrated Channels. Refer to this section of this article.

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.

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.
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.

Managing tracking links created with the Generator Template for Custom Channels

When you create a tracking link using the Tracking Link Generator Template for Custom Channels, 2 types of tracking links are generated, depending on the touchpoint type (ad_type).

A long link that tracks Clicks
A short URL of the tracking link

AttentionShort URL are supported for tracking links for Custom Channels only.If you enter the channel name of an Integrated Channel in the Generator Template for Custom Channels, short URL won’t be created. Make sure not to enter an Integrated Channel in the Generator Template for Custom Channels, as the tracking links may not work as intended.

The tracking links created from the Generator Template can be found on the [Tracking Link]>[List 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.

Parameters

Refer to the information below to learn more about the parameters.

Channel Parameter

The Channel parameter is a required field.When clicking the Channel field in the Generator Template for Integrated Channels, the drop-down menu will show all channels that are integrated with Airbridge, which are also visible on the [Ad Channel Integration] page in the Airbridge dashboard.In the Generator Template for Custom Channels, only lowercase letters, numbers, and underscores are supported. Do not enter special characters or spaces.

Campaign Optimization Parameters

Campaign optimization parameters are used to collect data for campaign optimization. The parameters can be selected as GroupBys or filter option in the Airbridge reports.The sub-publisher and sub-sub-publisher parameters can only be used for specific tracking purposes. Therefore, the sub-publisher and sub-sub-publisher parameter columns shall be left blank in the Generator Template if there have been no talks with the ad channels beforehand.

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
Sub-sub publisher 1	Level 1 publisher below Sub-publisher
Sub-sub publisher 2	Level 2 publisher below Sub-publisher
Sub-sub publisher 3	Level 3 publisher below Sub-publisher

Destination

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 `google-play` or leaving the field blank - 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 `itunes-appstore` or leaving the field blank - 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

Sending users to specific destinations per platformBy filling in the “Android Fallback,” “iOS Fallback,” and “Desktop Fallback” fields with the respective destination URLs while leaving the “Web Landing URL” and “Deep Link” fields empty, users will always be redirected to the respective destinations.

Campaign Attribution Parameter

Under [Events for Attribution], select which events can be attributed to the ad channel where the tracking link is used.We recommend selecting All Events unless you want to attribute only app installs or deep link events, along with their subsequent events.

NoteSelect All Events unless you want to exclude app installs or deep link events, along with their subsequent events, from attribution.

Each option attributes the following events.

Option	Sub-option	Events tracked
Left empty	-	All events
On: True	Deeplink Opens and Deeplink Pageviews only	- Deeplink Opens (App) - Deeplink Pageviews (App) - Subsequent events of Deeplink Opens (App) and Deeplink Pageviews (App)
On: False	Installs only	- Installs (App) - Subsequent events of Installs (App)

The following parameters are configurable only in the Generator Template for Custom Channels.

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 valuesYou can configure the social share preview by entering values for the [Image URL], [Title], and [Description] fields.

AttentionIf 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 URLWhen 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:// or https://.
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.

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.

Short Link ID

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.

Changing parameter values

If you want to edit the parameter values of tracking links you created in the Generator Template, you can do so in the [Changing parameters] tab, which is available in the Generator Template for Integrated Channel and Custom Channel. 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 [Changing parameters] tab is not subject to Google Apps Script’s script runtime limitation.

How to change parameter values

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 uniqueIf 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.

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.

Enter the parameter values in the white fields. The grey fields indicate the parameters that are not configured in the selected tracking link.

For example, the tracking link, link 1, has the campaign, ad creative, content, and sub-publisher parameters configured. Therefore, you can enter the parameter values into the white fields of the campaign, ad creative, content, and sub-publisher parameters to change some of the tracking link’s parameter values.

The updated tracking links appear in column O. They are click-types and are updated in real-time whenever the parameter values are updated.

AttentionUnlike the tracking links created in the [Create tracking links] tab, the tracking links updated with new parameter values in the [Change parameters] tab cannot be viewed on the [Tracking Link]>[Link Management] page in the Airbridge dashboard because the Tracking Link API is not involved in the update.The data collected by the tracking link updated in the [Change parameters] tab can be viewed in the Actuals Report, just like the data collected by the tracking link created in the [Create tracking links] tab.

​Pre-setup

​Creating Tracking Links in Bulk

​Creating tracking links for Integrated Channels

​Creating tracking links for Custom Channels

​Parameters

​Changing parameter values

​How to change parameter values

Pre-setup

Creating Tracking Links in Bulk

Creating tracking links for Integrated Channels

Creating tracking links for Custom Channels

Parameters

Changing parameter values

How to change parameter values