Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

The Google Ads Connector delivers audience data to your Google Ads account using Google’s Audience Partner API, enabling you to activate segments for Customer Match advertising campaigns.

​
Overview

The connector uploads user lists to Google Ads, where they become available as audience segments for targeting across Search, Shopping, Gmail, YouTube, and Display campaigns. It supports creating new user lists or appending to existing ones.

​
Requirements

​
Account setup

RequirementDescription
Google Ads accountA Google Ads Customer ID
Account linkageYour Google Ads account must be linked to Narrative’s Data Partner account. Contact your Narrative representative to set this up.
Account linkage is a one-time setup step handled by Narrative support. Once linked, you can create profiles and deliver audiences without further assistance.

​
Supported identifiers

Identifier TypeRosetta Stone Attribute
SHA256 hashed emailsha256_hashed_email
Hashed email (SHA256)hashed_email (type sha256_email)
Raw emailraw_email (automatically normalized and hashed)
Hashed name + postal code + countryperson_name, iso_3166_1_country, postal_address
Your data must include at least one email-based identifier or the complete set of name, postal code, and country attributes. Both can be present on the same row. For name-based matching, all three attributes are required together:
  • SHA256 hashed first name and last name
  • Postal code
  • Country code (ISO 3166-1)
Unlike the Google DV360 connector, the Google Ads connector does not support phone number identifiers.

​
Installation

1

Link your Google Ads account

Contact your Narrative representative to link your Google Ads account to Narrative’s Data Partner account. You’ll need to provide your Google Ads Customer ID.
2

Navigate to the connector

In Narrative, go to Installed Apps and select Google Ads Connector.
3

Create a profile

Enter your Google Ads Customer ID, a Profile name, and an optional description.

​
Delivering audiences

When connecting a dataset to the Google Ads connector, you choose how the audience is created:

​
New user list

Creates a new Customer Match user list in your Google Ads account.
SettingDescription
NameDisplay name for the audience in Google Ads (max 64 characters, defaults to dataset name)
DescriptionOptional description shown in Google Ads
Membership durationHow long users remain in the list (1–540 days, default 540). Set to maximum for no expiration.
Historical dataWhether to include previously ingested data (default: enabled)

​
Existing user list

Appends data to a user list that already exists in your Google Ads account.
SettingDescription
User list IDThe numeric ID of the existing user list in Google Ads
Historical dataWhether to include previously ingested data (default: enabled)

​
Related content

Data Activation Overview

Understand how connectors deliver data

Google DV360 Connector

Activate audiences in Display & Video 360

Hashing PII

Prepare identifiers for Google Ads

Structuring Audiences

Organize datasets for delivery