Skip to content

Commit a615364

Browse files
authored
[STRATCONN-642] Update references to Adwords Remarketing Lists (Customer Match) (#1596)
1 parent 4264b26 commit a615364

File tree

4 files changed

+111
-105
lines changed

4 files changed

+111
-105
lines changed

scripts/catalog.js

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ const slugify = (displayName) => {
2222
if (slug === 'roku-alpha') slug = 'roku'
2323
if (slug === 'shopify-by-littledata') slug = 'shopify-littledata'
2424
if (slug === 'talon-one') slug = 'talonone'
25+
if (slug == 'google-adwords-remarketing-lists-customer-match') slug = 'adwords-remarketing-lists'
26+
if (slug == 'canny-classic') slug = 'canny'
2527
return slug
2628
}
2729

src/_data/catalog/destinations.yml

Lines changed: 90 additions & 86 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
2-
# destination data last updated 2021-06-01
2+
# destination data last updated 2021-06-04
33
items:
44
- display_name: ActiveCampaign
55
slug: activecampaign
@@ -288,69 +288,6 @@ items:
288288
max: 0
289289
description: ''
290290
settings: []
291-
- display_name: AdWords Remarketing Lists
292-
slug: adwords-remarketing-lists
293-
name: catalog/destinations/adwords-remarketing-lists
294-
url: connections/destinations/catalog/adwords-remarketing-lists
295-
description: >-
296-
The Google Adwords audience destination syncs your Segment audiences into
297-
your Adwords account.
298-
hidden: false
299-
status: PUBLIC
300-
previous_names:
301-
- PERSONAS - Google AdWords
302-
logo:
303-
url: 'https://cdn.filepicker.io/api/file/EBKkKkQWKYb472vQVp9w'
304-
mark:
305-
url: 'https://cdn.filepicker.io/api/file/9VImDdjKTFWSWvdsPLxh'
306-
categories:
307-
- Advertising
308-
methods:
309-
alias: false
310-
group: false
311-
identify: false
312-
page_view: false
313-
track: false
314-
components: []
315-
platforms:
316-
browser: true
317-
server: true
318-
mobile: true
319-
browserUnbundlingSupported: false
320-
browserUnbundlingPublic: true
321-
connection_modes:
322-
device:
323-
web: false
324-
mobile: false
325-
server: false
326-
cloud:
327-
web: false
328-
mobile: false
329-
server: false
330-
summary: No connection mode information available.
331-
cmode_type: none
332-
case: '0'
333-
settings:
334-
- name: account
335-
display_name: Account
336-
type: STRING
337-
deprecated: false
338-
required: false
339-
string_validators:
340-
regexp: ''
341-
description: Choose an account.
342-
settings: []
343-
- name: appId
344-
display_name: App ID
345-
type: STRING
346-
deprecated: false
347-
required: false
348-
string_validators:
349-
regexp: ''
350-
description: >-
351-
Optionally enter a mobile app ID. This is only needed if you plan to
352-
export mobile IDs to AdWords.
353-
settings: []
354291
- display_name: Adikteev
355292
slug: adikteev
356293
name: catalog/destinations/adikteev
@@ -4516,7 +4453,7 @@ items:
45164453
regexp: '^.{8,}$'
45174454
description: ''
45184455
settings: []
4519-
- display_name: Canny
4456+
- display_name: Canny-Classic
45204457
slug: canny
45214458
name: catalog/destinations/canny
45224459
url: connections/destinations/catalog/canny
@@ -4525,6 +4462,7 @@ items:
45254462
status: PUBLIC
45264463
previous_names:
45274464
- Canny
4465+
- Canny-Classic
45284466
logo:
45294467
url: >-
45304468
https://public-segment-devcenter-production.s3.amazonaws.com/9338aebf-369e-4350-ad24-d2acf23e576e.svg
@@ -5993,21 +5931,22 @@ items:
59935931
slug: crowdpower
59945932
name: catalog/destinations/crowdpower
59955933
url: connections/destinations/catalog/crowdpower
5996-
description: ''
5934+
description: User engagement and customer data platform for your SaaS.
59975935
hidden: false
59985936
status: PUBLIC_BETA
59995937
previous_names:
60005938
- CrowdPower
60015939
logo:
60025940
url: >-
6003-
https://public-segment-devcenter-production.s3.amazonaws.com/f85fb1a1-d981-420d-abf0-aeeaf8a0842a.svg
5941+
https://public-segment-devcenter-production.s3.amazonaws.com/9481529e-9548-420a-b106-b674ee68f04c.svg
60045942
mark:
60055943
url: >-
6006-
https://public-segment-devcenter-production.s3.amazonaws.com/fa4f27ca-dee8-4abc-b0c3-8a09a3926845.svg
5944+
https://public-segment-devcenter-production.s3.amazonaws.com/8307f36c-4e27-4098-94cd-af0db04c6183.svg
60075945
categories:
6008-
- Marketing Automation
6009-
- CRM
60105946
- Analytics
5947+
- CRM
5948+
- Email Marketing
5949+
- Marketing Automation
60115950
methods:
60125951
alias: false
60135952
group: false
@@ -9825,6 +9764,71 @@ items:
98259764
required: false
98269765
description: Disable this if you don't want to use cookies
98279766
settings: []
9767+
- display_name: Google AdWords Remarketing Lists (Customer Match)
9768+
slug: adwords-remarketing-lists
9769+
name: catalog/destinations/adwords-remarketing-lists
9770+
url: connections/destinations/catalog/adwords-remarketing-lists
9771+
description: >-
9772+
The Google Adwords audience destination syncs your Segment audiences into
9773+
your Adwords account.
9774+
hidden: false
9775+
status: PUBLIC
9776+
previous_names:
9777+
- PERSONAS - Google AdWords
9778+
- Adwords Remarketing Lists
9779+
- Google Adwords Remarketing Lists (Customer Match)
9780+
logo:
9781+
url: 'https://cdn.filepicker.io/api/file/EBKkKkQWKYb472vQVp9w'
9782+
mark:
9783+
url: 'https://cdn.filepicker.io/api/file/9VImDdjKTFWSWvdsPLxh'
9784+
categories:
9785+
- Advertising
9786+
methods:
9787+
alias: false
9788+
group: false
9789+
identify: false
9790+
page_view: false
9791+
track: false
9792+
components: []
9793+
platforms:
9794+
browser: true
9795+
server: true
9796+
mobile: true
9797+
browserUnbundlingSupported: false
9798+
browserUnbundlingPublic: true
9799+
connection_modes:
9800+
device:
9801+
web: false
9802+
mobile: false
9803+
server: false
9804+
cloud:
9805+
web: false
9806+
mobile: false
9807+
server: false
9808+
summary: No connection mode information available.
9809+
cmode_type: none
9810+
case: '0'
9811+
settings:
9812+
- name: account
9813+
display_name: Account
9814+
type: STRING
9815+
deprecated: false
9816+
required: false
9817+
string_validators:
9818+
regexp: ''
9819+
description: Choose an account.
9820+
settings: []
9821+
- name: appId
9822+
display_name: App ID
9823+
type: STRING
9824+
deprecated: false
9825+
required: false
9826+
string_validators:
9827+
regexp: ''
9828+
description: >-
9829+
Optionally enter a mobile app ID. This is only needed if you plan to
9830+
export mobile IDs to AdWords.
9831+
settings: []
98289832
- display_name: Google Ads (Classic)
98299833
slug: google-ads-classic
98309834
name: catalog/destinations/adwords
@@ -19126,22 +19130,6 @@ items:
1912619130
required: false
1912719131
description: Map your Segment properties to Responsys Columns
1912819132
settings:
19129-
- name: primaryKey
19130-
display_name: Set as Primary Key
19131-
type: BOOLEAN
19132-
deprecated: false
19133-
required: false
19134-
description: Mark this property as a Primary Key in Responsys.
19135-
settings: []
19136-
- name: columns
19137-
display_name: Segment Property Name
19138-
type: STRING
19139-
deprecated: false
19140-
required: true
19141-
string_validators:
19142-
regexp: ''
19143-
description: Enter the Segment Property Name.
19144-
settings: []
1914519133
- name: fieldName
1914619134
display_name: Responsys Column Name
1914719135
type: STRING
@@ -19168,6 +19156,22 @@ items:
1916819156
- TIMESTAMP
1916919157
description: Enter the Responsys column type.
1917019158
settings: []
19159+
- name: primaryKey
19160+
display_name: Set as Primary Key
19161+
type: BOOLEAN
19162+
deprecated: false
19163+
required: false
19164+
description: Mark this property as a Primary Key in Responsys.
19165+
settings: []
19166+
- name: columns
19167+
display_name: Segment Property Name
19168+
type: STRING
19169+
deprecated: false
19170+
required: true
19171+
string_validators:
19172+
regexp: ''
19173+
description: Enter the Segment Property Name.
19174+
settings: []
1917119175
- name: mapEmail
1917219176
display_name: Map Email
1917319177
type: BOOLEAN

src/connections/destinations/catalog/adwords-remarketing-lists/index.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Google Adwords Remarketing Lists Destination
2+
title: Google Adwords Remarketing Lists (Customer Match) Destination
33
hide-boilerplate: true
44
---
55

66
> note "About Google destinations"
7-
> This page is about the **Google Adwords Remarketing Lists** destination supported by Segment Personas. For documentation on other Google Destinations, see the pages below.
7+
> This page is about the **Google Adwords Remarketing Lists (Customer Match)** destination supported by Segment Personas. For documentation on other Google Destinations, see the pages below.
88
99

1010
| **Google Destination** | **Supported by Personas** |
@@ -18,7 +18,7 @@ hide-boilerplate: true
1818
| [Google Ads (Gtag)](/docs/connections/destinations/catalog/google-adwords-new/) | No |
1919
| [Google Ads (Classic)](/docs/connections/destinations/catalog/google-ads-classic/) | Yes - Event Destination |
2020
| [Google Analytics](/docs/connections/destinations/catalog/google-analytics/) | Yes - Event Destination |
21-
| Google Adwords Remarketing Lists | Yes - List Destination |
21+
| Google Adwords Remarketing Lists (Customer Match) | Yes - List Destination |
2222

2323
## Details
2424

@@ -35,14 +35,14 @@ hide-boilerplate: true
3535

3636
## Overview
3737

38-
The Google Adwords Remarketing Lists Destination is one of our most popular Personas List Destinations. It has a variety of use cases related to exclusion, acquisition (using Similar Audience), re-marketing, and more.
38+
The Google Adwords Remarketing Lists (Customer Match) Destination is one of our most popular Personas List Destinations. It has a variety of use cases related to exclusion, acquisition (using Similar Audience), re-marketing, and more.
3939

4040
This Destination can send *audiences* (lists of users) created in [Personas](/docs/personas/) to Google Adwords Audience Lists as a [**Customer List**](https://support.google.com/google-ads/answer/7558048) type. Once you set this up, Segment sends an [initial list](https://developers.google.com/analytics/devguides/config/mgmt/v3/remarketing#insert) of users to Google Adwords Audience lists as a “Customer list”. As users move in and out of the audience, Segment automatically [updates the list](https://developers.google.com/analytics/devguides/config/mgmt/v3/remarketing#insert) in Google every 6 hours. This allows you to run advertising campaigns without having manually update the list of users to target in Adwords campaigns.
4141

4242
Currently, you can only send either an email address or mobile id (IDFA) from Segment Personas to Google as custom matchers. You can set an email address on the user profile by including `email` as a trait on an [`identify` call](/docs/connections/spec/identify/), as a property on a [`track` call](/docs/connections/spec/track/) or as an [external id](/docs/personas/identity-resolution/externalids/) for the user.
4343
If you use Segment’s mobile SDK to collect events from a mobile app, the user’s IDFA is automatically captured. If you do not use Segment’s mobile SDK, you can set the user’s IDFA by setting it within `context.device.advertisingId`.
4444

45-
When you send an audience to Google Adwords Remarketing Lists, you can choose which custom matcher (email or mobile id/IDFA) to match with. If a user has multiple emails or IDFAs on their account as `external_ids`, Personas only sends Adwords the ID that was most recently added to the user profile.
45+
When you send an audience to Google Adwords Remarketing Lists (Customer Match), you can choose which custom matcher (email or mobile id/IDFA) to match with. If a user has multiple emails or IDFAs on their account as `external_ids`, Personas only sends Adwords the ID that was most recently added to the user profile.
4646

4747
These audience lists can be used serve content on Google Search, YouTube, and Gmail. You can only target users with email addresses that are associated with a Google account, and you can target users in Gmail only if they have an `@gmail.com` address. <!--For Personas audiences that are compatible with Google Display Network, see our documentation for DV360. -->
4848

@@ -51,12 +51,12 @@ These audience lists can be used serve content on Google Search, YouTube, and Gm
5151
5252
## Use Cases: Known Users
5353

54-
Google Adwords Remarketing Lists allows you to efficiently run several marketing and advertising operations. The list below contains the most popular use cases when you know personally identifiable information (PII) about your users, such as email address or mobile device id (IDFA). When you send a Personas audience to Google Adwords Remarketing Lists with email addresses or mobile device ids (IDFA), Segment hashes the PII values before sending them to Google. Google then uses these identifiers to match with users on their ad network to allow the following use cases.
54+
Google Adwords Remarketing Lists (Customer Match) allows you to efficiently run several marketing and advertising operations. The list below contains the most popular use cases when you know personally identifiable information (PII) about your users, such as email address or mobile device id (IDFA). When you send a Personas audience to Google Adwords Remarketing Lists (Customer Match) with email addresses or mobile device ids (IDFA), Segment hashes the PII values before sending them to Google. Google then uses these identifiers to match with users on their ad network to allow the following use cases.
5555

5656

5757
### Exclusion audiences (Suppression audiences)
5858

59-
Create an audience of users that signed up, purchased a product, or otherwise performed some conversion event. You can then send those users to Google in a timely manner (hourly syncs) to prevent advertising to users that already converted. You can do this by creating an Audience in Personas, syncing it to the Google Adwords Remarketing Lists, and setting it as an [Exclusion List](https://support.google.com/google-ads/answer/2549058?hl=en-AU) in your Adwords campaign.
59+
Create an audience of users that signed up, purchased a product, or otherwise performed some conversion event. You can then send those users to Google in a timely manner (hourly syncs) to prevent advertising to users that already converted. You can do this by creating an Audience in Personas, syncing it to the Google Adwords Remarketing Lists (Customer Match), and setting it as an [Exclusion List](https://support.google.com/google-ads/answer/2549058?hl=en-AU) in your Adwords campaign.
6060

6161

6262
### Similar audience
@@ -73,7 +73,7 @@ You can use Personas to target users who completed some initial action, but didn
7373

7474
## How it works
7575

76-
When you create an audience in Personas and connect it to Google Adwords Remarketing Lists, Segment does the following:
76+
When you create an audience in Personas and connect it to Google Adwords Remarketing Lists (Customer Match), Segment does the following:
7777

7878
1. Creates an Adwords Audience list (type Customer List) with the name you entered in Personas.
7979
2. Adds any users that fit the audience definition based on Email or Mobile ID (IDFA). Google uses these identifiers to match users in your list to users in the Google system who can be served ads.
@@ -95,15 +95,15 @@ When you create an audience in Personas and connect it to Google Adwords Remarke
9595

9696
Before you start, make sure you have administrative access to the Adwords account so you can set up and link this destination.
9797

98-
### 1. Add Adwords Remarketing Lists as a Personas Destination**
98+
### 1. Add Adwords Remarketing Lists (Customer Match) as a Personas Destination**
9999

100100
1. Navigate to the Destinations section of your Personas space, and click **Add Destination**.
101101

102-
2. Search for “Adwords Remarketing Lists” and click **Configure**.
102+
2. Search for “Adwords Remarketing Lists (Customer Match)” and click **Configure**.
103103

104-
3. Click **Connect to Adwords Remarketing Lists**. You are prompted to sign in to your Google Adwords account. (Make sure you sign in to the account that has administrator access!)
104+
3. Click **Connect to Adwords Remarketing Lists (Customer Match)**. You are prompted to sign in to your Google Adwords account. (Make sure you sign in to the account that has administrator access!)
105105

106-
4. When prompted, click **Allow**. This is required for Segment to update your Google Adwords Remarketing Lists.
106+
4. When prompted, click **Allow**. This is required for Segment to update your Google Adwords Remarketing Lists (Customer Match).
107107
![](images/garl-auth-google.png)
108108

109109
5. Select the Adwords account or sub-account to connect with Personas.
@@ -112,11 +112,11 @@ Before you start, make sure you have administrative access to the Adwords accoun
112112

113113
![Example of Sub-accounts in Selector](images/adwords_subaccounts.png)
114114

115-
### 2. Create an audience in Segment and connect it to Google Adwords Remarketing Lists
115+
### 2. Create an audience in Segment and connect it to Google Adwords Remarketing Lists (Customer Match)
116116

117117
1. Navigate to the Personas Audiences tab or go to `https://app.segment.com/goto-my-workspace/personas/audiences` and create a new audience.
118118
2. Give your audience a name, some event and trait criteria, then click **Preview**.
119-
3. Select “AdWords Remarketing Lists” as a destination for your Audience.
119+
3. Select “AdWords Remarketing Lists (Customer Match)” as a destination for your Audience.
120120
4. Select either Email or Mobile ID to use as a custom matcher.
121121
![](images/garl-select_id.png)
122122

@@ -141,7 +141,7 @@ In Google Adwords go to **Tools & Settings** > **Shared Library**> **Audience ma
141141

142142
Make sure you authorized Google Adwords, and selected the correct account.
143143

144-
Make sure you have administrator access for your Google Adwords account. You can check that your Adwords credentials are correct by navigating the the Adwords Remarketing Lists destination in Personas→ Destinations, and viewing the settings.
144+
Make sure you have administrator access for your Google Adwords account. You can check that your Adwords credentials are correct by navigating the the Adwords Remarketing Lists (Customer Match) destination in Personas→ Destinations, and viewing the settings.
145145

146146
![](images/garl-configure_dest.png)
147147

@@ -157,7 +157,7 @@ If a user has more than one email address or IDFA on their account as `external_
157157

158158
#### What Google campaigns does Personas support?
159159

160-
Personas audiences can only send to Google Adwords Remarketing Lists for Google Search, YouTube and Gmail campaigns. Gmail campaigns can only target users with a `@gmail` address.
160+
Personas audiences can only send to Google Adwords Remarketing Lists (Customer Match) for Google Search, YouTube and Gmail campaigns. Gmail campaigns can only target users with a `@gmail` address.
161161

162162
#### How many users must be in an audience be to use Google Adwords Campaigns?
163163

src/personas/using-personas-data.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ The table below includes the _most important_ Personas Destinations that we supp
2525
| **Destination** | **Category** |
2626
| === | === |
2727
| [Facebook Custom Audiences](/docs/connections/destinations/catalog/personas-facebook-custom-audiences/) | Advertising |
28-
| [Google Adwords Remarketing Lists](/docs/connections/destinations/catalog/adwords-remarketing-lists/) | Advertising |
28+
| [Google Adwords Remarketing Lists (Customer Match)](/docs/connections/destinations/catalog/adwords-remarketing-lists/) | Advertising |
2929
| [Braze](/docs/connections/destinations/catalog/braze/) | Marketing Automation |
3030
| [Intercom](/docs/connections/destinations/catalog/intercom/) | Livechat |
3131
| [Amazon Kinesis](/docs/connections/destinations/catalog/amazon-kinesis/) | Raw Data |
@@ -225,7 +225,7 @@ When you create a new Computed Trait or Audience in Personas, you can choose to
225225
## Personas Compatible Destinations: Event Type
226226

227227
- [ActiveCampaign](/docs/connections/destinations/catalog/activecampaign/)
228-
- [AdWords Remarketing Lists](/docs/connections/destinations/catalog/adwords-remarketing-lists/)
228+
- [AdWords Remarketing Lists (Customer Match)](/docs/connections/destinations/catalog/adwords-remarketing-lists/)
229229
- [Adjust](/docs/connections/destinations/catalog/adjust/)
230230
- [Adobe Analytics](/docs/connections/destinations/catalog/adobe-analytics/)
231231
- [Adtriba](/docs/connections/destinations/catalog/adtriba/)
@@ -402,5 +402,5 @@ When you create a new Computed Trait or Audience in Personas, you can choose to
402402
## Personas Compatible Destinations: List Type
403403

404404
- [Facebook Custom Audiences](/docs/connections/destinations/catalog/personas-facebook-custom-audiences/)
405-
- [AdWords Remarketing Lists](/docs/connections/destinations/catalog/adwords-remarketing-lists/)
405+
- [AdWords Remarketing Lists (Customer Match)](/docs/connections/destinations/catalog/adwords-remarketing-lists/)
406406
- [Marketo Static Lists](/docs/connections/destinations/catalog/marketo-static-lists/)

0 commit comments

Comments
 (0)