Merge branch 'master' into DOC-243

stayseesong · web-flow · commit f29e4e144fc3 · 2021-07-12T17:14:01.000-07:00
diff --git a/src/_data/changelogs/analytics-android.yml b/src/_data/changelogs/analytics-android.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
 - version: 4.9.4
   url: 'https://github.com/segmentio/analytics-android/releases/tag/4.9.4'
diff --git a/src/_data/changelogs/analytics-go.yml b/src/_data/changelogs/analytics-go.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
 - version: Fix vendor packages
   url: 'https://github.com/segmentio/analytics-go/releases/tag/v3.0.1'
diff --git a/src/_data/changelogs/analytics-ios.yml b/src/_data/changelogs/analytics-ios.yml
@@ -1,6 +1,10 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
+- version: 4.1.5
+  url: 'https://github.com/segmentio/analytics-ios/releases/tag/4.1.5'
+  date: '2021-07-09T21:15:57Z'
+  notes: "* [Fix](https://github.com/segmentio/analytics-ios/pull/999) Add missing nullability identifier \r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/1002) Update Readme with SPM guide "
 - version: 4.1.4
   url: 'https://github.com/segmentio/analytics-ios/releases/tag/4.1.4'
   date: '2021-05-03T23:38:24Z'
@@ -117,7 +121,3 @@ releases:
   url: 'https://github.com/segmentio/analytics-ios/releases/tag/3.6.9'
   date: '2017-12-03T19:54:00Z'
   notes: "* [Fix](https://github.com/segmentio/analytics-ios/pull/700): Fixes some compiler warnings seen when importing analytics-ios via Swift in a Carthage project.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/730): Fix crash when trying to get screen name in some cases.\r\n* [New](https://github.com/segmentio/analytics-ios/pull/727): Support schema defaults.\r\n* [New](https://github.com/segmentio/analytics-ios/pull/724): Send disabled events to Segment so they can be surfaced in the debugger. This won't be sent to any destinations.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/723): Fix date formatting to be RFC 3339 compliant.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/715): Always deliver events asynchronously to integrations.\r\n\r\nVersion 3.6.8 has been deleted as it contained a bug which could cause events to not be delivered to the Segment API.\r\n"
-- version: 3.6.8
-  url: 'https://github.com/segmentio/analytics-ios/releases/tag/3.6.8'
-  date: '2017-11-28T23:49:41Z'
-  notes: "* [Fix](https://github.com/segmentio/analytics-ios/pull/700): Fixes some compiler warnings seen when importing analytics-ios via Swift in a Carthage project.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/730): Fix crash when trying to get screen name in some cases.\r\n* [New](https://github.com/segmentio/analytics-ios/pull/727): Support schema defaults.\r\n* [New](https://github.com/segmentio/analytics-ios/pull/724): Send disabled events to Segment so they can be surfaced in the debugger. This won't be sent to any destinations.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/723): Fix date formatting to be RFC 3339 compliant.\r\n* [Improvement](https://github.com/segmentio/analytics-ios/pull/720): Run connection factory asynchronously so it doesn't block queuing events.\r\n* [Fix](https://github.com/segmentio/analytics-ios/pull/715): Always deliver events asynchronously to integrations.\r\n"
diff --git a/src/_data/changelogs/analytics-java.yml b/src/_data/changelogs/analytics-java.yml
@@ -1,3 +1,3 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases: []
diff --git a/src/_data/changelogs/analytics-node.yml b/src/_data/changelogs/analytics-node.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
 - version: v4.0.1
   url: 'https://github.com/segmentio/analytics-node/releases/tag/v4.0.1'
diff --git a/src/_data/changelogs/analytics-php.yml b/src/_data/changelogs/analytics-php.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
 - version: 1.8.0
   url: 'https://github.com/segmentio/analytics-php/releases/tag/1.8.0'
diff --git a/src/_data/changelogs/analytics-python.yml b/src/_data/changelogs/analytics-python.yml
@@ -1,3 +1,3 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases: []
diff --git a/src/_data/changelogs/analytics-react-native.yml b/src/_data/changelogs/analytics-react-native.yml
@@ -1,6 +1,12 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
+- version: 1.4.9
+  url: 'https://github.com/segmentio/analytics-react-native/releases/tag/1.4.9'
+  date: '2021-06-21T21:32:41Z'
+  notes: >-
+    Bumps Mixpanel and Facebook IOS integrations to resolve build issues.
+    https://github.com/segmentio/analytics-react-native/pull/335
 - version: 1.4.8
   url: 'https://github.com/segmentio/analytics-react-native/releases/tag/1.4.8'
   date: '2021-05-26T22:50:08Z'
