Skip to content

Commit bf8d9aa

Browse files
author
markzegarelli
authored
Merge pull request #1374 from segmentio/DOC-110_SAM-Dest
DOC 110 SAM Dest
2 parents 644ed70 + 6b58adf commit bf8d9aa

File tree

2 files changed

+144
-28
lines changed

2 files changed

+144
-28
lines changed

‎src/_data/catalog/destinations.yml

Lines changed: 78 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7476,7 +7476,7 @@ items:
74767476
description: >-
74777477
The Facebook Pixel integration lets you measure and optimize the performance
74787478
of your Facebook Ads.
7479-
hidden: false
7479+
hidden: true
74807480
url: connections/destinations/catalog/facebook-conversions-api
74817481
status: PUBLIC_BETA
74827482
logo:
@@ -13431,17 +13431,6 @@ items:
1343113431
required: false
1343213432
description: Map your Segment properties to the Marketo Activity Fields
1343313433
settings:
13434-
- name: segmentProperty
13435-
display_name: Segment Property Name
13436-
type: STRING
13437-
deprecated: false
13438-
required: true
13439-
string_validators:
13440-
regexp: ''
13441-
description: >-
13442-
Enter the Segment Property Name. This is case sensitive so make sure
13443-
the name matches exactly how you are passing it in your .track() call.
13444-
settings: []
1344513434
- name: marketoAttributeName
1344613435
display_name: Marketo Field Name
1344713436
type: STRING
@@ -13473,6 +13462,17 @@ items:
1347313462
required: false
1347413463
description: Mark this property as the Primary field in Marketo.
1347513464
settings: []
13465+
- name: segmentProperty
13466+
display_name: Segment Property Name
13467+
type: STRING
13468+
deprecated: false
13469+
required: true
13470+
string_validators:
13471+
regexp: ''
13472+
description: >-
13473+
Enter the Segment Property Name. This is case sensitive so make sure
13474+
the name matches exactly how you are passing it in your .track() call.
13475+
settings: []
1347613476
- name: event
1347713477
display_name: Segment Event Name
1347813478
type: STRING
@@ -17745,6 +17745,22 @@ items:
1774517745
required: false
1774617746
description: Map your Segment properties to Responsys Columns
1774717747
settings:
17748+
- name: primaryKey
17749+
display_name: Set as Primary Key
17750+
type: BOOLEAN
17751+
deprecated: false
17752+
required: false
17753+
description: Mark this property as a Primary Key in Responsys.
17754+
settings: []
17755+
- name: columns
17756+
display_name: Segment Property Name
17757+
type: STRING
17758+
deprecated: false
17759+
required: true
17760+
string_validators:
17761+
regexp: ''
17762+
description: Enter the Segment Property Name.
17763+
settings: []
1774817764
- name: fieldName
1774917765
display_name: Responsys Column Name
1775017766
type: STRING
@@ -17771,22 +17787,6 @@ items:
1777117787
- TIMESTAMP
1777217788
description: Enter the Responsys column type.
1777317789
settings: []
17774-
- name: primaryKey
17775-
display_name: Set as Primary Key
17776-
type: BOOLEAN
17777-
deprecated: false
17778-
required: false
17779-
description: Mark this property as a Primary Key in Responsys.
17780-
settings: []
17781-
- name: columns
17782-
display_name: Segment Property Name
17783-
type: STRING
17784-
deprecated: false
17785-
required: true
17786-
string_validators:
17787-
regexp: ''
17788-
description: Enter the Segment Property Name.
17789-
settings: []
1779017790
- name: mapEmail
1779117791
display_name: Map Email
1779217792
type: BOOLEAN
@@ -20473,6 +20473,56 @@ items:
2047320473
server: false
2047420474
previous_names:
2047520475
- Snapboard
20476+
- display_name: Snapchat Audiences
20477+
slug: snapchat-audiences
20478+
name: catalog/destinations/snapchat-audiences
20479+
description: >-
20480+
The Snapchat Audiences destination lets you sync audiences of users into
20481+
Snapchat. The Personas product is required to use this destination.
20482+
hidden: false
20483+
url: connections/destinations/catalog/snapchat-audiences
20484+
status: PUBLIC
20485+
logo:
20486+
url: 'https://cdn.filepicker.io/api/file/4pYPZIcPTDqRNgD9s6Pb'
20487+
mark:
20488+
url: 'https://cdn.filepicker.io/api/file/Up1KJzLMSg27dHkBdb7v'
20489+
categories:
20490+
- Advertising
20491+
components:
20492+
- type: CLOUD
20493+
platforms:
20494+
browser: false
20495+
server: true
20496+
mobile: false
20497+
browserUnbundlingSupported: false
20498+
browserUnbundlingPublic: true
20499+
methods:
20500+
alias: false
20501+
group: false
20502+
identify: false
20503+
page_view: false
20504+
track: true
20505+
settings:
20506+
- name: account
20507+
display_name: account
20508+
type: STRING
20509+
deprecated: false
20510+
required: true
20511+
string_validators:
20512+
regexp: ''
20513+
description: Choose your Snapchat Ads Account.
20514+
settings: []
20515+
connection_modes:
20516+
device:
20517+
web: false
20518+
mobile: false
20519+
server: false
20520+
cloud:
20521+
web: false
20522+
mobile: true
20523+
server: true
20524+
previous_names:
20525+
- Snapchat Audiences
2047620526
- display_name: Spinnakr
2047720527
slug: spinnakr
2047820528
name: catalog/destinations/spinnakr

