Tracking for Google Analytics
The Adjust Google Analytics integration makes it easy to pass data from Adjust to your Google Analytics dashboard. This guide describes how to configure your Adjust Dashboard to fill in attribution data in Google Analytics.

Note: Google Analytics and its related documentation use slightly different terminology. You can refer to the Google Analytics naming conventions section below to compare Google’s terminology with Adjust’s.

Activating the Adjust Google Analytics integration

Adjust can share attribution data with Google Analytics in just a few easy steps. Follow the instructions below to activate the Adjust Google Analytics integration.

How to activate the Google Analytics module in the Adjust Dashboard

In the Adjust Dashboard
  1. Navigate to your app and select your app options caret (^)
  2. Select Partner Setup > Add Partners > Google Analytics
  3. Enter your Google Analytics tracking ID in the TRACKING ID field
    • You can find this tracking ID in your Google Analytics admin panel. If your app has multiple country-specific tracking IDs, enter the global (top-level) tracking ID. Learn more.
  4. Select Save
Once you have completed the steps above, Adjust will immediately begin to forward install data to Google Analytics. Read on for further instructions to set up and customize the Adjust Google Analytics integration.

If your app includes the Google Analytics SDK

If the Adjust SDK and the Google Analytics SDK are both integrated into your app, you must add session partner parameters to the Adjust SDK. (See our relevant documentation for iOS and Android.)

This is required because Google creates a cid -- a unique client ID -- for every device which installs an app containing the Google Analytics SDK. If Adjust sends data to Google without a matching cid value, then Google can’t match their data with ours.

Session partner parameters allow the Adjust SDK to track Google’s cid and include it when sending data to Google. If the Adjust SDK doesn’t include session partner parameters, Adjust will automatically send the advertising ID (idfa or gps_adid) instead and this won’t match the cid value on Google’s end.

If your app has multiple Google tracking IDs

If your app has multiple country-specific tracking IDs, use the global (top-level) tracking ID to activate the Adjust Google Analytics integration.

Then, you can use the google_country_property_id=[value] click parameter to append country (lower-level) IDs onto clicks. This parameter will result in multiple callbacks being fired: one for each ID. Note that click parameter values are not always available, e.g., for organic traffic.

Customizing the Adjust Google Analytics integration

Forward Adjust-tracked events to Google Analytics

Event linking allows Adjust to pass detailed event data directly to Google Analytics. Every Adjust-tracked in-app event can be mapped to a predefined or custom Google Analytics event. A predefined event refers to a select list of preset labels that Google Analytics will use in organizing user data, while custom events refer to unique naming conventions determined by you, the account user.

To share in-app event data with Google Analytics, follow these steps:

In the Adjust Dashboard
  1. Navigate to your app and select your app options caret (^)
  2. Select Partner Setup > Google Analytics > Event Linking
  3. Select FILL ALL WITH EVENT NAMES to use the same event names on both Adjust and Google Analytics, or fill the fields with custom event names to appear on Google Analytics
  4. Select Save
Adjust will now forward event data to Google Analytics.

Note: To avoid duplicate data on Google Analytics, do not set up event linking on Adjust if the Google Analytics SDK is integrated into your app and already tracks in-app events.

Forward revenue data to Google Analytics

Revenue forwarding allows Adjust to pass detailed revenue data directly to Google Analytics. After setting up event linking on Adjust (instructions above), follow these steps to share in-app revenue data with Google Analytics.

In the Adjust Dashboard
  1. Navigate to your app and select your app options caret (^)
  2. Select Partner Setup > Google Analytics
  3. Toggle the Revenue Forwarding switch to ON
Adjust will now forward revenue data to Google Analytics.

Note: To avoid duplicate data on Google Analytics, do not set up revenue forwarding on Adjust if the Google Analytics SDK is integrated into your app and already tracks in-app purchases.

How to forward session data to Google Analytics

To share Adjust-tracked sessions and reattributions with Google Analytics, follow these steps:

In the Adjust Dashboard
  1. Navigate to your app and select your app options caret (^)
  2. Select Partner Setup > Google Analytics
  3. Toggle the Session Forwarding switch to ON
Adjust will now forward session data to Google Analytics.

Note: To avoid duplicate data on Google Analytics, do not set up session forwarding on Adjust if the Google Analytics SDK is integrated into your app and already tracks in-app sessions.

Optimizing the Adjust Google Analytics integration with parameters

You can optimize your Adjust Google Analytics integration with click parameters and partner parameters. These parameters make it easy to track insightful data specific to your app -- think SKUs, transaction IDs, item prices, and more.

Follow the instructions below to share custom data with Google Analytics. This custom data will also be included in your own callbacks from Adjust.

How to forward custom event data to Google Analytics

Partner parameters allow Adjust to collect custom event data from your app and transmit it directly to Google Analytics. From item categories to coupon codes, partner parameters are a useful way to collect and share detailed data specific to your app events.

Partner parameters must be set up within the Adjust SDK. For developer instructions, by platform, refer to the links below. (You can read Google’s specifications for each event parameter in the Google developers guide.)

Once the SDK modifications are complete, follow the steps below to enable parameter forwarding within the Adjust Dashboard, as well.

Instructions

In the Adjust Dashboard
  1. Navigate to your app and select your app options caret (^)
  2. Select Partner Setup > Google Analytics
  3. Toggle the Parameter Forwarding slide to ON
  4. Select Partner Parameter Mapping
  5. In the partner parameter mapping tab, you will see two fields: FROM APP and TO GOOGLE ANALYTICS. In the FROM APP field, insert the name of your Adjust partner parameter, as written into the Adjust SDK. Then, in the TO GOOGLE ANALYTICS field, insert your corresponding Google-defined name.
  6. Select SAVE