diff --git a/src/_data/changelogs/analytics.NET.yml b/src/_data/changelogs/analytics.NET.yml
@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM GITHUB API. DO NOT EDIT
-# Releases last updated 2021-06-01 
+# Releases last updated 2021-07-09 
 releases:
 - version: v3.7.1
   url: 'https://github.com/segmentio/Analytics.NET/releases/tag/3.7.1'
diff --git a/src/connections/destinations/actions.md b/src/connections/destinations/actions.md
@@ -26,6 +26,24 @@ Each Actions-framework Destination you see in the Segment catalog represents a f
 - If you are using Protocols, Destination Actions actions are applied *after* [schema filters](/docs/protocols/enforce/schema-configuration/) and [transformations](/docs/protocols/transform/). If you are using [destination filters](/docs/connections/destinations/destination-filters/), Actions are applied after the filters - meaning that they are not applied to data that is filtered out.
 - Destination Actions can not yet be accessed or modified using the Segment APIs.
 
+## Components of a Destination Action
+
+A Destination Action contains a hierarchy of components, that work together to ensure the right data is sent to the destination. 
+
+At the top level, is the Destination itself. It has two children: **Global Settings** and **Subscriptions**. 
+
+**Global Settings** are where you include authentication information like API keys, and other connection-related information. 
+
+**Subscriptions** handle the individual calls to the destination. In them, you define what type of call you want to make to the destination, and what triggers that call. Individual Destination Actions come enabled with some predefined subscriptions to handle common events like Screen calls, Identify calls, and Track calls. Subscriptions have two components that make this possible: **Triggers** and an **Action**. 
+
+**Triggers** enable you to define *when* the corresponding Action fires. As part of a Trigger, you can use condition-based filters to narrow the scope of the trigger.
+
+**Actions** determine the information sent to the destination. In the Configure action section, you map the fields that come from your source, to fields that the destination expects to find. Fields on the destination side depend on the type of action selected
+
+For example, in the Amplitude (Actions) destination, you define your API and Secret keys in the destination's global settings. Then, the provided Page Calls subscription:
+
+1. Triggers the action on all incoming Page events.
+2. Runs the Log Event action, to map your incoming data to Amplitudes properties.
 
 
 ## Set up a destination action
@@ -87,6 +105,13 @@ The following type filters and operators are available to help you build conditi
 
 You can combine criteria in a single group using **ALL** or **ANY**.  Use an ANY to “subscribe” to multiple conditions. Use ALL when you need to filter for very specific conditions. You can only create one group condition per destination action. You cannot created nested conditions.
 
+> info "Destination Filters"
+> Destination filters are compatible with Destination Actions. Consider a Destination Filter when:
+> - You need to remove properties from the data sent to the destination
+> - You need to filter data from multiple types of call (for example, Track, Page, and Identify calls)
+> 
+> If your use case does not match these criteria, you might benefit from using Subscription-level triggers to match only certain events.
+
 
 
 <!--
diff --git a/src/connections/destinations/catalog/amazon-kinesis/index.md b/src/connections/destinations/catalog/amazon-kinesis/index.md
@@ -24,16 +24,18 @@ This document was last updated on February 05, 2020. If you notice any gaps, out
               "Effect": "Allow",
               "Action": [
                   "kinesis:PutRecord",
-                  "kinesis:PutRecords"
+                  "kinesis:PutRecords",
+                  "iam:SimulatePrincipalPolicy"
               ],
               "Resource": [
-                  "arn:aws:kinesis:{region}:{account-id}:stream/{stream-name}"
+                  "arn:aws:kinesis:{region}:{account-id}:stream/{stream-name}",
+                  "arn:aws:iam::{account-id}:role/{role-name}"
               ]
           }
       ]
    }
    ```
-   **Note:** A previous version of this policy document only granted `PutRecord` access, which could slow down Kinesis write times by disallowing file batching. Substitute the updated policy document above to grant Kinesis `PutRecords` (plural) and allow batching.
+   **Note:** A previous version of this policy document only granted `PutRecord` access, which could slow down Kinesis write times by disallowing file batching. Substitute the updated policy document above to grant Kinesis `PutRecords` (plural) and allow batching. We've also requested `iam:SimulatePrincipalPolicy`, which will allow us to verify that the IAM Role has the appropriate Kinesis permissions without invoking the Kinesis API.
 
 3. Create an IAM role.
    Follow these instructions to [Create an IAM role](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html#roles-creatingrole-user-console) to allow Segment permission to write to your Kinesis Stream. When prompted to enter an Account ID, enter "595280932656". Make sure to enable 'Require External ID' and enter your Segment Source ID as the External ID*. This can be found by navigating to Settings > API Keys from your Segment source homepage. When adding permissions to your new role, find the policy you created above and attach it.
@@ -178,6 +180,30 @@ Replace that snippet with the following, and replace the contents of the array w
 }
 ```
 
