Google Play URL Builder

Use the tool below to generate URLs for Google Play Campaign Measurement

This builder allows you to easily add UTM parameters to URLs so you can track Custom Campaigns in your Google Analytics account.

Analytics Google Tracking script

5 Share

Fill in the form

Application ID ^*

Android package name published on Google Play.

Campaign Source ^*

original referrer, e.g. google, citysearch, newsletter4

Campaign Medium ^*

marketing medium, e.g. cpc, banner, email

Campaign Term

paid keywords, e.g. running+shoes

Campaign Content

ad-specific content used to differentiate ads

Campaign Name ^*

product, promotion code, or slogan

Campaign ID

GA4 utm_id parameter.

Source platform

GA4 utm_source_platform parameter.

Creative format

utm_creative_format; not currently reported in GA4 properties.

Marketing tactic

utm_marketing_tactic; not currently reported in GA4 properties.

Custom referrer parameters

One key=value pair per line.

BUILD URL

What is the Google Play Url builder?

How you can use it in your campaign?

Measuring campaigns in Google Analytics enables the attribution of campaigns and traffic sources to user activity within your application. These options are available for campaign and traffic source attribution in the Google Analytics SDK for Android:

Google Play Campaign Attribution - See which campaigns, websites, and other apps are referring users to Google Play Store to download your app.
General Campaign & Traffic Source Attribution - See which campaigns or referrers launch your app after it is installed.

Google Play Campaign Attribution

Implementing Google Play campaign attribution

The link contains an encoded referrer parameter. After installation, the app can securely retrieve it through the current Google Play Install Referrer API, together with click and install timestamps and the installed version.

For Kotlin and Java, Google recommends the Play Install Referrer client library. Query it once on the first launch after installation and store the result: the information remains available for 90 days and changes only after a reinstall.

The old com.android.vending.INSTALL_REFERRER broadcast and Google Analytics Android v3 SDK are no longer the implementation model.

Add a referrer parameter to any URLs that will be linking directly to Google Play Store and set the value of that parameter to a string of Google Analytics campaign parameters that describe the source, as in this example:

https://play.google.com/store/apps/details?id=com.example.app&referrer=utm_source%3Dgoogle%26utm_medium%3Dcpc%26utm_term%3Dpodcast%252Bapps%26utm_content%3DdisplayAd1%26utm_campaign%3Dpodcast%252Bgeneralkeywords

Remeber: Google Analytics is case sensitive, so don't duplicate UTM parameters in uppercase or lowercase. Use always the same namespace.

Finally don't use "/" slash character in your UTM parameters, slash is used to separate paths and it can cause problem or error during Analytics recognition data.

Information and examples

Campaign parameters are used to pass information about the traffic sources and campaigns that are bringing users to your app.

The table below contains the available campaign parameters that can be used in Google Play or general campaign measurement:

Campaign ID / Source platform	`utm_id` identifies the campaign; `utm_source_platform` identifies its originating platform.
Application ID `Required`	The final package that is used in your built .apk's manifest Example: com.example.application
Campaign Source `Required`	Campaign source; used to identify a search engine, newsletter, or other source Example: google
Campaign Medium	Campaign medium; used to identify a medium such as email or cost-per-click (cpc) Example: cpc
Campaign Term	Campaign term; used with paid search to supply the keywords for ads Example: running+shoes etc.
Campaign Content	Campaign content; used for A/B testing and content-targeted ads to differentiate ads or links that point to the same URL Example: logolink or textlink
Campaign Name	Manual campaign name used by GA4 to distinguish promotions and initiatives. Example: logolink or textlink