Skip to content

Release 24.34.2 #6975

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 44 commits into from
Aug 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
0943ef3
add first documentation page for destination dynamic yield by masterc…
djluis Aug 13, 2024
58e42c3
Apply suggestions from code review
djluis Aug 16, 2024
186dd37
Update src/connections/destinations/catalog/actions-dynamic-yield-aud…
djluis Aug 16, 2024
a72abdb
Update index.md numbers
djluis Aug 16, 2024
7fa1887
fix typos
pwseg Aug 17, 2024
0726a8f
Update src/connections/destinations/catalog/actions-dynamic-yield-aud…
djluis Aug 19, 2024
9639ca0
Update src/connections/destinations/catalog/actions-dynamic-yield-aud…
djluis Aug 19, 2024
031d859
Update src/connections/destinations/catalog/actions-dynamic-yield-aud…
djluis Aug 19, 2024
e9926ab
Update src/connections/destinations/catalog/actions-dynamic-yield-aud…
djluis Aug 19, 2024
24293e0
getting the ball rolling take 2
pwseg Aug 20, 2024
322b245
Update data-graph.md
kly-segment Aug 20, 2024
03fafef
Filter conditions are case sensitive.md
estgc Aug 21, 2024
acadc47
Add details about content_id mapping
vanand17 Aug 21, 2024
3a788c4
remove duplicate content from http api source page
terence1988 Aug 21, 2024
2ddc11a
Merge pull request #6949 from segmentio/fix-use-cases-typo
pwseg Aug 21, 2024
482cc18
Update faqs.md
dineshraj-arunmozhi Aug 22, 2024
51afaf3
relative link fix
pwseg Aug 22, 2024
6cbfb87
Merge pull request #6967 from segmentio/dineshraj-arunmozhi-patch-1
pwseg Aug 22, 2024
0b39e19
Update src/connections/destinations/catalog/facebook-pixel/index.md
forstisabella Aug 22, 2024
8fe73c3
Merge pull request #6964 from segmentio/vanand17-patch-12
forstisabella Aug 22, 2024
f97a6ba
Apply suggestions from code review
stayseesong Aug 22, 2024
2e141b6
some fixes
pwseg Aug 22, 2024
a66a3b2
fix table and remove outdated frontmatteer
pwseg Aug 22, 2024
3192a15
Merge pull request #6963 from segmentio/estgc-patch-5
stayseesong Aug 22, 2024
642211c
ugh
pwseg Aug 22, 2024
eefe899
Merge pull request #6935 from djluis/dynamic-yield-audiences-destinat…
forstisabella Aug 22, 2024
c224acd
more cleanup
pwseg Aug 22, 2024
9b05ea2
add callout about supported destinations
pwseg Aug 22, 2024
447c0f2
update intro and fix links [netlify-build]
pwseg Aug 22, 2024
f26da8c
missing a bullet point in the ul
forstisabella Aug 22, 2024
a99ad50
catalog update
pwseg Aug 22, 2024
84209b0
Merge pull request #6969 from segmentio/catalog_update_082224
pwseg Aug 22, 2024
2f12b53
Merge pull request #6971 from segmentio/consent-rn-hotfix
forstisabella Aug 22, 2024
08b9179
hide inkit docs
Aug 22, 2024
4f7db9f
Add Linked Audiences pages to sidenav
pwseg Aug 22, 2024
cf47e3c
oops
pwseg Aug 22, 2024
48ab874
edits
stayseesong Aug 22, 2024
99842d2
Merge pull request #6966 from segmentio/remove-duplicate-content-from…
stayseesong Aug 22, 2024
0c92f95
Merge pull request #6972 from segmentio/thomas/inkit
forstisabella Aug 22, 2024
121b21e
move Data Graph page
pwseg Aug 22, 2024
0d38f30
Merge pull request #6956 from segmentio/data-graph-ga
pwseg Aug 22, 2024
d09bd43
Merge pull request #6973 from segmentio/linked-audiences-sidenav
pwseg Aug 22, 2024
634b1f5
fix typo
pwseg Aug 22, 2024
90adb66
Merge pull request #6968 from segmentio/la-activation-updates
pwseg Aug 22, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/_data/catalog/destination_categories.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination categories last updated 2024-08-20
# destination categories last updated 2024-08-22
items:
- display_name: A/B Testing
slug: a-b-testing
Expand Down
2 changes: 1 addition & 1 deletion src/_data/catalog/destinations.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination data last updated 2024-08-20
# destination data last updated 2024-08-22
items:
- id: 637e8d185e2dec264895ea89
display_name: 1Flow
Expand Down
2 changes: 1 addition & 1 deletion src/_data/catalog/destinations_private.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination data last updated 2024-08-20
# destination data last updated 2024-08-22
items:
- id: 54521fd925e721e32a72eee1
display_name: Pardot
Expand Down
2 changes: 1 addition & 1 deletion src/_data/catalog/source_categories.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# source categories last updated 2024-08-20
# source categories last updated 2024-08-22
items:
- display_name: A/B Testing
slug: a-b-testing
Expand Down
2 changes: 1 addition & 1 deletion src/_data/catalog/sources.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# sources last updated 2024-08-20
# sources last updated 2024-08-22
items:
- id: 8HWbgPTt3k
display_name: .NET
Expand Down
14 changes: 14 additions & 0 deletions src/_data/sidenav/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -339,6 +339,18 @@ sections:
title: Sample Queries
- path: /unify/profiles-sync/tables
title: Tables & Materialized Views
- section_title: Data Graph
slug: unify/data-graph
section:
- path: /unify/data-graph/
title: Data Graph
- section_title: Setup Guides
slug: /unify/data-graph/setup-guides/
section:
- path: /unify/data-graph/setup-guides/snowflake-setup/
title: Snowflake Setup
- path: /unify/data-graph/setup-guides/databricks-setup/
title: Databricks Setup
- section_title: Traits
slug: unify/traits
section:
Expand Down Expand Up @@ -409,6 +421,8 @@ sections:
section:
- path: '/engage/audiences'
title: Audiences Overview
- path: '/engage/audiences/linked-audiences'
title: Linked Audiences
- path: '/engage/audiences/account-audiences'
title: Account-level Audiences
- path: '/engage/audiences/generative-audiences'
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
title: Dynamic Yield By Mastercard Audiences Destination
id: 64ede9fe67158afa8de61480
engage: true
beta: true
---

