diff --git a/src/connections/destinations/catalog/actions-snap-audiences/images/field_mapping_default.png b/src/connections/destinations/catalog/actions-snap-audiences/images/field_mapping_default.png new file mode 100644 index 0000000000..db95d1f77a Binary files /dev/null and b/src/connections/destinations/catalog/actions-snap-audiences/images/field_mapping_default.png differ diff --git a/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings.png b/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings.png new file mode 100644 index 0000000000..33dc0b4673 Binary files /dev/null and b/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings.png differ diff --git a/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings_ad_ids_emphasised.png b/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings_ad_ids_emphasised.png new file mode 100644 index 0000000000..400babf578 Binary files /dev/null and b/src/connections/destinations/catalog/actions-snap-audiences/images/id_sync_mappings_ad_ids_emphasised.png differ diff --git a/src/connections/destinations/catalog/actions-snap-audiences/index.md b/src/connections/destinations/catalog/actions-snap-audiences/index.md new file mode 100644 index 0000000000..5b500fe88a --- /dev/null +++ b/src/connections/destinations/catalog/actions-snap-audiences/index.md @@ -0,0 +1,82 @@ +--- +title: Snap Audiences (Actions) Destination +id: 67051b748c30a5c1360144ff +beta: true +--- + +{% include content/plan-grid.md name="actions" %} + +[Snap Ads](https://forbusiness.snapchat.com/advertising/targeting/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"} provides a way to target advertisements to a global audience and drive meaningful results. + +This destination is maintained by Segment. For any issues with the destination, [contact the Segment support team](mailto:friends@segment.com){:target="_blank"}. + +> warning "" +> This page is about the [**Actions-framework**](/docs/connections/destinations/actions/) Snap Ads Segment destination. See the [Snapchat Audience destination documentation](/docs/connections/destinations/catalog/snapchat-audiences/) for the **non-Actions** Snap Ads destination. +> +> **Both destinations receive data from Segment**. + +## Benefits of Snap Ads (Actions) vs Snapchat Audience Classic + +Snap Audiences (Actions) provides the following benefits over the classic Snapchat Audience destination: + +- **Multiple concurrent identifiers**. Email, phone number and Mobile Advertising IDs are supported concurrently. There's no need to select only one type of user identifier to sync with. + +- **Improved match rates**. Improved match-rate when multiple identifiers per profile are synced. + +## Getting started + +### Create the destination and authenticate to Snap Ads +1. In Segment, go to **Engage**, and select your workspace. +2. Navigate to **Engage Settings** and select the **Destinations** tab. +3. Click **Add destination**. +4. Search for "Snap Audiences (Actions)" and configure the destination. +5. On the Snapchat Audiences configuration screen, click **Connect to Snap Audiences (Actions)**. Log in to Snapchat with an account that has access to Ads Manager. Once authenticated, confirm the connection to Segment. +6. Select the Snap Ads account to receive audience data. This account represents an advertising entity or business, and not your personal Snapchat user account. You might belong to several Ad Accounts; make sure to select the correct account. After the Ad Account is specified, the destination is active. + +### Configure mappings +1. In Segment, go to **Connections > Destinations** and find the Snap Audiences (Actions) Destinations you just created. +2. Click on the **Mappings** tab, then **New Mapping**, then the **Sync Audience** Action. There should be no need to edit any of the Mapping fields, so click the **Next** button. +3. Give the action a name, then click **Save and Enable**. + +### Connect and sync your audience +Next, add the Snapchat Audiences Destination to an existing Engage Audience. + +1. Navigate to **Engage > Audiences**. Find and click on the Audience you'd like to sync. +2. Click **Add destination**. +3. The configured Snap Audiences (Actions) destination should appear in the **Send as User List** category of available destinations. +4. Provide values in the **Audience Name** and **Audience Description** fields. +5. Ensure that **track** is selected under **Connection Settings**. You can ignore the **Send Mobile IDs** as you can configure Mobile Advertising IDs in the next step. +6. Click on **Customized Setup** and add the identifiers you'd like to sync with. These should include one or more of: `email`, `phone`, `android.idfa`, `ios.idfa`. If you choose to sync `android.idfa` and/or `ios.idfa`, you must update the destination mappings to use underscores: `android_idfa` and `ios_idfa`. +![Image showing how to configure identifiers using ID Sync](images/id_sync_mappings.png) +7. Click **Save** then **Add 1 Destination**. + +Your audience should now be configured to sync to Snap Ads. 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. + +{% include components/actions-fields.html %} + +## FAQs + +#### Which identifiers types are supported? + +The Snap Audience (Actions) destination supports syncing using `email`, `phone` number and `Mobile Advertising IDs`. `email` is the default identifier; other identifiers should be configured using [ID Sync](https://segment.com/docs/engage/trait-activation/id-sync/). + +#### Why aren't Mobile Advertising IDs syncing properly? + +Mobile Advertising IDs need to be correctly configured using [ID Sync](https://segment.com/docs/engage/trait-activation/id-sync/). Note the underscores for `android_idfa` and `ios_idfa`. + +![Image showing how to configure Mobile Advertising IDs using ID Sync](images/id_sync_mappings_ad_ids_emphasised.png) + +The field mapping for the **Mobile Advertising ID** field must also be correct. By default, it'll be configured as follows when the Mapping is created. + +![Image showing default field mapping for Mobile Advertising ID field](images/field_mapping_default.png). Again, note the underscores for `android_idfa` and `ios_idfa`. + +#### Why can't I select our Ads Account during the destination setup? + +Ensure the following criteria are met: + +- Your personal Snapchat login has appropriate permissions within your business. Snapchat Account Admin or Data Manager permissions are required to configure and add audiences. +- Your Snap Ads account is in `Active` status. + +#### How do I view the sync status? + +The status is shown in the Event Delivery tool. When you view the audience, open the side bar which directs you to [Event Delivery](/docs/getting-started/06-testing-debugging/#event-delivery).