Skip to content

Commit bcf5991

Browse files
Merge pull request #2799 from segmentio/develop
Release 22.17.1
2 parents fa56651 + 17b8a61 commit bcf5991

File tree

21 files changed

+334
-208
lines changed

21 files changed

+334
-208
lines changed

.github/release.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ changelog:
1717
- new-integration
1818
- title: Improvements
1919
labels:
20-
- enhancement
20+
- content-update
2121
- title: Fixes
2222
labels:
2323
- fixed-content
+18
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{% assign versions = page.versions %}
2+
3+
<div class="premonition info">
4+
<div class="fa fa-info-circle"></div>
5+
<div class="content">
6+
<p class="header">Additional versions of this destination are available</p>
7+
<p>This page is about the {{page.title}}. See below for information about other versions of the {{page.title | split: " " | first}} destination:
8+
<ul>
9+
{% for version in versions%}
10+
<li><a href="{{version.link}}">{{version.name}}</a></li>
11+
12+
{% endfor %}
13+
</ul>
14+
</p>
15+
16+
17+
</div>
18+
</div>

src/_layouts/destination.html

+5-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,11 @@
1010
{{destination-dossier | markdownify}}
1111

1212
{% endif %}
13-
13+
14+
{% if page.versions %}
15+
{% include content/actions-classic.md %}
16+
17+
{% endif %}
1418

1519

1620
{% if page.maintenance == true %}

src/connections/destinations/catalog/actions-adobe-target-cloud/index.md

+12-10
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22
title: Adobe Target Cloud Mode Destination
33
hide-boilerplate: true
44
hide-dossier: false
5-
hidden: true
6-
beta: true
5+
strat: adobe
76
id: 61aa712b857e8c85c3b5a849
87
---
98
Adobe Target is the A/B testing and personalization component of Adobe Experience Cloud. Segment’s Adobe Target integration enables customers to send data from Segment to Adobe Target to create and update user profiles. You can leverage these profiles in Adobe Target to construct audiences and personalize onsite visitor experiences.
@@ -12,8 +11,11 @@ Segment offers two destinations for Adobe Target:
1211
- [Adobe Target Web](/docs/connections/destinations/catalog/actions-adobe-target-web/)
1312
- [Adobe Target Cloud Mode](/docs/connections/destinations/catalog/actions-adobe-target-cloud/)
1413

15-
> success ""
16-
> **Good to know**: This page is about Segment's Adobe Target Cloud Mode destination. There's also a page about Segment's [Adobe Target Web destination](/docs/connections/destinations/catalog/actions-adobe-target-web/). **In order to use Adobe Target Cloud Mode, you must have a parallel web integration with Adobe Target as profiles can only be created by the Adobe Target `at.js` web script.**
14+
> info ""
15+
> The Adobe Target Cloud Mode destination is in beta and is in active development. Some functionality may change before it becomes generally available.
16+
17+
> success "Good to know"
18+
> This page is about Segment's Adobe Target Cloud Mode destination. There's also a page about Segment's [Adobe Target Web destination](/docs/connections/destinations/catalog/actions-adobe-target-web/). **In order to use Adobe Target Cloud Mode, you must have a parallel web integration with Adobe Target as profiles can only be created by the Adobe Target `at.js` web script.**
1719
1820
## Getting started
1921

@@ -53,10 +55,10 @@ This scenario assumes that your users authenticate and have a `userId` upon arri
5355
If the same known user visits on a different device, assuming they authenticate immediately, they will have the same `userId` and therefore the same `mbox3rdPartyId`. This means you can target known users across devices.
5456

5557
#### Scenario 3. Anonymous user becomes a known user.
56-
When an anonymous user first arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`. However, once the user is identified, they will be assigned a new `mbox3rdPartyId` equal to the Segment `userId`. There will be two profiles in Adobe Target; both will be available for targeting.
58+
When an anonymous user arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`. However, once the user is identified, they will be assigned a new `mbox3rdPartyId` equal to the Segment `userId`. There will be two profiles in Adobe Target; both will be available for targeting.
5759

