At a glance: Use Google Ads web campaigns to promote your apps on PC and console platforms and enable attribution. AppsFlyer supports Google web-based campaigns using cross-platform landing pages or direct attribution links.
Overview
This article contains information and steps on how to set up and use Google Ads Web for PC and console apps with AppsFlyer. This includes:
- Activate the partner integration in AppsFlyer.
- Set up Google Ads Web in AppsFlyer.
- Set up campaigns in Google Ads for PC and console apps.
Prerequisites
Before activating the Google Ads Web integration, make sure you have:
- A PC or console app
- An AppsFlyer account
- A Google access token with the required OAuth scope. You can verify the scopes associated with your access token in the Google Developer Console.
- AppsFlyer users with appropriate roles/permissions and access to the relevant apps
Activate partner in AppsFlyer
To activate the partner integration:
- In AppsFlyer, from the side menu, go to Collaborate > Partner Marketplace.
- Search for Google Ads Web and select it.
- Click Set up integration. You’re directed to the Active Integrations setup page.
- In the Integration tab, turn on Activate partner.
Note: The toggle must stay on (activated) for as long as you work with the partner. - Complete the configuration using the relevant tabs, as described in the next section.
Set up Google Ads Web in AppsFlyer
In this part of the setup, you can also set up postbacks to Google Ads. The Google Ads Web (googleads_int) integration uses an API tool provided by Google Ads for advertisers to send data from their PC and console apps directly to Google's servers. Such data may include user actions, such as purchases, registrations, and other types of conversions performed on non-mobile platforms (websites or applications). The data is then used by Google Ads to optimize ad targeting, measure ad performance, and build custom audiences for retargeting.
The integration with Google Ads Web only supports sending postbacks for installs and in-app events.
Integration tab
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.
General settings
If you're setting an iOS app integration: Turn off Advanced Privacy.
-
First open conversion ID: Enter the ID of the
First open
conversion action you set in Google Ads. To find the ID:- Go to the Google Ads platform and open the Details tab of the First open conversion action page.
- Copy the value of the
ctid=*
query parameter from the page URL. For example, ifctid=123456789
, insert123456789
to the First open conversion action ID box.
- Enter your Customer ID. You can retrieve it from your Google Ads Manager:
- Sign in to your Google Ads account.
- In the top right corner, click the Google account icon and scroll down to where the Customer ID is displayed.
- If you have multiple Google Ads accounts running campaigns for your app, you must use the Customer ID from a manager (MCC) for cross-account conversion tracking. See Google instructions on configuring an MCC account.
- Click Sign in with Google. Select your Google Ads account and click Allow.
Default postbacks
Postbacks for installs are automatically sent only to Google Ads Web.
In-app event postbacks
Configure mapping of in-app event postbacks sent to Google Ads Web. These events can be viewed in the Google Ads Manager:
- 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. - Click Add item, enter the event name, and click .
mapped to partner event The Conversion Action ID of each event, as is defined on the partner's side. - In Google Ads Conversion Goals page, click the conversion action you created.
- In the Conversion Action Details page, copy the Conversion Action ID from the URL parameter
ctId=
. - Go back to AppsFlyer and paste it. For example if
ctid=123456789
, paste123456789
.
for users from This partner only: In-app event postbacks are sent only for events attributed to this partner—meaning, the user who performed it came from this partner. including Values and revenue: All event parameters, including the revenue value (if exists in the event), are sent in the postback. - [Optional] Click the Add conditionicon to set conditions for an event.
- Set the In-app event postback window, if required (read more about in-app event postback window configuration).
- Click Save integration.
- [Optional] After saving the integration, while remaining on the configuration page, you can integrate more of your apps with the partner:
- 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.
Attribution link tab
Generating an attribution link in the AppsFlyer UI isn't currently available. However, you can either use a cross-platform landing page with SmartScript or create a direct attribution link for your app (see table below).
Option | Actions | Who's involved |
---|---|---|
Cross-platform landing page |
Recommended: For when your campaign promotes an app that's also available on multiple platforms, like Epic and Steam. Learn about cross-platform landing pages Learn how to set up a cross-platform landing page
|
Marketer (may require developer assistance) |
Direct attribution link |
If you don't use a cross-platform landing page, because you only have 1 app on 1 platform, you can create direct attribution links to place behind ads. Learn how to create direct attribution links
Template to use for most platforms (Epic, Steam, Xbox, PlayStation, etc.):
Sample link leading to Steam: Template to use for Google PC and Mac apps ONLY:
Sample link leading to Google PC: |
Marketer |
Set up campaigns in Google Ads Web for PC and console apps
When you set up a new campaign, you can either direct users to a:
- Cross-platform landing page: Recommended for when your campaign promotes an app that's also available on multiple platforms, like Epic and Steam.
- Single store: This uses a direct attribution link and should be used when you only have 1 app on 1 platform.
The instructions for setting up campaigns to redirect users to either of these options are detailed in the sections that follow.
Note: During campaign setup, you may want to configure your own conversion actions and goals. Instructions on how to do this are also detailed in the sections that follow.
Campaigns that redirect to a cross-platform landing page
To set up a campaign that redirects users to a cross-platform landing page:
- Set up a cross-platform landing page as described in the attribution link section.
- Log in to Google Ads and create a new campaign.
- Select the campaign objective.
- All objectives are applicable, except "App promotion" (which can only be used for mobile app campaigns).
- We recommend setting the "Sales" campaign objective for optimization based on specific in-app events.
- Select the conversion goals.
- By default, you see the predefined account-level campaign goals. You can keep those, or remove ones that aren't relevant for your campaign.
- If you don’t see the goal you want, add the conversion action and conversion goal.
- You can also edit your predefined goals in the Conversions page.
- Select the campaign type.
- All campaign types are applicable, except "Shopping" which requires a product catalog and is limited to verified domains.
- Enter the cross-platform landing page URL as Google's final URL.
Campaigns that redirect to a single app store
To set up a campaign that redirects users to a single platform and app store:
- Set up a direct attribution link as described in the attribution link section.
- Log in to Google Ads and create a new campaign.
- Select the campaign objective.
- All objectives are applicable, except "App promotion" (which can only be used for mobile app campaigns).
- We recommend setting the "Sales" campaign objective for optimization based on specific in-app events.
- Select the conversion goals.
- By default, you see the predefined account-level campaign goals. You can keep those, or remove ones that aren't relevant for your campaign.
- If you don’t see the goal you want, add the conversion action and conversion goal.
- You can also edit your predefined goals in the Conversions page.
- Select the campaign type.
- All campaign types are applicable, except "Shopping" which requires a product catalog and is limited to verified domains.
- Enter the link to be used as Google's final URL.
- This must be the final web location you want to redirect your users to. It can be any web URL including a web landing page or store URL. For example:
https://store.steampowered.com/app/{appid}/{myapp}/
. - The final URL can't be an AppsFlyer URL, as this may cause your campaign to be rejected. Only use a direct web address that has no redirects.
- This must be the final web location you want to redirect your users to. It can be any web URL including a web landing page or store URL. For example:
- Enter your AppsFlyer direct attribution link as Google's Tracking Template URL.
- For parallel tracking to function as intended, the final URL must be placed in the {lpurl} ValueTrack parameter in Google’s Tracking Template URL as specified by Google.
- Don't include the af_dp parameter.
Create conversion actions and goals
In Google Ads, you can either select from the predefined list of conversion actions and goals or create your own.
Important! For AppsFlyer to send a "First Open" event postback, you need to create a conversion action and name it "First Open".
To create your own Google Ads conversion actions and goals:
- In your Google Ads account overview page, from the side menu, select Goals > Conversions > Summary.
- Click + New conversion action.
- Select Import from the list of conversion types, then select Manual import using API or uploads > Track conversions from clicks.
Note
If Manual import using API or uploads is not available:
- Select CRM, files, or other data sources > Track conversions from clicks.
- In Data source select Skip this step and set up data source later.
- Click Continue.
A form displays. - Fill out the form and click Create and continue to finish creating your conversion tracker.
- For Goal and action optimization, select a category to map your conversion action into.
Note: Google ads campaign optimization is per category; not per specific action). If you only want your campaigns to optimize to a single action, make sure to map only that action to this category. For example, if you want your campaign to optimize towards the "install" action, make sure to map the "install" action to its own category, for example, “Other.” You’ll then be able to select this category as the campaign goal when creating the campaign. - Copy the conversion action ID from Google Ads and enter it in the mapped to partner event field. The Conversion Action ID is used as the partner event ID when mapping the AppsFlyer event name to the partner event ID in the in-app event postbacks setup. To copy the conversion action ID from Google Ads perform the following:
- In Google Ads Conversion Goals page, click the conversion action you created.
- In the Conversion Action Details page, copy the Conversion Action ID from the URL parameter
ctId=
and paste it.
- Click Create and continue.
- Click Finish.