Enrichment content updates

Author: rchinn1

src/engage/trait-activation/id-sync.md

@@ -8,10 +8,6 @@ Use ID Sync to select identifiers and a sync strategy when you send Audience or
 
 On this page, you'll learn how to configure and begin using ID Sync.
 
-> success "Trait Activation setup"
-> To view supported destinations and learn more about getting started with Trait Activation, visit the [setup guide](/docs/engage/trait-activation/trait-activation-setup/).
- 
-
 ## Set up ID Sync
 
 Use the following steps to set up ID Sync with Audiences or Journeys.
@@ -28,9 +24,7 @@ To set up ID Sync with [Audiences](/docs/engage/audiences/):
 
 ### Set up ID Sync with Journeys
 
-To set up ID Sync with [Journeys](/docs/engage/journeys/): 
-
-As you're creating or editing a journey in the [builder](/docs/engage/journeys/build-journey/), you can configure how you send identifiers with ID Sync from any of the [supported destinations](/docs/engage/trait-activation/trait-activation-setup/).
+You can configure ID Sync with Journeys as you're creating or editing your journey in the [builder](/docs/engage/journeys/build-journey/).
 
 1. From a journey step, select the destination you're going to use with ID Sync. 
 2. On the Connection Settings tab, select **Customized Setup**  and use the corresponding [steps below](#customized-setup) to customize which identifiers you want to map downstream to your destination. 

src/engage/trait-activation/trait-enrichment.md

@@ -6,21 +6,16 @@ plan: engage-foundations
 
 Use Trait Enrichment to access Segment profile traits when you sync Audiences and Journeys to Destinations. With Trait Enrichment, you can use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations. 
 
-> success "Trait Activation setup"
-> Visit the Trait Activation [setup doc](/docs/engage/trait-activation/trait-activation-setup/) for supported destinations and more on how to get started with Trait Activation.
-
-> info ""
-> The setup steps you'll use for Trait Enrichment depend on the type of Destination [you've connected](/docs/engage/trait-activation/trait-activation-setup/). 
-> - For Facebook Custom Audiences and Google Adwords, use [set up Trait Enrichment](#set-up-trait-enrichment). 
-> - If you're using SendGrid, Braze, Salesforce Actions, or Salesforce Marketing Cloud, use the [Destination Actions setup steps](#destination-actions-setup). 
-
- 
 ## Set up Trait Enrichment
 
 Use the following steps to set up Trait Enrichment with Audiences or Journeys.
 
+
 > info ""
-> If you're using Destination Actions, visit the setup instructions [here](#destination-actions-setup).
+> The setup steps you'll use for Trait Enrichment depend on the type of Destination [you've connected](/docs/engage/trait-activation/trait-activation-setup/). 
+> - For Facebook Custom Audiences and Google Adwords, use [set up Trait Enrichment](https://docs/engage/trait-activation/trait-enrichment/#destination-requirements). 
+> - If you're using Destination Actions, such as Salesforce Marketing Cloud, Braze Actions, or Salesforce Actions, use the [Destination Actions setup steps](#destination-actions-setup).
+
 
 ### Set up Trait Enrichment with Audiences
 
@@ -34,9 +29,8 @@ To set up Trait Enrichment with [Audiences](/docs/engage/audiences/):
 
 ### Set up Trait Enrichment with Journeys
 
-To set up Trait Enrichment with [Journeys](/docs/engage/journeys/):
 
-As you're creating or editing your journey in the [builder](/docs/engage/journeys/build-journey/), set up Trait Enrichment with any of the [supported destinations](/docs/engage/trait-activation/trait-activation-setup/).
+You can set up Trait Enrichment with Journeys as you're creating or editing your journey in the [builder](/docs/engage/journeys/build-journey/).
 
 1. From a journeys step, select the destination you're going to use with Trait Enrichment. 
 2. On the Connection Settings tab, select **Customized Setup**  and use the corresponding [steps below](#customized-setup) to customize the way data is sent to your destination by creating identifier and trait mappings. 
@@ -57,8 +51,82 @@ With Customized setup, you can choose which traits you want to map to your desti
 - Use the **Destination** column to select which traits you want to map to in your destination. By default, Segment attempts to find traits with matching names.
 3. Click **Save** and finish building your audience or journey.
 
-> info ""
-> Segment sends traits you select for enrichment in the traits object in Identify calls, and as properties in the properties object in Track calls.
+
+Segment sends traits you select for enrichment in the traits object in Identify calls (`traits.trait_1`, `traits.trait_2`), and as properties in the properties object in Track calls (`properties.trait_1`, `properties.trait_2`).
+
+
+Here's an example Identify call payload with traits in the `traits object`:
+
+```json
+{
+  "anonymousId": "507f191e810c19729de860ea",
+  "channel": "browser",
+  "context": {
+    "ip": "8.8.8.8",
+    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.115 Safari/537.36"
+  },
+  "integrations": {
+    "All": false,
+    "Mixpanel": true,
+    "Salesforce": true
+  },
+  "messageId": "022bb90c-bbac-11e4-8dfc-aa07a5b093db",
+  "receivedAt": "2015-02-23T22:28:55.387Z",
+  "sentAt": "2015-02-23T22:28:55.111Z",
+  "timestamp": "2015-02-23T22:28:55.111Z",
+  "traits": {
+    "name": "John Smith",
+    "email": "[email protected]",
+    "plan": "premium",
+    "logins": 5,
+    "address": {
+      "street": "6th St",
+      "city": "San Francisco",
+      "state": "CA",
+      "postalCode": "94103",
+      "country": "USA"
+    }
+  },
+  "type": "identify",
+  "userId": "97980cfea0067",
+  "version": "1.1"
+}
+```
+And here's an example Track call payload with traits in the `properties object`:
+
+```json
+{
+  "anonymousId": "23adfd82-aa0f-45a7-a756-24f2a7a4c895",
+  "context": {
+    "library": {
+      "name": "analytics.js",
+      "version": "2.11.1"
+    },
+    "page": {
+      "path": "/academy/",
+      "referrer": "",
+      "search": "",
+      "title": "Analytics Academy",
+      "url": "https://segment.com/academy/"
+    },
+    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.86 Safari/537.36",
+    "ip": "108.0.78.21"
+  },
+  "event": "Course Clicked",
+  "integrations": {},
+  "messageId": "ajs-f8ca1e4de5024d9430b3928bd8ac6b96",
+  "properties": {
+    "title": "Intro to Analytics"
+  },
+  "receivedAt": "2015-12-12T19:11:01.266Z",
+  "sentAt": "2015-12-12T19:11:01.169Z",
+  "timestamp": "2015-12-12T19:11:01.249Z",
+  "type": "track",
+  "userId": "AiUGstSDIg",
+  "originalTimestamp": "2015-12-12T19:11:01.152Z"
+}
+```
+
 
 ### Destination requirements 
 
@@ -95,12 +163,14 @@ Additionally, you can only map one trait per audience to Google as a phone numbe
 If you're using [Destination Actions](/docs/connections/destinations/actions/), use the following steps to set up Trait Enrichment.
 
 1. Navigate to **Engage > Engage settings**. 
-2. Select the Destinations tab, then click **+ Add Destination**. Search for either Braze Cloud Mode (Actions), Salesforce (Actions), Salesforce Marketing Cloud, or SendGrid Marketing Campaigns. 
+2. Select the Destinations tab, then click **+ Add Destination**. Trait Activation supports all [Destination Actions](/docs/connections/destinations/actions/).
 3. Enter your destination credentials.
 4. Navigate to **Engage > Audiences**, and click **+ Create**. 
 5. From the Select Destinations screen in the Audience builder, select your destination. 
-6. Confirm that "Send Identify" is toggled on. Next, select **Customized Setup**.
-7. Select **Add Trait**. Then, select the traits you want to sync and click **Save**.
+6. Confirm that "Send Track" or "Send Identify" is toggled on. 
+- Trait Enrichment supports Track and Identify calls. Follow the corresponding destination instructions to determine which event you'll need.
+7. Select **Customized Setup**.
+8. Select **Add Trait**. Then, select the traits you want to sync and click **Save**.
 
 ### Configure mappings in your Destination
 
@@ -111,14 +181,25 @@ After you add traits, configure how your selected traits will map to your Destin
 
 1. Navigate to **Connections > Destinations** and select your destination.
 1. From the Destination overview screen, select the **Mappings** tab. 
-2. Click **+ New Mapping**.
-- **Braze Cloud Mode (Actions)**: Use a preset mapping called "Update User Profile". 
-- **Salesforce (Actions)**: Use `Identify calls` as your event trigger.
-- **SendGrid Marketing Campaigns**: Configure an "Upsert Contact" mapping. Use `Identify calls` as the event trigger. 
+2. Click **+ New Mapping**. 
+- All actions in an actions-based destination can receive traits you configure with Trait Activation.
 3. Locate the  **Select mappings** section to confirm the default field mappings match the traits in your custom setup. 
 - To update a trait field mapping, click on a field, and in the dropdown search bar enter `traits.` followed by your trait. For example, `traits.email`. Then, click **Use as an event variable**.
 4. Click **Save** and navigate back to Engage to finish building your Audience. 
 
+For Track events, Segment sends traits you select for enrichment in the `properties object` in a Track call. 
+- For example: `properties.trait_1`, `properties.trait_2`
+
+For Identify events, Segment sends traits you select for enrichment in the `traits object` in Identify calls. 
+- For example: `traits.trait_1`, `traits.trait_2`
+
+<!-- hold on this for now
+When a sample event from **Load Test Event from Source** is available, the dropdowns under the mappings will include traits configured previously.
+
+![Load a test event from your source](/docs/engage/images/test-event-from-source.png)
+
+-->
+
 ## Best practices
 
 For best results with Trait Enrichment, Segment recommends: