Send query results to Google Ads

Google Ads is search-based advertising that runs across the Google advertising network. Use search-based advertising to promote your brand, help sell products or services, raise awareness, and increase traffic to your website or stores.

Note

This destination uses the Google Audience Partner API .

Changes to audiences are not immediately available in Google Ads. Allow for up to 48 hours after the point at which Amperity has finished sending audience updates for them to be available.

Important

Review the user consent policy for the European Union (EU) and European Economic Area (EEA), and then add the required columns to your orchestration or campaign.

Important

Amperity requires access to Google Ads. This access may expire or be removed periodically, depending on how OAuth is managed at Google Ads. If Amperity is unable to send data to Google Ads ask your DataGrid Operator to reauthorize access to Google Ads.

This topic describes the steps that are required to send customer data to Google Ads from Amperity.

  1. Build a query

  2. Add orchestration

  3. Run orchestration

Caution

This destination is available for sending query results to Google Ads after it is configured by a Datagrid Operator or your Amperity representative.

If this destintion cannot be selected from the campaigns editor or activations canvas ask your Datagrid Operator or Amperity representative to configure a destination for sending sending query results to Google Ads.

Build query

You will need to build a query that outputs fields that can be mapped to Google Ads API matching keys, one of:

  1. Contact information, including personally identifiable information (PII) matching

  2. Mobile device matching

  3. Advertiser-generated and assigned user ID matching.

Note

The Google Ads API has specific requirements. Define a query, and then export it as a CSV file to profile the data.

  • Add and normalize the country code when states are US and Canada, but the country is NULL.

  • Phone numbers are required to have a +11231234567 format.

  • First name, last name, zip code, and country are all required for the “Contact Info” upload key. If any are missing, none are passed.

Example

 1SELECT
 2  email AS Email
 3  ,CONCAT('+',REGEXP_REPLACE(phone, '(\s*)([^a-zA-Z0-9])', '')) AS Phone
 4  ,surname AS LastName
 5  ,given_name AS FirstName
 6  ,postal AS Zip
 7  ,country AS Country
 8FROM Merged_Customers
 9WHERE email IS NOT NULL
10OR phone IS NOT NULL
11OR (given_name IS NOT NULL
12    AND surname IS NOT NULL
13    AND postal IS NOT NULL
14    AND country IS NOT NULL
15)

Add orchestration

An orchestration defines the relationship between query results and a destination, including the destination and the frequency at which an orchestration runs.

To add an orchestration

  1. Open the Activations page, select the Orchestrations tab, and then click the Add orchestration button. This opens the Add orchestration dialog box.

  2. From the Object type dropdown, select Query.

  3. From the Object dropdown, select the query for which results will be sent to Google Ads.

  4. From the Destination dropdown, select a destination that is configured for sending data to Google Ads.

  5. Verify all settings.

  6. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  7. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. Open the Activations page, select the Orchestrations tab, and then open the    menu for the Google Ads orchestration. Select Run.

  2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.