Merge pull request #7221 from StackAdapt/vs/setup-guide-for-stackadapt-audience-destination

Setup guide for StackAdapt audience destination

Author: forstisabella

src/connections/destinations/catalog/actions-stackadapt-audiences/images/map-fields-example.png

@@ -0,0 +1,71 @@
+---
+title: StackAdapt Audience Destination
+hide-boilerplate: true
+hide-dossier: true
+beta: true
+id: 66e96b9f4ee97f41caa06487
+hidden: true
+redirect_from: "/connections/destinations/catalog/actions-stackadapt-audiences/"
+---
+
+{% include content/plan-grid.md name="actions" %}
+
+[StackAdapt](https://www.stackadapt.com/){:target="_blank"} is a programmatic advertising platform specializing in audience engagement. StackAdapt enables marketers to deliver high-performing advertising campaigns across channels through real-time bidding, detailed audience targeting, and data-driven insights. StackAdapt’s integration with Twilio Engage helps you sync user data to optimize targeting and improve your campaign outcomes.
+
+This destination is maintained by StackAdapt. For any issues with the destination, please [submit a ticket to StackFAdapt's support team](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="_blank"}.
+
+## Getting started
+
+### Getting your StackAdapt GraphQL Token
+
+If you do not have an existing StackAdapt API key, [reach out to the StackAdapt team for help](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="_blank"}.
+
+### Setting up the StackAdapt Audience destination in Segment Engage
+
+1. From the Segment web app, navigate to **Connections > Catalog > Destinations**.
+2. Search for and select the "StackAdapt Audience" destination.
+3. Click **Add Destination**.
+4. Select an existing source that is Engage Space to connect to the StackAdapt Audience destination.
+5. Enter a name for your destination.
+6. On the Settings screen, provide your StackAdapt GraphQL API token.
+7. Toggle on the destination using the **Enable Destination** toggle.
+8. Click **Save Changes**.
+9. Follow the steps in the Destinations Actions documentation to [customize mappings](/docs/connections/destinations/actions/#customize-mappings) or use the documentation to [sync an Engage Audience](#sync-an-engage-audience).
+10. Enable the destination and click **Save Changes**.
+
+### Sync an Engage Audience
+
+To sync an Engage audience with StackAdapt:
+
+1. Each Engage audience should only contain profiles that have a valid email address. Profiles missing an email address are not valid on StackAdapt's platform.
+2. Add a condition to the Engage audience to ensure the required email trait is included.
+3. Open the previously created StackAdapt Audience destination.
+4. On the Mappings tab, click **New Mapping** and select **Forward Audience Event**.
+5. Under Define event trigger, click **Add Condition** and add this condition: Event Type is `Track` or `Identify`.
+6. Under **Map fields**, select the advertiser you want to sync the audience with. You can identify a specific advertiser by finding its ID in StackAdapt.
+   ![Image showing sample map fields](images/map-fields-example.png)
+
+On StackAdapt platform:
+
+To verify that your audience is syncing with StackAdapt, open StackAdapt and navigate to **Audience & Attribution** > **Customer Data** > **Profiles**. On the Profiles tab, you should be able to see a list of profiles being synced to StackAdapt platform.
+
+> info "Syncs can take up to 4 hours"
+> It can take up to 4 hours from the time you initiate a sync for profiles to show up in StackAdapt.
+
+If you want to create a StackAdapt Audience from your Twilio Engage Audience:
+
+1. Open StackAdapt and navigate to **Audience & Attribution** > **Customer Data** > **Segments**, then click **Create Segment**.
+2. Choose **Segment Engage Audience ID** or **Segment Engage Audience Name** as the rule.
+3. Select the value for the corresponding filter.
+4. Click **Submit** to create the segment.
+
+### Sending an Audience to StackAdapt
+
+1. In Segment, go to Engage > Audiences and select the audience to sync with StackAdapt.
+2. Click **Add Destination** and select **StackAdapt Audience**.
+3. Toggle **Send Track** and **Send Identify** on.
+4. Click **Save**.
+
+## Data and privacy
+
+Review [StackAdapt's Data Processing Agreement](https://www.stackadapt.com/data-processing-agreement){:target="_blank"} to learn more about StackAdapt's privacy and data terms.

src/connections/destinations/catalog/actions-stackadapt-audiences/index.md

@@ -3,15 +3,14 @@ title: StackAdapt Destination
 hide-boilerplate: true
 hide-dossier: true
 id: 61d8859be4f795335d5c677c
-redirect_from: '/connections/destinations/catalog/actions-stackadapt/'
+redirect_from: "/connections/destinations/catalog/actions-stackadapt/"
 ---
 
 {% include content/plan-grid.md name="actions" %}
 
-By setting up StackAdapt as a Segment destination, your Segment events will be forwarded to [StackAdapt](https://www.stackadapt.com/){:target="_blank"}. This allows you to generate retargeting and lookalike audiences, track conversions, and measure return on ad spend using your Segment events - bypassing the need to install the StackAdapt pixel on your website and write code to send events to StackAdapt.
-
-This destination is maintained by StackAdapt. For any issues with the destination, please [submit a ticket to StackAdapt's support team](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="_blank"}.
+By setting up StackAdapt as a Segment destination, your Segment events will be forwarded to [StackAdapt](https://www.stackadapt.com/){:target="\_blank"}. This allows you to generate retargeting and lookalike audiences, track conversions, and measure return on ad spend using your Segment events - bypassing the need to install the StackAdapt pixel on your website and write code to send events to StackAdapt.
 
+This destination is maintained by StackAdapt. For any issues with the destination, please [submit a ticket to StackAdapt's support team](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="\_blank"}.
 
 ## Getting started
 
@@ -20,7 +19,7 @@ This destination is maintained by StackAdapt. For any issues with the destinatio
 1. Log in to your StackAdapt account and navigate to the Pixels page.
 2. Above the list of pixels, click **Install StackAdapt Pixel**.
 
-    ![Image showing location of link to install Pixel](images/install-pixel-link.png)
+   ![Image showing location of link to install Pixel](images/install-pixel-link.png)
 
 3. In the instructions that appear, copy the universal pixel ID from the code snippet. Below is an example of a code snippet where the universal pixel ID is `sqQHa3Ob1hFi__2EcYYVZg1`.
 
@@ -41,9 +40,9 @@ This destination is maintained by StackAdapt. For any issues with the destinatio
 
 Segment events that are forwarded to StackAdapt can be used to track ad conversions, and to generate retargeting and lookalike audiences. Please review the StackAdapt documentation for the general setup of these if you are not already familiar:
 
-- [Creating Conversion Events](https://support.stackadapt.com/hc/en-us/articles/360005859214-Creating-Conversion-Events){:target="_blank"}
-- [Creating Retargeting Audiences](https://support.stackadapt.com/hc/en-us/articles/360005939153-Creating-Retargeting-Audiences){:target="_blank"}
-- [How to Generate and Target a Lookalike Audience](https://support.stackadapt.com/hc/en-us/articles/360023738733-How-to-Generate-and-Target-a-Lookalike-Audience){:target="_blank"}
+- [Creating Conversion Events](https://support.stackadapt.com/hc/en-us/articles/360005859214-Creating-Conversion-Events){:target="\_blank"}
+- [Creating Retargeting Audiences](https://support.stackadapt.com/hc/en-us/articles/360005939153-Creating-Retargeting-Audiences){:target="\_blank"}
+- [How to Generate and Target a Lookalike Audience](https://support.stackadapt.com/hc/en-us/articles/360023738733-How-to-Generate-and-Target-a-Lookalike-Audience){:target="\_blank"}
 
 Setup of conversion events, retargeting audiences, and lookalike audiences that fire on Segment events is largely the same as the setup in the StackAdapt documentation, with a few caveats:
 
@@ -64,7 +63,7 @@ A Segment event fired with the code `analytics.track("User Registered")` can be
 The StackAdapt destination also supports forwarding ecommerce fields for the purpose of creating event rules that match ecommerce events, with default mappings to properties specified in the [Segment V2 Ecommerce Event Spec](/docs/connections/spec/ecommerce/v2/) as described in the below table:
 
 | Segment Ecommerce Event Property | StackAdapt Event Key |
-|----------------------------------|----------------------|
+| -------------------------------- | -------------------- |
 | `order_id`                       | `order_id`           |
 | `revenue`                        | `revenue`            |
 | `product_id`                     | `product_id`         |
@@ -76,7 +75,7 @@ The StackAdapt destination also supports forwarding ecommerce fields for the pur
 For events that can involve multiple products, such as checkout events, StackAdapt forwards a JSON array of product objects with a `products` key and fields that map by default to following Segment product array fields:
 
 | Segment Ecommerce Event Property | StackAdapt Product Object Key |
-|----------------------------------|-------------------------------|
+| -------------------------------- | ----------------------------- |
 | `products.$.product_id`          | `product_id`                  |
 | `products.$.category`            | `product_category`            |
 | `products.$.name`                | `product_name`                |
@@ -110,7 +109,7 @@ analytics.track('Order Completed', {
 Although trait fields are not frequently used in event rules, the StackAdapt destination forwards them and they can be used if desired.
 
 | Segment Trait Property | StackAdapt Event Key |
-|------------------------|----------------------|
+| ---------------------- | -------------------- |
 | `traits.email`         | `email`              |
 | `traits.first_name`    | `first_name`         |
 | `traits.last_name`     | `last_name`          |
@@ -123,13 +122,13 @@ For example, to create a conversion event when a user with the domain `example.c
 This rule would match a Segment event fired with code such as:
 
 ```javascript
-analytics.track('Order Completed', {
-  order_id: '50314b8e9bcf000000000000',
+analytics.track("Order Completed", {
+  order_id: "50314b8e9bcf000000000000",
   traits: {
-    email: '[email protected]',
-    first_name: 'John',
-    last_name: 'Smith',
-    phone: '+180055501000'
+    email: "[email protected]",
+    first_name: "John",
+    last_name: "Smith",
+    phone: "+180055501000"
   }
 });
 ```
@@ -167,4 +166,4 @@ When forwarding past events using Reverse ETL, only users who have interacted wi
 
 ## Data and privacy
 
-Review [StackAdapt's Data Processing Agreement](https://www.stackadapt.com/data-processing-agreement){:target="_blank"} to learn more about StackAdapt's privacy and data terms.
+Review [StackAdapt's Data Processing Agreement](https://www.stackadapt.com/data-processing-agreement){:target="\_blank"} to learn more about StackAdapt's privacy and data terms.