How to set up Google Ad Precautionary Tracking Script

Modified on: Wed, 14 Sep, 2022 at 11:55 AM

Covered in this article:

How to set up Google Ad Precautionary Tracking Script

Step 1: Visit your Google Ad account

Step 2: Click on Tools and Settings > Bulk Actions > Scripts (See image below)

Step 3: Next, we need to remove the predefined code and add this script:

Step 4: After closing, we need to change the name of the script and change the frequency from the list to the Hourly view.

Frequently Asked Questions

- If I have another script, will it affect it?

- Why do I need to authorise it?

How to set up Google Ad Precautionary Tracking Script

The script is a simple example of how you would set up the Google AdPrecautionary tracking code.

The script acts as a fail-safe if the UTM template fails in capturing the attribution data.

It will track all clicks on a particular link and send it to Google Analytics. The only thing that needs to be changed in this script is the URL for the tracking page, which should match the one used by your website.

Step 1: Visit your Google Ad account

Step 2: Click on Tools and Settings > Bulk Actions > Scripts (See image below)

Step 3: Next, we need to remove the predefined code and add this script:

function main() {

    var TrackingTemplate = "{lpurl}?utm_source=adwords&utm_medium={AdName}&utm_campaign={CampaignName}&utm_content={AdGroupName}&utm_keyword={keyword}&utm_matchtype={matchtype}&campaign_id={campaignid}&ad_group_id={adgroupid}&ad_id={creative}";

    var CAMPAIGNCONTAINS = "";

    var ADGROUPCONTAINS = "";

    var STATUS = "ENABLED";

    if (TrackingTemplate.search(/{AdGroupName}|{CampaignName}|{AdName}/g) == -1) {

        Logger.log("Enter at least one of the {CampaignName} or {AdGroupName} or {AdName} parameter in the tracking template");

        return

    }

   

    if (TrackingTemplate.search("{AdGroupName}") > 0) {

        var adgroupIterator = {

            hasNext: function() {

                return false

            }

        }

        if (_ADGROUP_CONTAINS == "" && CAMPAIGNCONTAINS == "") {

            adgroupIterator = AdsApp.adGroups().withCondition("Status = " +  STATUS).get();

        } else if (_ADGROUP_CONTAINS == "" && CAMPAIGNCONTAINS !== "") {

            adgroupIterator = AdsApp.adGroups().withCondition("CampaignName contains '" + CAMPAIGNCONTAINS + "'").withCondition("Status = " + STATUS).get();

        } else if (_ADGROUP_CONTAINS !== "" && CAMPAIGNCONTAINS !== "") {

            adgroupIterator = AdsApp.adGroups().withCondition("CampaignName contains '" + CAMPAIGNCONTAINS + "'").withCondition("Name contains '" + ADGROUPCONTAINS + "'").withCondition("Status = " + STATUS).get();

        } else if (_ADGROUP_CONTAINS !== "" && CAMPAIGNCONTAINS == "") {

            adgroupIterator = AdsApp.adGroups().withCondition("Name contains '" + ADGROUPCONTAINS + "'").withCondition("Status = " + STATUS).get();

        }

        if (!adgroupIterator.hasNext()) {

            Logger.log("No Campaigns/Adgroups matched with this condition");

            return

        }

        while (adgroupIterator.hasNext()) {

            var adgroup = adgroupIterator.next();

            var adgrouptemplate = TrackingTemplate.replace(/{AdGroupName}/g, adgroup.getName().replace(/\s/g, '%20'))

            if (TrackingTemplate.search("{CampaignName}") > 0) {

                adgrouptemplate = adgrouptemplate.replace(/{CampaignName}/g, adgroup.getCampaign().getName().replace(/\s/g, '%20'))

            }

            if (TrackingTemplate.search("{AdName}") > 0) {

                var adsIterator = adgroup.ads().get();

                while (adsIterator.hasNext()) {

                  var ad = adsIterator.next();

                  var adType = ad.getType();

                  var headline = "";

                  if (ad.getHeadline()) {

                    headline = ad.getHeadline();

                  } else if(ad.isType().expandedTextAd()) {

                    headline = ad.asType().expandedTextAd().getHeadlinePart1();

                  } else if(ad.isType().gmailImageAd()) {

                    headline = ad.asType().gmailImageAd().getName();

                  } else if(ad.isType().gmailMultiProductAd()) {

                    headline = ad.asType().gmailMultiProductAd().getHeadline();

                  } else if(ad.isType().gmailSinglePromotionAd()) {

                    headline = ad.asType().gmailSinglePromotionAd().getHeadline();

                  } else if(ad.isType().html5Ad()) {

                    headline = ad.asType().html5Ad().getName();

                  } else if(ad.isType().imageAd()) {

                    headline = ad.asType().imageAd().getName();

                  } else if(ad.isType().responsiveDisplayAd()) {

                    headline = ad.asType().responsiveDisplayAd().getShortHeadline();

                  } else if(ad.isType().responsiveSearchAd()) {

                    var headlines = ad.asType().responsiveSearchAd().getHeadlines();

                    if (headlines && headlines[0].text) {

                      headline = headlines[0].text;

                    }

                  }

                  Logger.log("Headline text : " + headline);

                  if (headline) {

                    adgrouptemplate = adgrouptemplate.replace(/{AdName}/g, headline.replace(/\s/g, '%20'))

                  } else {

                    adgrouptemplate = adgrouptemplate.replace(/{AdName}/g, ad.getId())

                  }

                }

            }

            adgroup.urls().setTrackingTemplate(adgrouptemplate);

            Logger.log(adgroup.getCampaign().getName() + " => " + adgroup.getName() + " => " + adgrouptemplate)

        }

    }

}

Step 4: After closing, we need to change the name of the script and change the frequency from the list to the Hourly view.

Frequently Asked Questions

If I have another script, will it affect it?

Yes, Scripts can override as it is affecting UTM parameters.

Why do I need to authorise it?

Authorisation is needed for the script as it gets implemented on Google Ad Account. It is necessary to check the preview before running it, it should show the majority of campaigns as successful with the landing page found.

Did you find this article helpful?