Campaign UTM Custom Parameter

Name: Campaign UTM Custom Parameter
Author: Google Marketing Solutions

Automatically syncs each campaign's name into a Google Ads custom parameter (e.g. {_campaignname}) so that downstream UTM tracking always reflects the current campaign name even after renames. Optionally appends the full UTM string to each campaign's final URL suffix.

Shopping

PMax

utm

tracking

attribution

custom-parameter

mcc

ga4

by Google Marketing Solutions·github.com/google-marketing-solutions/campaign_utm_custom_parameter

Overview

Google Ads' built-in {campaignid} and {campaignname} ValueTrack parameters expose the ID, but the campaign name in URL suffixes goes stale when campaigns are renamed. This script writes the live campaign name into a custom parameter on every Search, Shopping, and Performance Max campaign, keeping your utm_campaign values accurate in GA4 and other analytics tools. Runs against the single account or — if installed at MCC level — every sub-account in the manager.

Setup

1In Google Ads, go to Tools → Bulk Actions → Scripts and click + to create a new script.
2Paste the code below.
3Leave CAMPAIGN_NAME_CUSTOM_PARAMETER as 'campaignname' unless you already use that name; it must match [a-zA-Z0-9]{1,16}.
4Carefully decide on ADD_TO_CAMPAIGN_FINAL_URL_SUFFIX: setting it to true overwrites/extends the campaign-level final URL suffix with a full utm_source/medium/campaign string. Verify your current tracking strategy first — leaving it at false only writes the custom parameter, which is safe.

Ready to Use This Script?

Configuration Variables

Variable	Default	Description
`CAMPAIGN_NAME_CUSTOM_PARAMETER`	'campaignname'	Name of the custom parameter that will hold the live campaign name. Must be 1–16 alphanumeric characters; reference it in URLs as {_<name>}.
`ADD_TO_CAMPAIGN_FINAL_URL_SUFFIX`	false	When true, also writes the full UTM tracker (utm_source/utm_medium/utm_campaign/utm_campaignid) into each campaign's Final URL Suffix. Leave false unless you understand your existing tracking template.

Expected Output

Processing Account "Acme Retail — US"
Processing Account "Acme Retail — EU"
Campaign name missing for campaign ID 1234567890

Notes

Auto-detects MCC vs single account via AdsManagerApp and iterates all sub-accounts when run at MCC level. Campaign names are sanitized: anything outside [a-zA-Z0-9|;_/^(!] is replaced with _, and names are truncated to 250 chars (custom-parameter limit). Only touches Search, Shopping, and Performance Max campaigns — Display, Video, Demand Gen, App, and Hotel campaigns are skipped.