> ## 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.

# Google Ads Connector

> Deliver audience segments to Google Ads for Customer Match campaigns

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](https://support.google.com/google-ads/answer/6379332) 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

| Requirement        | Description                                                                                                                       |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Google Ads account | A Google Ads Customer ID                                                                                                          |
| Account linkage    | Your Google Ads account must be linked to Narrative's Data Partner account. Contact your Narrative representative to set this up. |

<Note>
  Account linkage is a one-time setup step handled by Narrative support. Once linked, you can create profiles and deliver audiences without further assistance.
</Note>

### Supported identifiers

| Identifier Type                     | Rosetta Stone Attribute                               |
| ----------------------------------- | ----------------------------------------------------- |
| SHA256 hashed email                 | `sha256_hashed_email`                                 |
| Hashed email (SHA256)               | `hashed_email` (type `sha256_email`)                  |
| Raw email                           | `raw_email` (automatically normalized and hashed)     |
| Hashed name + postal code + country | `person_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)

<Warning>
  Unlike the [Google DV360 connector](/reference/connectors/google-dv360), the Google Ads connector does not support phone number identifiers.
</Warning>

## Installation

<Steps>
  <Step title="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.
  </Step>

  <Step title="Navigate to the connector">
    In Narrative, go to **Installed Apps** and select **Google Ads Connector**.
  </Step>

  <Step title="Create a profile">
    Enter your **Google Ads Customer ID**, a **Profile name**, and an optional description.
  </Step>
</Steps>

## 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.

| Setting             | Description                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| Name                | Display name for the audience in Google Ads (max 64 characters, defaults to dataset name)      |
| Description         | Optional description shown in Google Ads                                                       |
| Membership duration | How long users remain in the list (1–540 days, default 540). Set to maximum for no expiration. |
| Historical data     | Whether to include previously ingested data (default: enabled)                                 |

### Existing user list

Appends data to a user list that already exists in your Google Ads account.

| Setting         | Description                                                    |
| --------------- | -------------------------------------------------------------- |
| User list ID    | The numeric ID of the existing user list in Google Ads         |
| Historical data | Whether to include previously ingested data (default: enabled) |

***

## Related content

<CardGroup cols={2}>
  <Card title="Data Activation Overview" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    Understand how connectors deliver data
  </Card>

  <Card title="Google DV360 Connector" icon="google" href="/reference/connectors/google-dv360">
    Activate audiences in Display & Video 360
  </Card>

  <Card title="Hashing PII" icon="hashtag" href="/guides/ingestion/hashing-pii">
    Prepare identifiers for Google Ads
  </Card>

  <Card title="Structuring Audiences" icon="sitemap" href="/guides/activation/audience-strategies">
    Organize datasets for delivery
  </Card>
</CardGroup>