+### Update IAM to Support PutRecords
+
+The Kinesis destination defaults to use PutRecords. A previous version of the IAM policy document only granted `PutRecord` access, which can slow down Kinesis write times and degrade data deliverability. Substitute the updated policy document above to grant Kinesis `PutRecords` (plural) and allow batching, like this: 
+   ```json
+   {
+      "Version": "2012-10-17",
+      "Statement": [
+          {
+              "Effect": "Allow",
+              "Action": [
+                  "kinesis:PutRecord",
+                  "kinesis:PutRecords",
+                  "iam:SimulatePrincipalPolicy"
+              ],
+              "Resource": [
+                  "arn:aws:kinesis:{region}:{account-id}:stream/{stream-name}",
+                  "arn:aws:iam::{account-id}:role/{role-name}"
+              ]
+          }
+      ]
+   }
+   ```
+After you update the IAM policy, Segment systems default to use PutRecords for more efficient data transmission. This is a zero-downtime change and does not impact your data other than increasing the deliverability success rate.
+
 ### Use a single secret ID
 If you have so many sources using Kinesis that it is impractical to attach all of their IDs to your IAM role, you can instead opt to set a single ID to use instead. This approach should be avoided in favor of the above approach if possible since it will result in you having to keep track of a secret value. To set this value, go to the Kinesis destination settings from each of your Segment sources and set the 'Secret ID' to a value of your choosing. This value is a secret and should be treated as sensitively as a password. Once all of your sources have been updated to use this value, find the IAM role you created for this destination in the AWS Console in Services > IAM > Roles. Click on the role, and navigate to the **Trust Relationships** tab. Click **Edit trust relationship**. You should see a snippet that looks something that looks like this:
 
diff --git a/src/connections/destinations/catalog/comscore/index.md b/src/connections/destinations/catalog/comscore/index.md
@@ -14,18 +14,6 @@ When you enable comScore in the Segment web app, your changes appear in the Segm
 
 To get started with comScore and Segment, you'll want to first integrate your mobile app with our [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/) or [Android](/docs/connections/sources/catalog/libraries/mobile/android/) sources. comScore can only accept data sent directly from their iOS and Android SDKs. For that reason we can only send data directly from our iOS and Android SDKs to comScore. **Data recorded in our server-side sources cannot be sent to comScore.** Be sure to follow the additional set up steps to get started, which you can find [here for iOS](https://github.com/segment-integrations/analytics-ios-integration-comscore#analytics-ios-integration-comscore) and [here for Android](https://github.com/segment-integrations/analytics-android-integration-comscore#analytics-android-integration-comscore).
 
-With the recent comScore update, there is an additional implementation step when getting started with comScore Android. Be sure to add this to your gradle file:
-
-```
-allprojects {
-  repositories {
-    maven {
-      url "https://comscore.bintray.com/Analytics"
-    }
-  }
-}
-```
-
 ## React Native
 
 {% include content/react-dest.md only="ios"%}