Adjust will immediately begin forwarding custom event details directly to Google Analytics for any of your linked events.

Developer instructions for writing partner parameters within the Adjust SDK

Full list of accepted Google Analytics parameters

Before reviewing the full list of partner parameters supported by Google Analytics, note that Google requires the following parameters for every event (called “hit types” on Google):
Hit typeRequired parameter
transactionti
itemin, ti
If these required parameters are missing, the events will be transmitted as events rather than Google’s specific hit types.

Here is the full list of available partner parameters you can set within the Adjust SDK for each event:
NameName in SDK: Example ValueTypeEventItemScreenviewTransactionNotes
Google Analytics User ID
userId: df45346424
stringyesyesyesyesThis optional but recommended parameter tags your Adjust-tracked traffic with Google Analytics' user ID. This allows Google to attribute traffic across a single user's devices.
Anonymize IPaip: 1booleanyesyesyesyesSender's IP address is anonymized only if any of the following examples are in the payload: &aip=&aip=0&aip=1, etc.
Campaign Content
cc: content
string, 500Byesyesyesyes 
Screen Name
cd: High Scores
string, 2048ByesyesyesyesCan be appended on click or within the SDK. The click value will override the SDK value.
Campaign ID
ci: ID
string, 100Byesyesyesyes 
Campaign Keyword
ck: Blue Shoes
string, 500Byesyesyesyes 
Campaign Medium
cm: organic
string, 50Byesyesyesyes 
Currency Code
cu: EUR
string, 10Bnoyesyesno 
Coupon Code
tcc: SUMMER08
string, 500Byesyesyesyes 
Google Display Ads ID
dclid: d_click_id
stringyesyesyesyes 
Document Encoding
de: UTF8
string, 20Byesyesyesyes 
Document Title
dt: settings
string, 1500Byesyesyesyes 
Event Action
ea: Action
string, 500Brequirednonono 
Event Category
ec: Category
string, 150Brequirednonono 
Event Label
el: Label
string, 500Byesnonono 
Event Value
ev: 55
intyesnonono 
Google Adwords ID
gclid
string, 500Byesyesyesyes 
Item Code/SKU
ic: SKU 45
string, 500Bnoyesnono 
Item Name
in: Shoe
string, 500Bnorequirednono 
Item Price
ip: 3.50
floatnoyesnonoPrecision of up to 6 decimal digits. Can be negative. Default is 0.
Item Quantity
iq: 4
intnoyesnonoDefault is 0.
Item Category
iv: Blue
string, 500Bnoyesnono 
Non-Interaction Hit
ni: 1
booleanyesyesyesyesThe following values specify whether a hit is non-interactive: 0 = interactive; 1 = non-interactive. The value for installs, sessions and reattributions is 0 as they require the user's app to be open.
Screen Colors Depth
sd: 24bits
string, 20Byesyesyesyes 
Screen Resolution
sr: 800x600
string, 20Byesyesyesyes 
Transaction Affiliation
ta: Member
string, 500Bnononoyes 
Transaction ID
ti: 0D564
string, 500Bnorequirednorequired 
Transaction Revenue
tr: 15.47
currencynononoyes 
Transaction Shipping Cost
ts: 3.5
floatnononoyesPrecision of up to 6 decimal digits, can be negative, default is 0.
Transaction Tax
tt: 11.20
floatnononoyesPrecision of up to 6 decimal digits, can be negative, default is 0.
Viewport Size
vp 123x456
string, 20Byesyesyesyes 

How to send tracker-level data to Google Analytics

You can pass campaign information and other data to Google Analytics by appending Google click parameters to your Adjust tracker URL. (Learn more about appending click parameters.)

Google Analytics supports the following click parameters:
NameAdjust Click Parameter NameGoogle Parameter Name: Example ValueTypeNotes
Campaign Medium
utm_medium
utm_medium: organic
string, 50B 
Campaign ID
utm_id
utm_id: ID
string, 100B 
Google Display Ads ID
dclid
dclid: CL6Q-0XyqKUCFcgK2goddQuoHg
stringAutomatically appended by Google. This is not mandatory: if it is appended, it will override the automatically-appended Adwords ID.
Screen Name
google_cd
cd: High Scores
string, 2048BCan be appended on click or by the SDK. The click value will override the SDK value.

Here is an example of an Adjust tracker URL generated through the Campaign Wizard with appended click parameters:
 
https://app.adjust.com/def456?utm_medium=[network macro for utm_medium or hardcoded value from the client or hardcoded value from the client]&utm_id=[network macro for utm_id or hardcoded value from the client]&dclid=[network macro for google display ads id or hardcoded value from the client]&gclid=[network macro for google adwords or hardcoded value from the client]&google_cd=[network macro for screen name or hardcoded value from the client]

Google Analytics naming conventions

Adjust and Google Analytics sometimes use different naming conventions for events and campaign structures. Use this section as a reference when reviewing Google's platform and documentation.

Hit types

Google uses the term "hit" to describe what Adjust calls "activities" or "events." Google Analytics has four hit types:
Google Analytics hit typeAdjust equivalent
event
installs, reattributions, or events
transaction
revenue events
item
events that include the item_id partner parameter
screenview
session

Campaign structure parameters

Google also uses its own naming conventions for campaign structure parameters:
Adjust campaign structure parameter nameGoogle UTM parameter nameExplanation
Network nameutm_sourcecampaign source
Campaign nameutm_campaigncampaign name
Adgroup nameutm_contentcampaign content
Creative nameutm_termcampaign keyword

On this topic