Merge pull request #6228 from StackAdapt/am/s2s-docs-update

Add documentation on using trait information in event rules

Author: pwseg

src/connections/destinations/catalog/actions-stackadapt/images/email-event-rule.png

@@ -91,7 +91,7 @@ For example, to create a conversion event when an order is completed with a reve
 This rule would match a Segment event fired with code such as:
 
 ```javascript
-analytics.track("Order Completed", {
+analytics.track('Order Completed', {
   order_id: '50314b8e9bcf000000000000',
   revenue: 11.5
   products: [
@@ -106,6 +106,35 @@ analytics.track("Order Completed", {
 });
 ```
 
+#### Trait Fields
+
+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`          |
+| `traits.phone`         | `phone`              |
+
+For example, to create a conversion event when a user with the domain `example.com` completes an order, you could set up an event rule matching an `action` value of `Order Completed` and an `email` containing `@example.com` as shown below:
+
+![Image showing event rule in StackAdapt the matches an Order Completed event with an email containing @example.com](images/email-event-rule.png)
+
+This rule would match a Segment event fired with code such as:
+
+```javascript
+analytics.track('Order Completed', {
+  order_id: '50314b8e9bcf000000000000',
+  traits: {
+    email: '[email protected]',
+    first_name: 'John',
+    last_name: 'Smith',
+    phone: '+180055501000'
+  }
+});
+```
+
 ### URL rules
 
 If you are using URL rules, these will be matched whenever Segment sends an event to StackAdapt with a `url` matching the URL rule. This should be accomplished by the page event Segment automatically fires when a page is viewed, so setup of URL rules should be identical to setting up URL rules with the StackAdapt pixel.