diff --git a/src/connections/destinations/catalog/salesforce-marketing-cloud/index.md b/src/connections/destinations/catalog/salesforce-marketing-cloud/index.md
@@ -281,14 +281,12 @@ In order to do this, you must have access to **Personas**. To learn more, [conta
 > **Tip**: We recommend that you use [SFMC batching](#optional-set-up-sfmc-batching) with Personas to help reduce the number of API calls that you send to SFMC, but this is optional. If you choose to set up batching, do this _before_ you set up the SFMC destination in your Segment workspace.
 
 1. In your Personas space, add the SFMC destination to a computed trait or audience.
-2. You can either sync to an existing Data Extension or you can make the sync create a new Data Extension in SFMC.
-   - To **Create a new Data Extension** leave the Data Extension External Key blank. This creates a new Data Extension in the default location configured for your SFMC instance, with all the required columns.
-   - To **Sync to an existing Data Extension**: enter the Data Extension External Key for the existing Data Extension. When your audience syncs to it, Segment adds a new column which stores the computed trait or audience membership.
+2. Enter the Data Extension External Key for the existing Data Extension. When your audience syncs to it, Segment adds a new column which stores the computed trait or audience membership.
 
-If you sync to an existing Data Extension, there are additional requirements:
+When you sync to an existing Data Extension, note these additional requirements:
 - The table cannot have an existing **Primary Key**, unless it is the `Contact Key` field, and the field type is `Text`.
 - All fields in the Data Extension must be nullable (meaning optional, or not required), except the `Contact Key` field.
-- Any fields that you will send with Segment, and which already exist in the Data Extension must be of the correct data type. If they do not exist, Segment creates them for you. The standard identifiers Segment sends come from the [Context object](https://segment.com/docs/connections/spec/common/#context), and appear in the image below.
+- Any fields that you send with Segment, and which already exist in the Data Extension, must be of the correct data type. If they do not exist, Segment creates them for you. The standard identifiers Segment sends come from the [Context object](https://segment.com/docs/connections/spec/common/#context), and appear in the image below.
 
 ![](images/existing-dext-data-types.png)
 
diff --git a/src/connections/spec/ecommerce/v2.md b/src/connections/spec/ecommerce/v2.md
@@ -4,7 +4,8 @@ title: 'Spec: V2 Ecommerce Events'
 
 Segment's e-commerce spec helps define the journey for a customer as they browse your store, click on promotions, view products, add those products to a cart, and complete a purchase.
 
-**Note:** Not all destinations support every event listed here. Refer to individual destination docs for more information on supported events and properties.
+> info "Note"
+> Not all destinations support every event listed here and accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 ## Event Lifecycles
 
@@ -117,7 +118,10 @@ analytics.track('Products Searched', {
 
 ### Product List Viewed
 
-Fire this event when a visitor views a product list or category.
+Fire this event when a visitor views a product list or category. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 This event supports the following semantic properties:
 
@@ -240,7 +244,10 @@ analytics.track('Product List Viewed', {
 
 ### Product List Filtered
 
-Send this event when a visitor filters a product list or category.
+Send this event when a visitor filters a product list or category. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 This event supports the following semantic properties:
 
@@ -933,7 +940,10 @@ analytics.track('Product Removed', {
 
 ### Cart Viewed
 
-Fire this event when a visitor views a shopping cart.
+Fire this event when a visitor views a shopping cart. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 This event supports the following semantic properties:
 
@@ -1044,7 +1054,10 @@ analytics.track('Cart Viewed', {
 
 ### Checkout Started
 
-Fire this event whenever an order/transaction was started. Fire on the page that the customer lands on after they press the checkout button.
+Fire this event whenever an order/transaction was started. Fire on the page that the customer lands on after they press the checkout button. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:
 
@@ -1364,7 +1377,10 @@ You can have as many or as few steps in the checkout funnel as you'd like. Note
 
 ### Order Updated
 
-Fire this event whenever an order/transaction was updated.
+Fire this event whenever an order/transaction was updated. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:
 
@@ -1532,7 +1548,10 @@ The `sku` and `product_id` do not have to be different. If they are different, t
 
 ### Order Completed
 
-Fire this event whenever an order/transaction was successfully completed by the customer.
+Fire this event whenever an order/transaction was successfully completed by the customer. 
+
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
 
 Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:
 
@@ -1767,6 +1786,9 @@ analytics.track('Order Refunded', {
 
 Fire this event whenever an order/transaction was cancelled.
 
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
+
 Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls.
 
 This event supports the following semantic properties:
@@ -2562,6 +2584,9 @@ analytics.track('Product Shared', {
 
 Fire this event when a customer shares a shopping cart.
 
+> info "Note"
+> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.
+
 This event supports the following semantic properties:
 
 <table>
