Setup guide for StackAdapt audience destination #7221

Vanessa-SSY · 2024-11-13T07:23:42Z

Proposed changes

Adding setup guide for StackAdapt audience destination

Merge timing

Related issues (optional)

seg-atlantis-prod · 2024-11-13T07:23:44Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-13T07:23:47Z

Error parsing command: EOF found when expecting closing quote

…stination

seg-atlantis-prod · 2024-11-13T07:25:40Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-13T07:25:43Z

Error parsing command: EOF found when expecting closing quote

netlify · 2024-11-13T07:29:22Z

✅ Deploy Preview for segment-docs ready!

Name	Link
🔨 Latest commit	`1febc97`
🔍 Latest deploy log	https://app.netlify.com/sites/segment-docs/deploys/67345400f64a1b0008310405
😎 Deploy Preview	https://deploy-preview-7221--segment-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

seg-atlantis-prod · 2024-11-14T17:42:03Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-14T17:42:07Z

Error parsing command: EOF found when expecting closing quote

seg-atlantis-prod · 2024-11-14T17:42:45Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-14T17:42:47Z

Error parsing command: EOF found when expecting closing quote

seg-atlantis-prod · 2024-11-14T17:44:23Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-14T17:44:25Z

Error parsing command: EOF found when expecting closing quote

Vanessa-SSY · 2024-11-14T17:45:09Z

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

@@ -3,15 +3,14 @@ title: StackAdapt Destination
 hide-boilerplate: true


All changes in this files are result of auto-linter on save

Vanessa-SSY · 2024-11-14T17:45:51Z

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

+hide-boilerplate: true
+hide-dossier: true
+beta: true
+# id: 61d8859be4f795335d5c677c


Not sure what this ID should be 🤔

That's OK the Docs team will fix that.

@tcgilbert any insight on what the destination's ID should be?

hi @forstisabella the ID is 66e96b9f4ee97f41caa06487

joe-ayoub-segment · 2024-11-18T18:20:35Z

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

+
+If you do not have an API key, reach out to the StackAdapt team for help.
+
+### Setting up the StackAdapt Audience destination in Segment Engage


Note for Docs team reviewer.

This Destination has 2 Actions.

Forward Profile - this is basically a Connections Action which sends user profile data to Stackadapt. This Action can be used with Connections Source.

Forward Audience Event - this syncs Engage Audiences to Stackadapt. This Action can only be used with Engage Audiences.

I'm thinking that might need some specific wording to explain that this Destination the different use-cases for each of these Actions, the different Sources for each (Connections Vs Engage Audience), and the different setup steps for each.

Is this something you can edit into this PR? Or would you like assistance from me or @Vanessa-SSY ?

I'd need the id for both actions to add a specific note to the autogenerated Available Actions section of this page. Do you happen to know the id for both actions @joe-ayoub-segment?

Hi @forstisabella :

Forward Audience Event = dkwweyGfhoSh7jWwSi9n4D
Forward Profile = 8mmGRhHeA8F2fzwNXVymNF

Hi @joe-ayoub-segment & @Vanessa-SSY: I opened a pull request to add in notes for each action. Please approve and merge when you have a minute!

StackAdapt#2

@forstisabella Thanks! Approved

seg-atlantis-prod · 2024-11-18T23:04:07Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-18T23:04:10Z

Error parsing command: EOF found when expecting closing quote

forstisabella · 2024-11-21T01:15:42Z

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

+hide-boilerplate: true
+hide-dossier: true
+beta: true
+# id: 61d8859be4f795335d5c677c


@tcgilbert any insight on what the destination's ID should be?

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

forstisabella · 2024-11-21T01:15:47Z

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

+beta: true
+# id: 61d8859be4f795335d5c677c
+hidden: true
+redirect_from: "/connections/destinations/catalog/actions-stackadapt/"


When you navigate to segment.com/docs/connections/destinations/catalog/actions-stackadapt/, it redirects to the existing StackAdapt destination. Was that behavior intentional?

Suggested change

redirect_from: "/connections/destinations/catalog/actions-stackadapt/"

The slug for this new Stackadapt Audience Destination is separate to the actions-stackadapt Destination.
The Stackadapt Audience Destination slug is: actions-stackadapt-audiences

okay great, then we should remove this line!

forstisabella · 2024-11-21T01:15:49Z

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