‎src/connections/destinations/catalog/snapchat-audiences/index.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: Snapchat Audience Destination
3+
---
4+
The [Snapchat Ads](https://forbusiness.snapchat.com/advertising/targeting)https://forbusiness.snapchat.com/advertising/targeting product provides a way to target advertisements to a global audience and drive meaningful results.
5+
6+
Segment's integration with Snapchat Ad's Snap Audience Match (SAM) enables Segment customers to sync audiences created in Personas with Snapchat Advertising
7+
8+
For more information about advertising with Snapchat:
9+
- [SAM Audiences](https://businesshelp.snapchat.com/s/article/create-sam-audience?language=en_US)
10+
- [Snap Audience Match](https://developers.snapchat.com/api/docs/#create-an-audience-segment) (for developers)
11+
12+
## Quick info
13+
14+
**Requirements**
15+
- Personas enabled with an existing personas space
16+
- A Snapchat Ads account with permission to create audiences
17+
18+
**Supported identifiers**
19+
- email
20+
- phone number
21+
- iOS IDFA
22+
- Android IDFA
23+
24+
**Connection type**
25+
- Server-side
26+
27+
## Set up
28+
The Snapchat Audiences destination syncs audience data from Segment Personas to Snapchat Ads. To begin:
29+
30+
1. Navigate to the Destinations section of your Personas space, and click **Add Destination**.
31+
2. Search for `Snapchat Audience ` and click **Configure**.
32+
3. On the Snapchat Audiences configuration screen, click **Connect to Snapchat Audiences**. Log in to Snapchat with an account that has access to Ads Manager. Once authenticated, confirm the connection to Segment.
33+
4. Select the Snap Ads account that will receive audience data. This accounts represents an advertising entity or business, and not your personal Snapchat user account. You may belong to several Ad Accounts; make sure to select the correct account here. After the Ad Account is specified, the destination is active.
34+
5. Add the Snapchat Audiences Destination to an existing Personas Audience.
35+
1. Navigate to the Personas Space that contains the audience, and select it from the Audiences tab.
36+
2. Click **Add Destination**.
37+
3. The configured Snapchat Audiences destination should appear in the *Send as User List* category of available destinations.
38+
4. Click the destination and confirm the identifier: `Email`, `Phone`, or `Mobile ID`. Click **Save**.
39+
40+
- Segment sends hashed `email` or `idfa` values to Snapchat so that they can match those identifiers against Snapchat users.
41+
- Segment also supports `phoneNumber` if it is present on the user’s profile. Please make sure you pass phone numbers in a format that Snapchat supports. Read more in Snapchat’s documentation regarding [Normalizing and Hashing](https://developers.snapchat.com/api/docs/#normalizing-hashing).
42+
43+
**NOTE**: [Protocols](/docs/protocols) customers can use [Transformations](/docs/protocols/transform/) to change `phoneNumber` values to meet Snapchat's requirements.
44+
45+
1. Click **Add Destination** to activate the destination for your Personas Audience
46+
47+
The initial synchronization of audience data may take several hours, depending on the size of the audience. Once the initial sync occurs, you'll notice a new Audience in the Snap Ads dashboard.
48+
49+
## FAQ
50+
51+
### I'm passing phone number as the identifier to Snapchat, why doesn't the audience populate?
52+
53+
Verify the following:
54+
- You’re collecting user phone numbers when users are added to the Personas Audience, and that you have configured the destination to send `Phone`.
55+
- You’re collecting phone numbers in a format that Snapchat supports. For more information, see Snapchat’s documentation regarding [Normalizing and Hashing](https://developers.snapchat.com/api/docs/#normalizing-hashing).
56+
57+
### Why can’t I select our Ads Account during the destination setup?
58+
59+
Ensure the following criteria are met:
60+
61+
- Your personal Snapchat login has appropriate permissions within your business. Snapchat Account Admin or Data Manager permissions are required to configure and add audiences.
62+
- Your Snap Ads account is in `Active` status.
63+
64+
### How do I view the sync status?
65+
66+
Status will be shown in the Event Delivery tool. When you view the audience, you can open the side bar which directs you to [Event Delivery](/docs/getting-started/06-testing-debugging/#event-delivery).

0 commit comments

Comments
 (0)