{% include content/plan-grid.md name=actions %}

[Dynamic Yield by Mastercard](https://www.dynamicyield.com/){:target="_blank”} helps businesses deliver digital customer experiences that are personalized, optimized, and synchronized.
With Dynamic Yield’s Experience OS, you can algorithmically match content, products, and offers to each individual customer to increase revenue, build customer loyalty, and gain a sustainable competitive advantage.

This destination is maintained by Dynamic Yield by Mastercard. For any issues with the destination, [contact the Dynamic Yield support team](mailto:[email protected]).

## Getting started

**Dynamic Yield by Mastercard Audiences** is an Audience Destination which must be first connected to an Engage Space before it can be connected to individual Engage Audiences. The steps below outline how to connect the Destination to an Engage Space and then to an Audience.

### Create an instance of the Dynamic Yield Destination

1. From your Segment workspace, navigate to **Connections > Catalog**.
2. Use the search field to find the **Dynamic Yield by Mastercard Audiences** Destination, then select it.
3. Click **Add destination**.
4. Select the Engage Space you'd like to connect your destination to and click **Next**.
5. Enter a name for your destination and click **Create destination**.

### Configuring Basic Settings
1. Provide the Section ID and Connection Key on the Settings tab for your Dynamic Yield by Mastercard destination.
2. Enable the Destination using the toggle, then click the **Save changes** button.


### Create and configure a Mapping
You must first create, configure, and enable a Mapping before connecting your Audiences to the Dynamic Yield by Mastercard destination.

1. Navigate to the Mappings tab in the Dynamic Yield by Mastercard Destination.
2. Click **New Mapping** and select the **Sync Audience Action**.
3. Ensure that the only condition to trigger the mapping is **Event Type is Track** (remove the **Event Type is Identify** condition, if present).
4. Click **Save**.
5. Enable the Mapping from the Mappings tab using the **Status** toggle.

Once these steps have been completed you can connect Audiences to the Destination.

### Connecting Audiences to the Dynamic Yield by Mastercard Destination

1. Navigate to your **Engage Space > Audiences**.
2. Select the Audience you'd like to sync to your Dynamic Yield by Mastercard Audiences destination.
3. Click **+ Add destination**, select the **Dynamic Yield by Mastercard Audiences** Destination you connected earlier, and click **Add Destination**.
4. On the Audience Settings panel, provide a value for the following fields:
- **Audience Name**: The name Segment uses when creating the Audience in Dynamic Yield.
- **Identifier Type**: Select `userid`, `anonymousid`, or `email`. * See [Customized Identifier Setup](#customized-identifier-setup) for how to configure identifiers other than userid, email or anonymousid.
5. Enable the **Send Track** toggle. You don't need to change the **Enter Event** or **Exit Event** fields, as these are not used by this Destination.
6. Click **Default Setup** panel under **Event settings**.
7. Click **Save** and then click **Add Destination**.

The Destination is now connected to your Audience and starts syncing data to Dynamic Yield.


### Customized Identifier Setup
The Dynamic Yield Audience Destination can accept identifiers other than userId, anonymousId or email. However, this requires some additional configuration steps when connecting the Audience to your Dynamic Yield Audiences Destination.

1. When connecting your Audience to the **Dynamic Yield Audiences** Destination, select the **Customized Setup** panel under **Event Settings**.
2. Click**Add identifier** then select the identifier type you'd like to use.
3. Provide a name for the identifier in the **Identifier in destination** field.
4. Scroll back up to the top of the Audience Settings panel and ensure that the **Identifier Type** field contains the name of the identifier you configured in the Customized Setup panel.
5. Click **Save** and then click **Add Destination** button.

The Destination is now connected to your Audience and starts syncing data to Dynamic Yield with the specified custom identifier.

{% include components/actions-fields.html %}
Original file line number Diff line number Diff line change
Expand Up @@ -193,6 +193,8 @@ If you're using real estate, travel, or automotive [Dynamic Ads](https://www.fac

For most implementations, Segment recommends leaving these mappings blank. By default, Segment sets `content_type` to "product".

The same mapping can be used to change the `content_id` from the default value (product_id or the sku) to anything specific for Meta Pixel. For more information about required Meta Pixel events, see Meta's [Required Meta Pixel events and parameters for Advantage+ catalog ads](https://www.facebook.com/business/help/606577526529702?id=1205376682832142){:target="_blank”} documentation.

## Troubleshooting

### PII blocklisting
Expand Down
2 changes: 2 additions & 0 deletions src/connections/destinations/catalog/inkit/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,9 @@
title: Inkit Destination
rewrite: true
id: 5f0746ced1c79b49ddee49fd
hidden: true
---

[Inkit](https://inkit.com){:target="_blank"} and Segment empower organizations to securely generate and distribute documents - both digitally as well as through direct mail.
For example, automatically create and send electronic documents like invoices, reports, notices, and more through a magic link or e-delivery. Or generate and send documents for e-signature, storage, postcards, letters, and more, all powered by the Inkit integration for Segment.

Expand Down
4 changes: 4 additions & 0 deletions src/connections/destinations/destination-filters.md
Original file line number Diff line number Diff line change
Expand Up @@ -259,3 +259,7 @@ When Segment sends an event to a destination but encounters a timeout error, it
#### How do destination filters handle Protocols Transformations?
- **Source-Scoped Transformations**: If destination filters are enabled, Segment processes [source scoped transformations](/docs/protocols/transform/#step-2-set-up-the-transformation) before the events reach destination filters.
- **Destination-Scoped Transformations**: Segment processes [destination-specific transformations](/docs/protocols/transform/#step-2-set-up-the-transformation) after the events have passed through the destination filters.

#### Are destination filter conditions case-sensitive?

Destination filters are case-sensitive. Make sure to test your filter conditions with a test event before saving and enabling the filter.
Original file line number Diff line number Diff line change
Expand Up @@ -74,19 +74,6 @@ You can reuse the access token until the expiry period specified on the OAuth ap

To send data to Segment's HTTP API, a content-type header must be set to `'application/json'`.

## Errors

Segment returns a `200` response for all API requests except errors caused by large payloads and JSON errors (which return `400` responses.) To debug events that return `200` responses but aren't accepted by Segment, use the Segment Debugger.

Common reasons events are not accepted by Segment include:
- **Payload is too large:** The HTTP API can handle API requests that are 32KB or smaller. The batch API endpoint accepts a maximum of 500KB per request, with a limit of 32KB per event in the batch. If these limits are exceeded, Segment returns a 400 Bad Request error.
- **Identifier is not present**: The HTTP API requires that each payload has a userId and/or anonymousId.
- **Track event is missing name**: All Track events sent to Segment must have an `event` field.
- **Deduplication**: Segment deduplicates events using the `messageId` field, which is automatically added to all payloads coming into Segment. If you're setting up the HTTP API yourself, ensure all events have unique messageId values with fewer than 100 characters.
- **Invalid JSON**: If you send an event with invalid JSON, Segment returns a 400 Bad Request error.

Segment welcomes feedback on API responses and error messages. [Reach out to support](https://segment.com/help/contact/){:target="_blank"} with any requests or suggestions you may have.

## Rate limits

For each workspace, Segment recommends you to not exceed 1,000 requests per second with the HTTP API. If you exceed this, Segment reserves the right to queue any additional events and process those at a rate that doesn't exceed the limit. Requests that exceed acceptable limits may be rejected with HTTP Status Code 429. When Segment rejects the requests, the response header contains `Retry-After` and `X-RateLimit-Reset` headers, which contains the number of seconds after which you can retry the request.
Expand Down Expand Up @@ -470,16 +457,26 @@ Destination flags are **case sensitive** and match [the destination's name in th

When sending a HTTP call from a user's device, you can collect the IP address by setting `context.direct` to `true`.

## Troubleshooting
## Errors

Segment returns a `200` response for all API requests except errors caused by large payloads and JSON errors (which return `400` responses.) To debug events that return `200` responses but aren't accepted by Segment, use the Segment Debugger.

Common reasons events are not accepted by Segment include:
- **Payload is too large:** The HTTP API can handle API requests that are 32KB or smaller. The batch API endpoint accepts a maximum of 500KB per request, with a limit of 32KB per event in the batch. If these limits are exceeded, Segment returns a 400 Bad Request error.
- **Identifier is not present**: The HTTP API requires that each payload has a userId and/or anonymousId. If you send events without either the userId or anonymousId, Segment’s tracking API responds with an no_user_anon_id error. Check the event payload and client instrumentation for more details.
- **Track event is missing name**: All Track events sent to Segment must have an `event` field.
- **Deduplication**: Segment deduplicates events using the `messageId` field, which is automatically added to all payloads coming into Segment. If you're setting up the HTTP API yourself, ensure all events have unique messageId values with fewer than 100 characters.
- **Invalid JSON**: If you send an event with invalid JSON, Segment returns a 400 Bad Request error.
- **Incorrect credentials**: Double check your credentials for your downstream destinations.
- **Destination incompatibility**: Make sure that the destination you are troubleshooting can accept server-side API calls. You can see compatibility information on the [Destination comparison by category](/docs/connections/destinations/category-compare/) page and in the documentation for your specific destination.
- **Destination-specific requirements**: Check the documentation specific to the destination to see if there are other requirements for using the method and destination that you're trying to get working.

{% include content/troubleshooting-intro.md %}
Segment welcomes feedback on API responses and error messages. [Reach out to support](https://segment.com/help/contact/){:target="_blank"} with any requests or suggestions you may have.

<!-- LR: no quickstart for this file. removing this include and manually putting in a flat text version that can be customized {% include content/troubleshooting-server-debugger.md %} -->
## Troubleshooting

### No events in my debugger

1. Double check that you've set up the library correctly.

2. Make sure that you're calling a Segment API method after the library is successfully installed—[Identify](#identify), [Track](#track), and so on.

{% include content/server-side-troubleshooting.md %}
Loading
Loading