Google AdWords Integration Configuration - New API

Introduction

There are two different Google AdWords/AppsFlyer configurations. 

  • Advertisers who opened an AppsFlyer account prior to 17 May 2017 should refer to the iOS documentation here and the Android documentation here
  • Advertisers who opened an AppsFlyer account after 17 May 2017 and have never configured Google AdWords on AppsFlyer should follow the guidelines below:

 Note

As a prerequisite for the integration with Google AdWords, the app must collect IDFA / GAID.  
For further information please refer to the SDK Integrations Guides for either iOS or Android.

The new Google AdWords UI allows you to configure only a new UAC campaign. To configure all other specific campaign types, switch back to the old UI on Google Adwords' dashboard. For details, click here.

Setting Up and Measuring a Campaign

To set up a Google AdWords campaign and measure it with AppsFlyer, follow the below steps:

To start measuring Google AdWords app install campaigns with AppsFlyer, insert your Google AdWords Link ID in AppsFlyer's Dashboard (see example below).

1.  Generate your Link ID in your Google AdWords dashboard, click here for more info.

2.  Setup your campaign with Google AdWords. 

3.  Make sure you have the latest AppsFlyer SDK integrated. Minimum, AppsFlyer’s iOS SDK 2.5.1.9+ or Android SDK v1.3.12+ is required for measuring Google AdWords campaigns.

Note: Link ID is per app and per Operating System (OS).

4.  Configure your Link ID in AppsFlyer's Dashboard:

4.1 Click Integrated Partners on the left side of the screen

 

 4.2 In the Integrated Partners page, select Google AdWords as the media source. You can do this by  either scrolling down the page to Google AdWords or entering Google AdWords in the search box. 

4.3 Copy your Link ID from the Google AdWords dashboard and paste it into the AppsFlyer dashboard.

4.4 Click Save & Close

You may also set your desired attribution window at this time. The default value here is 30 days, same as in your Google AdWords console.

5. In-App Events Configuration (optional)

In addition to the Link ID setup, you can enable the in-app events measured by AppsFlyer to be sent to Google AdWords. This allows you to better target and optimize your campaigns.

5.1 Click the In App Events tab in your Google AdWords Configuration:

 5.2 Select sending All-in app events.

5.3 The first time you set the drop down to send All in-app events, all af_xxx in-app events are mapped automatically to Google AdWords events. If you would like to add custom events, click Click to add in app event mapping.

Notice that non af_xxx in-app events are mapped as CUSTOM, and are sent to Google AdWords with the event name shown on the AppsFlyer SDK Event side (e.g url_click in the above example, is mapped to the Google AdWords Events as “url_click”).

5.4 Click Save & Close.  You must follow the step below to complete the process.

 Important

Import the first-open and in-app actions to Google AdWords to begin accruing conversions in Google AdWords and in your AppsFlyer dashboard.

For more details, click here.

Enabling Agencies Tracking of Adwords

While agencies can use their own accounts to provide Adwords traffic to advertisers, if the advertiser has its own Adwords account, the agency MUST use the advertiser's Google Link ID.  For details, click here

Adwords Parameter Mapping

The table below is the parameter mapping between Google AdWords and AppsFlyer.

Example: If an advertiser is running a UAC campaign on Google AdWords, the RAW data report on AppsFlyer reflects the Channel, Campaign Name, Campaign ID and in some cases, also the Site ID.

 Notes

  • Advertisers cannot add personalized parameters to any Google AdWords campaigns.
  • Advertisers are not able to see the click count and impressions on the AppsFlyer dashboard.

Campaign Type: UAC

Network Type

Search Display Video
Channel (af_channel) UAC_Search UAC_Dispaly UAC Video
Campaign (c) Yes Yes Yes

Campaign ID (af_c_id)

Yes Yes Yes
Adset (af_adset) N/A N/A N/A
Adset ID (af_adset_id) N/A N/A N/A
Ad (af_ad) N/A N/A N/A
Ad ID (af_ad_id) N/A N/A N/A
Ad Type (af_ad_type) Yes Yes Yes
Site ID (af_siteid) GoogleSearch/
Search Partners
N/A YouTubeVideos/
YouTubeSearch/
VideoPartners
Keywords N/A N/A N/A

Campaign Type:  Search

Network Type

Google Search Search Partners mGDN
Channel (af_channel) Search Search mGDN
Campaign (c) Yes Yes Yes

Campaign ID (af_c_id)

Yes Yes Yes
Adset (af_adset) No (is auto-populated with Adset ID) No (is auto-populated with Adset ID) No (is auto-populated with Adset ID)
Adset ID (af_adset_id) Yes Yes Yes
Ad (af_ad) No (is auto-populated with Ad ID) No (is auto-populated with Ad ID) No (is auto-populated with Ad ID)
Ad ID (af_ad_id) Yes Yes Yes
Ad Type (af_ad_type) Yes Yes Yes
Site ID (af_siteid) GoogleSearch SearchPartners Yes (Publisher App ID)
Keywords Yes Yes N/A

Campaign Type:  Video

Network Type

AdMob YouTubeVideos YouTubeSearch VideoPartners
Channel (af_channel) Admob YouTube YouTube YouTube
Campaign (c) Yes Yes Yes Yes

Campaign ID (af_c_id)

Yes Yes Yes Yes
Adset (af_adset) No (is auto-populated with Adset ID) No (is auto-populated with Adset ID) No (is auto-populated with Adset ID) No (is auto-populated with Adset ID)
Adset ID (af_adset_id) Yes Yes Yes Yes
Ad (af_ad) No (is auto-populated with Ad ID) No (is auto-populated with Ad ID) No (is auto-populated with Ad ID) No (is auto-populated with Ad ID)
Ad ID (af_ad_id) Yes Yes Yes Yes
Ad Type (af_ad_type) Yes Yes Yes Yes
Site ID (af_siteid) Yes
(Publisher App ID)
YouTubeVideos YouTubeSearch VideoPartners
Keywords N/A N/A N/A N/A

 

 

Was this article helpful?
0 out of 1 found this helpful