+
+{% 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 Segment Engage helps you sync user data to optimize targeting and improve your campaign outcomes.


Suggested change

[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 Segment Engage helps you sync user data to optimize targeting and improve your campaign outcomes.

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

forstisabella · 2024-11-21T01:15:54Z

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

+
+[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 Segment 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 StackAdapt's support team](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="\_blank"}.


Suggested change

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"}.

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"}.

forstisabella · 2024-11-21T01:17:09Z

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

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


Suggested change

4. Click Save.

4. Click **Save**.

forstisabella · 2024-11-21T01:17:11Z

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

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


Suggested change

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.

forstisabella · 2024-11-21T01:17:13Z

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


+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"}.


Suggested change

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"}.

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"}.

forstisabella · 2024-11-21T01:17:16Z

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

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


Suggested change

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.

forstisabella · 2024-11-21T01:18:22Z

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

+
+If you do not have an API key, reach out to the StackAdapt team for help.
+
+### Setting up the StackAdapt Audience destination in Segment Engage


I'd need the id for both actions to add a specific note to the autogenerated Available Actions section of this page. Do you happen to know the id for both actions @joe-ayoub-segment?

forstisabella · 2024-11-21T14:05:25Z

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

+hide-boilerplate: true
+hide-dossier: true
+beta: true
+# id: 61d8859be4f795335d5c677c


Suggested change

# id: 61d8859be4f795335d5c677c

id: 66e96b9f4ee97f41caa06487

tcgilbert · 2024-11-25T20:32:33Z

@Vanessa-SSY if you could merge this PR: StackAdapt#2

Then I can approve, and we can proceed with merging on our side.

joe-ayoub-segment · 2024-11-28T12:26:17Z

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

+
+{% 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.


Should it say 'Twilio Engage' or 'Segment Engage' here?

This was changed according to this comment from @forstisabella

joe-ayoub-segment · 2024-11-28T12:27:16Z

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

+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 to connect to the StackAdapt Audience destination.


Should we clarify that the Source should be the Engage Space?

joe-ayoub-segment · 2024-11-28T12:43:12Z

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

+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`. Click **Add Condition** and add this condition: Event Name is `Audience Entered` or `Audience Exited`.


Technically there is no need to mention anything about Audience Entered or Audience Exited. I think it will just confuse the customer.

You could just saw that the Event Name for track() events is irrelevant.

seg-atlantis-prod · 2024-11-28T16:15:36Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-11-28T16:15:40Z

Error parsing command: EOF found when expecting closing quote

joe-ayoub-segment · 2024-11-28T16:18:07Z

hi @forstisabella could you take another look at this PR? It is looking OK to publish?

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

forstisabella · 2024-12-02T17:04:11Z

hi @forstisabella could you take another look at this PR? It is looking OK to publish?

two small changes and we'll be g2g!

…ces/index.md Co-authored-by: forstisabella <[email protected]>

seg-atlantis-prod · 2024-12-02T17:53:13Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-12-02T17:53:16Z

Error parsing command: EOF found when expecting closing quote

…ces/index.md Co-authored-by: forstisabella <[email protected]>

seg-atlantis-prod · 2024-12-02T17:53:39Z

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

seg-atlantis-prod · 2024-12-02T17:53:42Z

Error parsing command: EOF found when expecting closing quote

Vanessa-SSY · 2024-12-02T17:54:12Z

@forstisabella updated!

Vanessa-SSY · 2024-12-03T18:01:16Z

Can someone help merge and deploy this PR?

github-actions · 2024-12-03T19:07:30Z

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.

Vanessa-SSY added 2 commits November 13, 2024 02:21

setup guide for stackadapt audience destination

3accf62

[netlify-build]

1febc97

Vanessa-SSY requested a review from a team as a code owner November 13, 2024 07:23

Vanessa-SSY requested a review from pwseg November 13, 2024 07:23

Merge branch 'develop' into vs/setup-guide-for-stackadapt-audience-de…

d564735

…stination

pwseg requested a review from tcgilbert November 13, 2024 15:24

reset actions-stackadapt-cloud/index.md

16f4240

reset actions-stackadapt-cloud/index.md

65a9990

reset actions-stackadapt-cloud/index.md

be6e8db

Vanessa-SSY commented Nov 14, 2024

View reviewed changes

joe-ayoub-segment reviewed Nov 18, 2024

View reviewed changes

add audience creation on sa platform

e25ea33

forstisabella reviewed Nov 21, 2024

View reviewed changes

forstisabella mentioned this pull request Nov 21, 2024

StackAdapt Audiences notes StackAdapt/segment-docs#2

Merged

Vanessa-SSY requested review from forstisabella and joe-ayoub-segment November 26, 2024 16:03

tcgilbert previously approved these changes Nov 27, 2024

View reviewed changes

joe-ayoub-segment reviewed Nov 28, 2024

View reviewed changes

address joe's comments

c6c8090

Vanessa-SSY dismissed tcgilbert’s stale review via c6c8090 November 28, 2024 16:15

Vanessa-SSY force-pushed the vs/setup-guide-for-stackadapt-audience-destination branch from 2882542 to c6c8090 Compare November 28, 2024 16:15

Vanessa-SSY requested a review from joe-ayoub-segment November 28, 2024 16:16

Vanessa-SSY requested a review from tcgilbert November 29, 2024 16:33

forstisabella reviewed Dec 2, 2024

View reviewed changes

src/connections/destinations/catalog/actions-stackadapt-audiences/index.md Outdated Show resolved Hide resolved

forstisabella reviewed Dec 2, 2024

View reviewed changes

src/connections/destinations/catalog/actions-stackadapt-audiences/index.md Outdated Show resolved Hide resolved

Update src/connections/destinations/catalog/actions-stackadapt-audien…

9b59611

…ces/index.md Co-authored-by: forstisabella <[email protected]>

Update src/connections/destinations/catalog/actions-stackadapt-audien…

19ab7f7

…ces/index.md Co-authored-by: forstisabella <[email protected]>

Vanessa-SSY requested a review from forstisabella December 2, 2024 17:53

forstisabella approved these changes Dec 3, 2024

View reviewed changes

forstisabella merged commit d0f1e15 into segmentio:develop Dec 3, 2024
4 checks passed

forstisabella mentioned this pull request Jan 14, 2025

StackAdapt Audiences destination hotfix #7380

Merged

		@@ -3,15 +3,14 @@ title: StackAdapt Destination
		hide-boilerplate: true


		If you do not have an API key, reach out to the StackAdapt team for help.

		### Setting up the StackAdapt Audience destination in Segment Engage


		{% 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 Segment Engage helps you sync user data to optimize targeting and improve your campaign outcomes.


		[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 Segment 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 StackAdapt's support team](https://support.stackadapt.com/hc/en-us/requests/new?ticket_form_id=360006572593){:target="\_blank"}.


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

Setup guide for StackAdapt audience destination #7221

Setup guide for StackAdapt audience destination #7221

Conversation

Vanessa-SSY commented Nov 13, 2024

Proposed changes

Merge timing

Related issues (optional)

seg-atlantis-prod bot commented Nov 13, 2024

seg-atlantis-prod bot commented Nov 13, 2024

seg-atlantis-prod bot commented Nov 13, 2024

seg-atlantis-prod bot commented Nov 13, 2024

netlify bot commented Nov 13, 2024

✅ Deploy Preview for segment-docs ready!

seg-atlantis-prod bot commented Nov 14, 2024

seg-atlantis-prod bot commented Nov 14, 2024

seg-atlantis-prod bot commented Nov 14, 2024

seg-atlantis-prod bot commented Nov 14, 2024

seg-atlantis-prod bot commented Nov 14, 2024

seg-atlantis-prod bot commented Nov 14, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

seg-atlantis-prod bot commented Nov 18, 2024

seg-atlantis-prod bot commented Nov 18, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

forstisabella Nov 21, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tcgilbert commented Nov 25, 2024

joe-ayoub-segment Nov 28, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

seg-atlantis-prod bot commented Nov 28, 2024

seg-atlantis-prod bot commented Nov 28, 2024

joe-ayoub-segment commented Nov 28, 2024

forstisabella commented Dec 2, 2024

seg-atlantis-prod bot commented Dec 2, 2024

seg-atlantis-prod bot commented Dec 2, 2024

seg-atlantis-prod bot commented Dec 2, 2024

seg-atlantis-prod bot commented Dec 2, 2024

Vanessa-SSY commented Dec 2, 2024

Vanessa-SSY commented Dec 3, 2024

github-actions bot commented Dec 3, 2024

forstisabella Nov 21, 2024 •

edited

Loading

joe-ayoub-segment Nov 28, 2024 •

edited

Loading