5860
### How to use Adobe Target with Personas
59-
Adobe Target Cloud Mode operates as an [Event Destination](/docs/personas/using-personas-data/#personas-destination-types-event-vs-list/). This means Personas sends computed traits and audiences as traits in `identify` calls or properties in `track` calls. Please see [this example](/docs/personas/using-personas-data/#audience-generated-events/) of the payload Personas would send to Adobe Target.
61+
Adobe Target Cloud Mode operates as an [Event Destination](/docs/personas/using-personas-data/#personas-destination-types-event-vs-list). This means Personas sends computed traits and audiences as traits in `identify` calls or properties in `track` calls. Please see [this example](/docs/personas/using-personas-data/#what-do-the-payloads-look-like-for-personas-data) of the payload Personas would send to Adobe Target.
6062

6163
When you connect Adobe Target Cloud Mode to a Personas space, you will need to set up a mapping for Update Profile. Within the Update Profile mapping, please ensure you have something mapped to Profile Attributes. If you plan to send multiple Personas computed traits and/or audiences to Adobe Target, you can click **Edit Object** and set Profile Attributes to the entire `traits` object. This ensures any audience Personas generates sends to Adobe Target.
6264

@@ -68,15 +70,15 @@ You can use Profile Attributes in the Adobe Target Audience builder to construct
6870
## Viewing Segment data in Adobe Target
6971
To view and use your Segment data in Adobe Target, navigate to **Adobe Target > Audiences > Create Audience > Add Rule**.
7072

71-
- Profile Attributes appear under the **Visitor Profile** attributes.
73+
- Profile Attributes appear under **Visitor Profile** attributes.
7274
- Page Parameters appear under **Custom** attributes. Fields have `page.` prepended to the key.
7375

74-
Audiences can then be used in Adobe Target Activities, such as A/B Testing and Experience Targeting. Please note that while Standard and Premium Adobe Target packages allow access to the SDK and API, certain personalization functionality may only be available with Adobe Target Premium.
76+
Adobe Target Audiences can be used in Activities, such as A/B Testing and Experience Targeting. Please note that while Standard and Premium Adobe Target packages allow access to the SDK and API, certain personalization functionality may only be available with Adobe Target Premium.
7577

7678
## FAQ
7779
### Why am I getting a `Profile Not Found` error?
78-
The Adobe Target API can only be used for profile updates. Profiles must be created on the web first, either using Segment’s [Adobe Target Web destination](/docs/connections/destinations/catalog/actions-adobe-target-web/) or a native implementation of `at.js`. Please ensure you are creating profiles via `at.js` first.
80+
The Adobe Target API can only be used for profile updates. You must first create profiles on the web by using either Segment’s [Adobe Target Web destination](/docs/connections/destinations/catalog/actions-adobe-target-web/) or a native implementation of `at.js`. Please ensure you create profiles on the web first.
7981

80-
Segment’s Adobe Target Web destination sends data in realtime, but it may take up to 1-hour for a user to be available via the Adobe Target API. This means you may see delivery errors for `Profile Not Found` in Adobe Target Cloud until the profile is available for API updates.
82+
Segment’s Adobe Target Web destination sends data in realtime, but it may take up to 1-hour for a user to be available via the Adobe Target API. This means you may see delivery errors for `Profile Not Found` in Adobe Target Cloud Mode until the profile is available for API updates.
8183

8284
In addition, Adobe Target visitor profiles expire after 14 days. [Profile lifetime](https://experienceleague.adobe.com/docs/target/using/audiences/visitor-profiles/visitor-profile-lifetime.html){:target="_blank"} could be another reason a profile is not found.

src/connections/destinations/catalog/actions-adobe-target-web/index.md

+22-20
Original file line numberDiff line numberDiff line change
@@ -2,66 +2,68 @@
22
title: Adobe Target Web Destination
33
hide-boilerplate: true
44
hide-dossier: false
5-
hidden: true
6-
beta: true
5+
strat: adobe
76
id: 61fc2ffcc76fb3e73d85c89d
87
---
9-
Adobe Target is a personalization solution that makes it easy to identify your best content through tests that are easy to execute. So you can deliver the right experience to the right customer. When you have Segment installed, you can make efficient use of your existing tracking implementation by using Segment to fulfill your data collection needs across all your tools that integrate with Segment, including Adobe Target.
8+
Adobe Target is the A/B testing and personalization component of Adobe Experience Cloud. Segment’s Adobe Target integration enables customers to send data from Segment to Adobe Target to create and update user profiles. You can leverage these profiles in Adobe Target to construct audiences and personalize onsite visitor experiences.
109

1110
Segment offers two destinations for Adobe Target:
1211
- [Adobe Target Web](/docs/connections/destinations/catalog/actions-adobe-target-web/)
1312
- [Adobe Target Cloud Mode](/docs/connections/destinations/catalog/actions-adobe-target-cloud/)
1413

15-
> success ""
16-
> **Good to know**: This page is about Segment's Adobe Target Web destination. There's also a page about Segment's [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/).
14+
> info ""
15+
> The Adobe Target Web destination is in beta and is in active development. Some functionality may change before it becomes generally available.
16+
17+
> success "Good to know"
18+
> This page is about Segment's Adobe Target Web destination. There's also a page about Segment's [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/).
1719
1820
## Getting started
1921

2022
The Adobe Target Web destination loads Adobe's `at.js` script for you in order to upsert user profiles, trigger views and track events.
2123

2224
1. From the Segment web app, click **Catalog**, then click **Destinations**.
23-
2. Search for "Adobe Target Web" in the Destinations Catalog, and select the destination.
25+
2. Search for **Adobe Target Web** in the Destinations Catalog, and select the destination.
2426
3. Click **Configure Adobe Target Web** in the top-right corner of the screen.
2527
4. Select the web source that will send data to Adobe Target Web and follow the steps to name your destination. The web source chosen must use [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/).
2628
5. On the **Settings** tab, input your Adobe Target destination settings.
2729
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
28-
7. Enable the Destination and configured Mappings.
30+
7. Enable the destination and configured mappings.
2931

3032
{% include components/actions-fields.html %}
3133

3234
## Relationship between Adobe Target Web and Adobe Target Cloud Mode
3335

3436
Adobe Target is unique because you must have a web integration with Adobe Target in order to utilize the Target server-side API for profile updates. This is because Adobe Target only allows creation of user profiles via client-side web.
3537

36-
To support this, we provide an Adobe Target Web destination for user profile creation, updates, and page/event tracking and an [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/) for additional profile updates. The cloud mode destination is especially useful if you would like to send Personas data to Adobe Target as profile parameters.
38+
To support this, Segment provides an Adobe Target Web destination for user profile creation, updates, and page/event tracking and an [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/) for additional profile updates. The cloud mode destination is useful if you would like to send Personas data to Adobe Target as profile parameters.
3739

3840
### How does it work?
39-
Adobe Target’s `at.js` script identifies each visitor uniquely through a `PCID`, which is auto-generated in the visitor’s cookies. Since we do not expect you to pass the `PCID` to Segment, Segment will update profiles using the `mbox3rdPartyId`.
41+
Adobe Target’s `at.js` script identifies each visitor uniquely through a `PCID`, which is auto-generated in the visitor’s cookies. Since Segment doesn't expect you to include the `PCID` on your Segment events, Segment updates profiles using the `mbox3rdPartyId` instead.
4042

41-
Segment recommends setting the `mbox3rdPartyId` to `userId` (falling back on `anonymousId`) and we set this as the default for your implementation. This allows for a common identifier that can be used to tie server-side data back to the original profile that was created on the web.
43+
Segment recommends setting the `mbox3rdPartyId` to `userId` (falling back on `anonymousId`) and sets this as the default for your implementation. This allows for a common identifier that can be used to tie server-side data back to the original profile that was created on the web.
4244

43-
Depending on your users’ typical journey, a few scenarios can occur when using web and cloud mode together.
45+
Depending on your user's typical journey, a few scenarios can occur when using web and cloud mode together.
4446

45-
#### Scenario 1. Anonymous user always, never becomes known.
46-
When the user arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`.
47+
#### Scenario 1. Anonymous user never becomes known.
48+
When an anonymous user arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`.
4749

48-
If the same user visits on a different device, they will have a new `anonymousId` and therefore a different `mbox3rdPartyId`, and a separate Adobe Target profile will be created. This is in line with how Adobe’s `PCID` behavior works too.
50+
If the same anonymous user visits on a different device, they will have a new `anonymousId` and therefore a different `mbox3rdPartyId`, and a separate Adobe Target profile will be created. This is in line with how Adobe’s `PCID` behavior works too.
4951

50-
#### Scenario 2. Known user always, from first point of contact.
52+
#### Scenario 2. The user is known from the first point of contact.
5153
This scenario assumes that your users authenticate and have a `userId` upon arriving on your website. When the user arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `userId`.
5254

5355
If the same known user visits on a different device, assuming they authenticate immediately, they will have the same `userId` and therefore the same `mbox3rdPartyId`. This means you can target known users across devices.
5456

5557
#### Scenario 3. Anonymous user becomes a known user.
56-
When the user first arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`. However, once the user is identified, they will be assigned a new `mbox3rdPartyId` equal to the Segment `userId`. There will be two profiles in Adobe Target; both will be available for targeting.
58+
When an anonymous user arrives on your website, one Adobe Target profile will be created and the `mbox3rdPartyId` will be equal to the Segment `anonymousId`. However, once the user is identified, they will be assigned a new `mbox3rdPartyId` equal to the Segment `userId`. There will be two profiles in Adobe Target; both will be available for targeting.
5759

5860
### How to use Adobe Target with Personas
59-
For information on how to use Adobe Target with Personas, please see [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/).
61+
For information on how to use Adobe Target with Personas, please see [Adobe Target Cloud Mode destination](/docs/connections/destinations/catalog/actions-adobe-target-cloud/#how-to-use-adobe-target-with-personas).
6062

6163
## Viewing Segment data in Adobe Target
6264
To view and use your Segment data in Adobe Target, navigate to **Adobe Target > Audiences > Create Audience > Add Rule**.
6365

64-
- Profile Attributes will appear under the “Visitor Profile attributes.
65-
- Page Parameters will appear under Custom attributes. Fields will have `page.` prepended to the key.
66+
- Profile Attributes appear under **Visitor Profile** attributes.
67+
- Page Parameters appear under **Custom** attributes. Fields have `page.` prepended to the key.
6668

67-
Audiences can then be used in Adobe Target **Activities**, such as A/B Testing and Experience Targeting. Please note that while Standard and Premium Adobe Target packages allow access to the SDK and API, certain personalization functionality may only be available with Adobe Target Premium.
69+
Adobe Target Audiences can be used in Activities, such as A/B Testing and Experience Targeting. Please note that while Standard and Premium Adobe Target packages allow access to the SDK and API, certain personalization functionality may only be available with Adobe Target Premium.

src/connections/destinations/catalog/actions-amplitude/index.md

+5
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@ title: Amplitude (Actions) Destination
33
hide-boilerplate: true
44
hide-dossier: false
55
id: 5f7dd6d21ad74f3842b1fc47
6+
versions:
7+
- name: "Amplitude (Classic)"
8+
link: '/docs/connections/destinations/catalog/amplitude'
9+
redirect_from:
10+
- '/connections/destinations/catalog/vendor-amplitude/'
611
---
712
{% include content/plan-grid.md name="actions" %}
813

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
# The end name should be similar to `Slack Destination`
3+
title: Close (Actions) Destination
4+
hide-boilerplate: true
5+
hide-dossier: true
6+
hidden: true
7+
---
8+
9+
<!-- This template is meant for Actions-based destinations that do not have an existing Classic or non-Actions-based version. For Actions Destinations that are a new version of a classic destination, see the doc-template-update.md template. -->
10+
11+
{% include content/plan-grid.md name="actions" %}
12+
13+
<!-- Include a brief description of the destination here, along with a link to your website. -->
14+
[Close](https://close.com/){:target="_blank"} is the inside sales CRM of choice for startups and small and midsize businesses (SMBs.)
15+
16+
17+
<!-- This include describes the requirement of A.js 2.0 or higher for Actions compatibility, and is required if your destination has a web component. -->
18+
19+
{% include content/ajs-upgrade.md %}
20+
21+
<!-- The section below explains how to enable and configure the destination. Include any configuration steps not captured below. For example, obtaining an API key from your platform and any configuration steps required to connect to the destination. -->
22+
23+
## Getting started
24+
25+
1. Go to your Close app and select the Organization you want to use.
26+
2. Click **Settings** in the bottom left, then click **API Keys** in the left menu. Create a new API Key.
27+
3. From the Segment web app, click **Catalog**, then click **Destinations**.
28+
4. Find the Destinations Actions item in the left navigation, and click it.
29+
5. Click the “Close” item to select it and click Configure.
30+
6. Choose which of your sources to connect the destination to. (You can connect more sources to the destination later.)
31+
32+
<!-- The line below renders a table of connection settings (if applicable), Pre-built Mappings, and available actions. -->
33+
34+
{% include components/actions-fields.html %}
35+
36+
<!--
37+
Additional Context
38+
39+
Include additional information that you think will be useful to the user here. For information that is specific to an individual mapping, please add that as a comment so that the Segment docs team can include it in the auto-generated content for that mapping.
40+
-->

0 commit comments

Comments
 (0)