Skip to content

Google Marketing Platform

image

Overview

Branch links can be used together with Google Marketing Platform app conversion ads, allowing you to track ad-driven app conversion (installs and in-app events) on the Branch dashboard.

Google Marketing Platform

The Google Marketing Platform is the single new product name for the following products: DoubleClick Bid Manager (DBM), DoubleClick Campaign Manager (DCM) and DoubleClick Search (DS).

Please make sure to use Google Marketing Platform in your Branch dashboard and not Doubleclick which is the legacy integration and does not include server-side attribution responses.

By connecting your Google Marketing Platform and Branch accounts, the following is enabled:

  • App conversion data collected by the Branch SDK sent to Google Marketing Platform for attribution.
  • Read-only access to app conversion data (not cost/click/impression data) from Google Marketing Platform Ads in your Branch account.

Prerequisites

Prerequisites

  • To track conversions from Google Marketing Platform Ads you should integrate the Branch SDK into your app.
  • To use Branch links in Google Marketing Platform Ads ensure you have:
    • URI schemes configured on iOS
    • URI schemes configured on Android
    • iOS App Store ID set
    • Android Package Name set
  • Ads is a premium product priced on Monthly Active Users. Sign up for the Ads product to enable this functionality.

Configure Branch as App Analytics Partner in Google Marketing Platform

Required Before Enabling Integration in Branch

After your Google representative has confirmed whitelisting, use the guide provided by their team to configure Branch as an App Analytics Partner and generate a link ID for the iOS and Android versions of your app.

Enable Google Marketing Platform in Branch

Completing this section will result in Branch sending app conversion to Google in order to attribute them back to Google Marketing Platform campaigns.

  1. Navigate to the Partner Management tab and search for Google Marketing Platform.

  2. Provide the Link IDs for your Android/iOS apps respectively. image

  3. Click Save and Enable.

  4. Finally, to create a Google Marketing Platform Ads link click the Create Google Marketing Platform Link button in the top right hand corner.

Creating a Google Marketing Platform Ads Campaign

Please follow Google's documentation on how to set up a Campaign.

Adding the Agency Prefix to Campaign Name

Only agencies managing advertising campaigns on behalf of a client must prepend their Agency ID to the campaign name when creating advertising campaigns for Self-Attributing Networks (SANs).

Agency ID Required

Failure to prepend the campaign name with the Agency ID will result in any subsequent conversion not being properly attributed to the responsible agency.

Finding Your Agency ID

You can find your Agency ID under Account Settings in the Agency view.

Creating Your Agency Prefix

Your agency prefix must adhere to the following format:

`agency_{YOUR AGENCY ID HERE}_`

Example Campaign with Agency Prefix

agency_1234567890_My_SAN_Ad_Campaign

Data Mapping between Google Marketing Platform & Branch

Branch maps the following data fields from the Google Marketing Platform to Branch.

Google Marketing Platform Branch Data Possible Values
n/a ~advertising_partner_name “Google Marketing Platform”
product_type ~channel This field reports the product that is responsible for the conversions, either “DBM” or “DCM”.
creative_id ~creative_id The numeric ID of the creative ad unit that produced the ad event. This value is guaranteed unique. When product is DBM, this field represents the DBM Creative ID. When product is DCM, this field represents the DCM Creative ID.
placement_id ~placement The ID of the placement tag that calls an ad server for ad content when users visit a site. DCM serves ads when users visit a site with DCM placement tags. DCM generates a unique tag for each placement in an ad campaign. This value is only provided when product is DCM.
line_item_id ~ad_id Line items in DBM can be used for targeting, bidding and assigning creatives. This is the ID of the line item that produced the ad event. This value is guaranteed unique within the DBM universe. This value is only provided when product is DBM
line_item_name ~ad_name Name of the line items in DBM that produced the ad event. This value is only provided when product is DBM.

Forwarding Events to Google Marketing Platform

Once you begin tracking events through the Branch SDK, we will start sending them to the Google Marketing Platform.

Branch will forward in-app events to the Google Marketing Platform for campaign optimization. In addition, Branch will receive attribution data for rich analysis in the Branch dashboard.

Branch Event Name Google Marketing Platform Conversion Type
INSTALL FIRST_OPEN
PURCHASE ECOMMERCE_PURCHASE / IN_APP_PURCHASE
INITIATE_PURCHASE CUSTOM
ADD_TO_CART ADD_TO_CART
VIEW_ITEM VIEW_ITEM
ADD_PAYMENT_INFO CUSTOM
COMPLETE_REGISTRATION CUSTOM
SEARCH VIEW_SEARCH_RESULTS
ACHIEVE_LEVEL CUSTOM
OPEN, REINSTALL SESSION_START
COMPLETE_TUTORIAL CUSTOM
ADD_TO_WISHLIST CUSTOM
UNLOCK_ACHIEVEMENT CUSTOM
SHARE CUSTOM
SPEND_CREDITS CUSTOM
RATE CUSTOM
UPDATE CUSTOM
RESERVE CUSTOM
LOGIN CUSTOM
INVITE CUSTOM

In order to track these events, please refer to the v2 Event document for further information.