Google Universal Analytics

Google is a multinational technology company focusing on online advertising, search engine technology, cloud computing, and computer software. Google Universal Analytics (UA) is a web analytics service that tracks and reports website traffic. Using this destination, you can take advantage of the Measurement Protocol by sending data via server-side. This version is related to the previous generation of Google Analytics. See Google Analytics 4 destination for the newest and recommended version.

Google Universal Analytics will be deprecated on July 1, 2023, meaning it will stop processing data. Analytics 360 properties will stop working on October 1, 2023.

Key features

The Google Universal Analytics destination provides the following key features:

  • Events structure: our Events reference model covers Google's hit types, meaning that your data is properly bridged to the expected fields in an optimized way.

  • Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

  • Smart mapping: data mapping can be readjusted using your datalayer defined fields.

  • Refined data: you can freely push additional information based on your specific needs (E.g. adding custom events and custom properties).

  • Support for multi-item data: information included in the item array is dispatched to UA.

Destination setup

Configuration

SettingsDescription

Tracking ID

Required

The tracking identifier is a string like "UA-XXXXXX-Y". It must be included in your tracking code to tell Analytics which account and property to send data to.

Custom Event Properties

Map your custom event properties by setting their field names in Event property name and adding the field name holding the value in Commanders Act event property or static value. E.g. if you inputsizein the Event property name anditems.0.product.size [1] in Commanders Act event property or static value, you will have a custom event property in GA4 calledsizewith a value based on the content of the fielditems.0.product.size. You also have the option to set a static string/numeric value in Commanders Act event property or static value. In the column Commanders Act event property position you should keep the value Default as it better fits most scenarios. E.g. this can be used to set Custom Dimensions and Metrics and/or Content Groups. In case you select either In "Item List" (E.g. {items.X}) or In "Item List" Product (E.g. {items.X.product}) this destination will look for the input event property starting from the items or product level respectively and add Product Custom Dimensions and/or Product Custom Metrics depending on your input Event property name. If you select In "Item Impression List" (E.g. {items_impression.X}), you will add Product Impression Custom Dimensions and/or Product Impression Custom Metrics still depending on your input Event property name.

Client Id Cookie Name

Cookie name holding the Google Analytics "Client Id" that uniquely identifies a user instance of a web client. Default value: "_ga".

The "Client Id" is the right most string in the cookie, including a single dot. E.g. see the following blue highlighted string "GA1.1.XXXXXXXXXX.XXXXXXXXXX".

[1] Using "dots" (".") you can navigate deeper to the specific field you want to get the value of. See Events reference for more details on the standard field names by event. You can also freely set custom fields: there are no boundaries.

Quick reference

As recommended by Google, Enhanced Ecommerce hits are used in place of Ecommerce hits. See more details on UA "Hit Types" following this LINK.

Commanders Act EventsUA Hit Types

add_payment_info

add_shipping_info

begin_checkout

page_view

purchase

pageview [1]

screenview [1]

add_to_cart

add_to_wishlist

generate_lead

login

refund

remove_from_cart

search

select_content

select_item

sign_up

view_cart

view_item

view_item_list

[Custom Event]

event

[Custom Event]

social [2]

[1] This is either pageview or screenview , depending if the "Smart Mapping" field App Name (an) is set with an empty value or a non-empty one. [2] You can specify a custom social event by setting the "Smart Mapping" field Social Event .

Field mappings

Most properties can be remapped using our "Smart Mapping" feature.

Commanders Act PropertiesGoogle Properties

Tracking ID

tid

partners.ga.client_id

Client Id Cookie Name

user.tcId

cid [1]

user.id

uid

context.device.ip

uip [2]

partners.ga.ad_id

gclid

context.page.url

dl

context.page.title

dt

context.page.referrer

dr

context.page.url

dh [3]

context.page.url

dp [3]

id

ti

value

tr

shipping_amount

ts

tax_amount

tt

coupon

tcc

partners.ga.affiliation

ta

currency

cu

partners.ga.product_action [Default Value]

pa [4]

partners.ga.event_category

ec [5]

partners.ga.event_action

event_name

ea [6]

partners.ga.event_label

search_term

item_id

method

el [7]

items.X.id

pr(X+1)id

items.X.product.name

pr(X+1)nm

items.X.product.category_1 / items.X.product.category_2 / items.X.product.category_3 / items.X.product.category_4 / items.X.product.category_5

pr(X+1)ca

items.X.product.brand

pr(X+1)br

items.X.variant

pr(X+1)va

items.X.list_position

pr(X+1)ps

items.X.product.price

pr(X+1)pr

items.X.quantity

pr(X+1)qt

items.X.coupon

pr(X+1)cc

items_impression.X.0.list_name

il(X+1)nm

items_impression.X.Y.id

il(X+1)pi(Y+1)id

items_impression.X.Y.name

il(X+1)pi(Y+1)nm

items_impression.X.Y.brand

il(X+1)pi(Y+1)br

items_impression.X.Y.category_1

il(X+1)pi(Y+1)ca

items_impression.X.Y.variant

il(X+1)pi(Y+1)va

items_impression.X.Y.list_position

il(X+1)pi(Y+1)ps

items_impression.X.Y.price

il(X+1)pi(Y+1)pr

items_promotion.X.id

promo(X+1)id

items_promotion.X.name

promo(X+1)nm

items_promotion.X.creative

promo(X+1)cr

items_promotion.X.position

promo(X+1)ps

items_promotion.X.action

promoa

partners.ga.campaign_name

cn

partners.ga.campaign_source

cs

partners.ga.campaign_medium

cm

partners.ga.campaign_keyword

ck

partners.ga.campaign_content

cc

partners.ga.campaign_id

ci

partners.ga.queue_time

qt

context.app.name

an

context.app.namespace

aid

context.app.namespace

aiid

context.app.version

av

context.page.title

cd

(partners.ga.event_npa)

npa [8]

(partners.ga.non_iteration)

ni [9]

partners.ga.checkout_step

cos

partners.ga.checkout_step_option

col

partners.ga.social_name

sn

partners.ga.social_action

sa

partners.ga.social_action_target

st

Custom Event Properties

[Custom Property Name] [10]

[1] partners.ga.client_id has priority over Client Id Cookie Name and user.tcId . [2] Always anonymized just as though aip (anonymize IP) is used. [3] Retrieved by parsing the provided "Smart Mapping" field Document Location (dl) . [4] If items is not set, then this property won't be present. If partners.ga.product_action is not set, depending on the incoming event, the following values are used as default: detail (page_view event or if your event is not one of the following being listed), purchase (purchase event), click (search, add_to_wishlist, login, select_content, select_item, sign_up, view_cart, view_item and view_item_list events), refund (refund event), checkout (begin_checkout, add_shipping_info and add_payment_info events), add (add_to_cart event), remove (remove_from_cart event). [5] If partners.ga.event_category is not set, since this property is required for "event" hit types, this gets the default value: UX . [6] If partners.ga.event_action is not set, then your event name is used. [7] If partners.ga.event_label is not set, depending on the incoming event, the following fields are used as default: search_term (search event), item_id (select_content event) and method (sign_up and login events). [8] If partners.ga.event_npa is set with one of the following values: 1 (string or integer) or true (boolean), then npa is set with 1 . [9] If partners.ga.non_iteration is set with one of the following values: 1 (string or integer) or true (boolean), then npa is set with 1 . [10] See Custom Event Properties in Configuration for more details on how you can bridge custom properties to UA.

Last updated