Google Adwords Integration

Last Updated: May 22, 2017 10:39AM PDT

This is article refers to the new integration announced on May 17th, 2017.  

If you are an Apsalar customer starting on or after May 17th, 2017, this integration is available for configuration.  

If you are an Apsalar customer prior to May 17th, 2017, and are using the legacy Google AdWords integration with conversion IDs and labels, your integration will be part of an auto-migration to ensure a seamless transition to the new system.  The legacy integrations' documentation can still be accessed here. Google and/or your Apsalar account manager will be in touch with you about the migration timeline of your account.


The Google AdWords Platform

The Google Adwords platform is a powerful platform that you can use to promote your mobile app across all the Google networks. With a few steps, you can enable Apsalar to track the performance of different types of app promotion campaigns, across these networks.

The below tables summarize these different Google Adwords networks, options for how you want to promote your app in these networks, and how to enable Apsalar to track them. To review how to enable Apsalar to track these campaigns for you, skip down to the set-up.

Google Networks
Network Description
Google Search These are text ads appearing on Google Search, the Google Search App, and Google Play.
Google Display These are image ads in a mobile applications and mobile web browsers that can link to your mobile website, mobile app, or app store. 
Google Adwords for Video (Youtube) These are video or text ads appearing in the Google YouTube iOS or Android apps.


Google Campaign Types
Type Description Apsalar Tracking
Universal App Campaign Universal App Campaigns is a one-stop-shop to promote your app on all available networks.  These ads are auto-generated based on the creative text you enter. Available for both iOS and Android apps. Installs
Mobile App Installs Google Mobile App Install campaigns increase app downloads for your app. These campaigns are available for Google Search, Display, Adwords for Video. Available for both iOS and Android apps. Installs
Mobile App Engagement Google Mobile App Engagement re-engages your existing users that deep-link to specific pages in your app. These campaigns are available for Google Search and Display only. Available for both iOS and Android apps. Installs, Re-engagement

How Attribution Tracking With Google Works

Tracking your Google AdWords campaigns in Apsalar is performed via a self-attributing server-to-server integration. This integration allows Apsalar is able to track all installs and re-engagements driven from any of your AdWords campaigns. The integration utilizes a Link ID which is generated in AdWords and unique to each app. Once your Link ID has been configured in Apsalar, Apsalar will start sending all installs, sessions, and configured in-app conversion events to Google. Using the attributed click information returned from Google, Apsalar is able to perform last-click attribution and report using the same granular campaign information as seen in your Google AdWords dashboard.

To continue on to setting up your Google AdWords integration in Apsalar, continue down to Integration Steps below.

Integration Steps

1. Integrate The Apsalar SDK

In order for Google AdWords attributions to be tracked, the Apsalar SDK must be present. If your application supports deeplinks, it is also required that deeplink URI support be implemented to ensure all Google AdWords campaigns can be tracked in Apsalar. Review our iOS and Android SDK guides to ensure sessions and deeplinks are handled correctly.  If you are utilizing the an S2S integration with the Apsalar Event API, please reach out to your Apsalar account manager for further details.

2. Get Your App’s Link ID

The Link ID is a value that can be generated and found in your Google AdWords account.  Follow Google's instructions to generate and share your app's Link ID.

3. Set-up the Integration in Apsalar

The integration with Apsalar utilizes Apsalar Conversion Events to automatically enable in-app events to be used in your partner integrations. If you don't have Conversion Events configured yet, but would like to send in-app events to Google, follow the prompt labelled "Click here to set up Conversion Events to use the Integration".  This will direct you to your applications event management page where you can toggle any event you'd like, to be a Conversion Event.

Once you have configured Apsalar Conversion Events, create an integration for Google AdWords via the Apsalar Partner Integrations page.

Add the application you want to track with Google AdWords and enter in the Google Link ID from step 2.

Verify that the in-app events included in the integration are correct. If you see an event missing from the list, be sure to mark them as an Apsalar Conversion Event.    Once you have verified your events, click “Save”.

You may now configure your Google AdWords conversions and campaigns.

4. Import Conversions and Configure your Google AdWords Campaigns

To begin tracking conversions, you first need to import the relevant conversion events you opted to send to Google AdWords in step 3. For instructions on importing conversion events, please see Google's instructions.

Next you may now configure and start your Google AdWords campaigns.  Follow Google's instructions to learn more about your options, and how to configure each one in AdWords.

5. Apsalar Reporting for Google AdWords

Once an attribution is tracked, your AdWords campaigns appear in your Traffic and Cohort reports with the same values visible in AdWords.  The below table describes how your AdWords campaign values maps to your Apsalar reporting dimensions:
Dimension Notes
Campaign Source These will either be "Google AdWords for Video", "Google Search", or "Google Display".  The suffix "UAC" is applied if the attribution was from a UAC campaign
Campaign This will be a concatenation of your Google AdWords campaign ID, campaign name, and AdWords Customer ID
Campaign Group This will be the AdWords Group ID (when available)
Publisher This will contain the Google Network Type, along with:
If Google Search, this will contain the match type and keyword
If Google AdWords for Video, this will contain the Video ID
If Google Display (non-UAC), this will contain the placement
Creative This will be the creative ID for non-UAC campaigns

Below is an sample of AdWords attributions in the Traffic Report:
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found