At a glance: Google Marketing Platform - Display & Video 360 (GMP-DV360) is an AppsFlyer self-reporting network (SRN) partner combining advertising and analytics. The GMP-DV360 integration (dv360_int) combines advertising and analytics to enhance customer connections, reveal insights, and improve marketing outcomes.
Important!
See the bulletin about supporting the new Google EU consent policy.
Overview
The GMP-DV360 integration uses the link ID for conversion measurement. You can work directly with GMP-DV360, via an agency, or both, using the following integrations:
- DV360 for advertisers: Complete once—mandatory
- DV360 for agencies: Optional per agency
Note
- The GMP-DV360 integration is designed to replace the Legacy GMP DV360/CM (doubleclick_int) integration, which will be deprecated by the end of Q2, 2024.
- To use the API, contact your GMP-DV360 account manager.
The table below describes GMP integration solutions:
GMP solution | Description | Action required to integration |
---|---|---|
DV360 | Integrate DV360 with AppsFlyer to measure dv360_int attribution | Complete the advertiser integration |
CM360 & DV360 | Buy DV360 traffic via CM360, measured as dv360_int attribution in AppsFlyer. |
Complete the advertiser integration |
CM360 & non-DV360 third-party media source | Buy traffic from third-party media sources and measure mobile app conversions originating from this traffic in CM360. | Measure 3rd party traffic using CM360 |
Data sharing between AppsFlyer and GMP - DV360
Data provided by AppsFlyer: AppsFlyer sends postbacks to GMP-DV360 relating to conversions and in-app events.
Data provided to AppsFlyer: When GMP-DV360 claims a conversion, they provide AppsFlyer with the media source parameters. These parameters populate analytics and raw data reports. The table below shows the mapping parameters for GMP-DV360 and AppsFlyer.
GMP | AppsFlyer |
---|---|
interaction type | attributed_touch_type |
timestamp | attributed_touch_time |
line_item_id | campaign_id |
line_item_name | campaign_name |
creative_id | ad_id |
product_type | af_channel |
external_customer_id | network_account_id |
site_id | af_siteid |
Setting up GMP-DV360 for advertisers
Prerequisites
Before setting up the integration, make sure to:
- Contact the partner and open an account with them.
- Get the GMP-DV360 link ID.
To activate or edit the integration:
-
To activate: In AppsFlyer, from the side menu, select Collaborate> Partner Marketplace.
To edit: In AppsFlyer, from the side menu, select Collaborate > Active Integrations. - Search for the Google Marketing Platform - Display & Video 360 (DV360) and select it.
- Click Set up integration. You’re directed to the integration setup page.
- In the Integration tab, select the app for the integration and turn Activate partner on.
Note: The toggle must be on (activated) for as long as you work with the partner. - Complete the configuration using the relevant tabs, as described below.
Integration tab
When AppsFlyer queries GMP-DV360, they return the parameters listed in their response. These are mapped to AppsFlyer parameters and raw data as detailed in the table that follows.
GMP - legacy parameter | GMP-DV360 parameter | AppsFlyer parameter | URL parameter |
---|---|---|---|
Placement ID | Line Item Name | Campaign name | c |
Placement ID | Line Item ID | Campaign ID | af_c_id |
Site ID | Site ID | Site ID | af_siteid |
Creative ID | Creative ID | Ad ID | af_ad_id |
The Integration tab includes a number of sections, as described below.
Activate partner
To configure the integration, you must first turn on the Activate partner toggle. Learn more about activating and deactivating partner integrations.
General settings
Link ID: Enter the link ID mentioned in the prerequisites.
Non EU Users: Decide whether or not to turn on Non EU users.
Install attribution
Set the different attribution windows to attribute new installs (first launches) of users who viewed or clicked your ad. This means the maximum time from click/view to the install. Only installs within the lookback window may be attributed to Google Marketing Platform - Display & Video 360 (DV360).
- Set the Install click-through lookback window to either 1-23 hours or 1-30 days.
- [Optional] Turn on Install view-through attribution and set the lookback window to either 1-23 hours or 1-30 days.
Re-engagement attribution
Set the different attribution windows to attribute re-engagements of your existing users who viewed or clicked your ad. Note that only re-engagements within the lookback window may be attributed to GMP-DV360.
- Set the Re-engagement click-through lookback window to either 1-23 hours or 1-30 days.
- [Optional] Turn on Re-engagement view-through attribution and set the lookback windows to either 1-23 hours or 1-7 days.
Learn more about re-engagement rules and windows.
Re-engagement window
Set the time window during which in-app events are primarily attributed to the re-engagement conversion. Learn more.
- Set the Re-engagement window to either 1-23 hours, 1-90 days, or Lifetime.
Ignore active users for retargeting
Set a window timeframe to ignore re-engagements and re-attributions of users who launched your app. This means their activity during the window timeframe isn't recorded in AppsFlyer.
Note
Re-engagement and re-attribution conversions of users who were dormant in the set timeframe are recorded.
- Turn on Ignore active users for retargeting.
- Set the Inactivity window.
In-app event postbacks
Configure mapping of in-app events with GMP-DV360 events sent via postbacks:
- Turn on In-app event postbacks.
- Click Add event to add an SDK or server-to-server event to the list. The following table describes the fields to complete:
Parameter name Description AppsFlyer event The name of the event, as received by AppsFlyer either from the SDK integrated into your app or from server-to-server events.
Tip: Don't see the event you are looking for?- Make sure to activate the event on a device with a non-organic installation, and recheck.
- Type it in AppsFlyer event, then click Create custom. Read more about custom event mapping.
mapped to partner event The unique name or ID of each event, as defined on the partner's side. Possible mapping configurations are:
- Drop-down box: Select the most suitable pre-defined AppsFlyer event.
- CUSTOM: When selecting this option, AppsFlyer sends the event as it appears in the AppsFlyer event field.
Note:
- It's best practice to select a standard event from the list. However, for multiple CUSTOM events, it's best to specify them uniquely, such as CUSTOM_1 and CUSTOM_2. This will help distinguish between events on DV360/CM360.
- AppsFlyer events (such as
af_purchase
, etc.) are always sent withu
variables, for example,u24=
. This helps you identify them on CM360, even when sent as custom. - CM360 allows a maximum of 10 events in total, which can be custom or standard events.
for users from Select the sending option for the event:
- This partner only (default): Send postbacks only when this event is attributed to GMP-DV360.
- All media sources including organic: Send postbacks for events attributed to any partner, as well as organic events.
including - No values & no revenue (default): Send only the event itself without any event values.
- Values & no revenue: Send all the parameters excluding the revenue value.
- Values & revenue: Send all the event parameters, including the revenue value (if exists in the event).
- [Optional] Click the Add conditionicon to set conditions for an event.
- Click Save integration.
- [Optional] After saving the integration, while remaining on the configuration page, you can integrate more of your apps with GMP-DV360:
- From the top-left corner, under the partner name, click the app name to open the list of apps.
- Select a different app from the drop-down list.
- Repeat the integration steps for the selected app.
Note
For iOS apps only: Your control over data shared with the partner via postbacks and reports depends on the Advanced Privacy (for iOS 14.5+ and later) toggle state.
U parameter mapping
AppsFlyer supports sending additional parameters (u parameters), limited up to u26. The U parameters are pre-mapped and fixed on AppsFlyer's end. Take the following into consideration:
- Since these parameters are pre-mapped, no additional custom U parameters can be configured.
- If data is missing for a specific U parameter, AppsFlyer won't send it. For example, when the carrier data is missing, AppsFlyer doesn't send U5.
U parameter | Name | Example value |
---|---|---|
u1= |
af device id |
1540995037437-2811776739500410055 |
u2= |
customer user id |
eaf8a5f2.1836.4686 |
u3= |
Android: |
9d9d03ab-f211-4e17-994e-d0afdf23ac01 |
u4= |
wifi |
true |
u5= |
carrier |
Jio%204G |
u6= |
country code |
IN |
u7= |
Region |
HR |
u8= |
city |
Gurgaon |
u9= |
device type |
motorola::Moto G (4) |
u10= |
os version |
7 |
u11= |
sdk version |
v4.8.18 |
u12= |
app version |
3.31.1 |
u13= |
install timestamp |
1540995041 |
u14= |
click time |
1546441586 |
u15= |
impression time |
1546441586 |
u16= |
campaign name* |
Appinstall_campaign |
u17= |
campaign id |
12345ABC |
u18= |
adset name* |
Appinstall_adset |
u19= |
adset id |
12345ABC |
u20= |
ad name* |
Appinstall_ad |
u21= |
ad id |
1234567ABCDE |
u22= |
site id |
site_id_123456 |
u23= |
event time |
2019-01-04 12:56:35.707 |
u24= |
event name |
af_purchase |
u25= |
event value |
{"af_price":459,"af_content_id":"77147","af_revenue":4.59,"af_currency":"EUR"} |
u26= |
currency |
EUR |
* If AppsFlyer doesn't receive this parameter name in the response from GMP-DV360, it populates the field with the corresponding ID. For example, the Adset name will show the Adset ID, which is 12345ABC
.
Attribution link tab
It is possible to use AppsFlyer attribution links with DV360 for impressions and click recording only. These links are NOT used for attribution, and any additional information contained within them is not parsed or used for any purpose.
If you want to be able to measure the number of clicks from DV360 on AppsFlyer, you should add an AppsFlyer attribution URL on your DV360 dashboard. When doing so, make sure the campaign name in the attribution URL is identical with the Placement ID on GMP (if possible) so that AppsFlyer can retrieve and append the click data for the correct campaigns.
Important!
Using attribution links for DV360 is not mandatory.
If you want to count clicks in AppsFlyer, use this link:
https://app.appsflyer.com/ADD-APP-ID?pid=dv360_int&af_siteid=${UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}
If you want to count impressions in AppsFlyer use this link:
https://impression.appsflyer.com/ADD-APP-ID?pid=dv360_int&af_siteid=%24{UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}
Cost tab (for cost, clicks, and impressions)
Cost data isn't supported for this integration.
Ad revenue tab
Ad revenue isn't supported for this integration.
Permissions tab
Set permissions to grant Google Marketing Platform - Display & Video 360 (DV360).
Setting up GMP-DV360 for agencies
Agencies are able to run campaigns with GMP-DV360 on your behalf.
Agency setup
Procedure performed by | Procedure |
---|---|
Advertiser |
|
Agency |
|
GMP-DV360 discrepancies
See possible reasons for discrepancies and how to minimize them:
Cause | Description | AppsFlyer tip |
---|---|---|
View-through attribution window |
View-through in the GMP-DV360 attribution window is 14 days, while the AppsFlyer default window is 1 day. |
Set the view-through window in AppsFlyer to match the view-through set in the GMP-DV360 setup window. |
Incorrect mapping |
Mapping between AppsFlyer and GMP-DV360 isn't correct |
|