|Partner Type||Self-attributing Ad Network|
|Creatives||Supported (DCM creative ID)|
|Publisher||Supported (DCM site ID)|
|Click Tag||No (Self-attributing)|
|Receiving All Installs||Recommended (Self-attributing)|
|Receiving All Events||Recommended (Self-attributing)|
What is Google Marketing Platform?
Google Marketing Platform is a suite of marketing tools for site and app marketers. It includes the demand-side platform Display & Video 360 (formerly DoubleClick Bid Manager) and the ad server Campaign Manager (formerly Double Click Campaign Manager), for which Singular can report on app install marketing performance.
How does Singular track attribution with Google Marketing Platform?
When you buy media through DV360, Singular tracks mobile attributions with Google Marketing Platform through a self-attributing integration, meaning Singular uses data it receives from GMP.
When you buy media through a different media source, but use Google Campaign Manager as your ad server, Singular tracks attributions through a tracking link that you create for that media source.
Whether you use DV360 or another DSP, the integration is based on reporting "floodlight activities" to GMP. In GMP, "floodlight activities" are conversion and conversion-related events, such as (in the context of mobile apps) installs, sessions, and in-app user events. Singular reports floodlight activities to GMP's DDM API using postbacks, so that GMP can report on these activities and use them to optimize performance.
How do I set up an integration with GMP?
1. Integrate The Singular SDK
Integrate a Singular SDK in your app (see the Singular iOS SDK and Singular Android SDK guides). Note that Singular also offers a server-to-server (S2S) integration. If you need to use it, reach out to your Singular customer success manager for further details.
2. Create Install Floodlight
Create your floodlight activity to represent the "Install" activity for your app and enable third-party in-app conversion tracking using Google's instructions. Be sure to take note of the src, type, cat, and token values you generate: the combination of these values is unique to the install floodlight.
You can configure floodlight activities in Google Marketing Platform by navigating to your advertiser page and then to the "Floodlight Groups" page in the menu. Create a new floodlight group to represent your app site, and then create individual "Floodlight Activities" under the "Floodlight Activity" tab like below.
3. (Optional) Create Floodlights for Events
Create additional floodlights for other events you would like to be reported to GMP. Each floodlight should have its own src, type, cat, and token values. If you want to pass additional variables with an event, see Google's guide to custom floodlight variables. Singular can pass any value in a supported postback macro, to be mapped to a custom floodlight variable.
Custom floodlight variables can be defined within the "Floodlight Activity" -> "Basic Details" -> "Custom Floodlight Variables"
Create/add any custom variables according to what can be passed via a Singular postback macro, and name them so they can be easily identified to configure in Singular in the next step.
4. Configure Singular to Report Floodlight Activities
Note: As of early 2020, this partner integration is not available for self-configuration, as we are preparing for a new Google Marketing Platform integration technology that is still being rolled out by Google.
To set up this integration, contact your Customer Success Manager and give them your floodlight configuration, including the event name (e.g., install, session, myevent1, myevent2, etc.), and the corresponding src, type, cat, and token values.
If you have configured custom floodlight variables, include which values should be mapped to the variables. For example, to map a revenue event called "My Revenue", provide the src, type, cat, and token, and request that the revenue amount be mapped to u5 and the three-letter currency code be mapped to u6.
Our team will configure the necessary postbacks for you, and they will appear under the "DoubleClick" custom partner configuration.
5. Generate Tracking Links (for non-DV360 media)
Note: This step is only relevant if you're using Campaign Manager with a DSP other than DV360.
For non-DV360 media tracked through Campaign Manager, you need to create tracking links to let Singular track the attribution. Create a "Custom Source" link in Singular for the desired media source (see the Singular Links FAQ for details).
If you're working with a media source with mobile inventory, the publisher should append the iOS advertising ID and Google advertising ID to the Singular tracking link when it is served, via the idfa and aifa query parameters.
How does GMP attribution appear in Singular reports?
Attributions to DV360 media appear in reports under the source "DoubleClick":
Singular reports DV360 click-through and view-through installs with the ad_id, site_id, and creative_id returned by GMP. These are mapped as follows:
|GMP Field||Singular Dimension|
|creative_id||Tracker Creative ID|
Attributions to non-DV360 sources are reported according to the source name of the created tracking link.