Merge branch 'master' into function-retry-error

Author: sanscontext

src/connections/destinations/catalog/algolia-insights/index.md

@@ -71,7 +71,7 @@ Algolia supports the following six events from Segment's [Ecommerce Spec](https:
 analytics.track('Product List Viewed', {
     products: [{
         objectID: "hit objectID",
-        position: "hit position on index",
+        position: hitPositionOnIndex,  // number
         index: "my-index-name",
         queryID: "Algolia queryID" // required only for Click Analytics,
     }]
@@ -86,15 +86,15 @@ analytics.track('Product List Filtered', {
 
 analytics.track('Product Viewed', {
     objectID: "hit objectID",
-    position: "hit position on index",
+    position: hitPositionOnIndex,  // number
     index: "my-index-name",
     queryID: "Algolia queryID" // required only for Click Analytics,
 })
 
 
 analytics.track('Product Clicked', {
     objectID: "hit objectID",
-    position: "hit position on index",
+    position: hitPositionOnIndex,  // number
     index: "my-index-name",
     queryID: "Algolia queryID" // required only for Click Analytics,
 })

src/connections/destinations/catalog/taplytics/index.md

@@ -11,21 +11,21 @@ Once the Segment library is integrated with your app, add your API key and selec
 Follow the below steps for destination
 
 ### iOS
-To get started with Taplytics on iOS, first integrate your app with the Taplytics [iOS](/docs/connections/sources/catalog/libraries/mobile/ios) library. To get the API key, [login](https://taplytics.com/) to your account, select the App on the top left then click into the Settings menu on the left side. If you want to set up Push Notifications click on the Push Notification tab in their UI and [follow the instructions](https://taplytics.com/docs/guides/push-notifications/apple-push-certificates). Finally, you want to ensure you have configured your app delegate to [enable push notifications](/docs/connections/sources/catalog/libraries/mobile/ios/#how-do-i-use-push-notifications).
+To get started with Taplytics on iOS, first integrate your app with the Taplytics [iOS](/docs/connections/sources/catalog/libraries/mobile/ios) library. To get the API key, [login](https://taplytics.com/) to your account, select the App on the top left then click into the Settings menu on the left side. If you want to set up Push Notifications click on the Push Notification tab in their UI and [follow the instructions](https://docs.taplytics.com/docs/guides-push-notifications). Finally, you want to ensure you have configured your app delegate to [enable push notifications](/docs/connections/sources/catalog/libraries/mobile/ios/#how-do-i-use-push-notifications).
 
-If you want to set up deep linking, just follow [this section of their docs](https://taplytics.com/docs/ios-sdk/getting-started#app-linking)!
+If you want to set up deep linking, just follow [this section of their docs](https://support.taplytics.com/hc/en-us/articles/360004176632-Deep-Linking-Guide-)!
 
-For more information about setting up Taplytics on iOS, see their [docs](https://taplytics.com/docs/ios-sdk/getting-started)
+For more information about setting up Taplytics on iOS, see their [docs](https://docs.taplytics.com/docs/ios-getting-started)
 
 
 ### Android
 To get up and running with Taplytics on Android, there a couple of steps we will walk you through. You first want to ensure that you've integrated your mobile app with our [Android](/docs/connections/sources/catalog/libraries/mobile/android) library.
 
-To enable its full functionality (like Push Notifications, Deep linking), there are a couple of extra steps that you have to take care of in your Android app. [This document explains how to set up Push Notifications](https://taplytics.com/docs/android-sdk/push-notifications) and [ths one explains how to set up deep linking](https://taplytics.com/docs/android-sdk/getting-started#device-pairing).
+To enable its full functionality (like Push Notifications, Deep linking), there are a couple of extra steps that you have to take care of in your Android app. [This document explains how to set up Push Notifications](https://docs.taplytics.com/docs/guides-push-notifications) and [ths one explains how to set up deep linking](https://support.taplytics.com/hc/en-us/articles/360004176632-Deep-Linking-Guide-).
 
 
 ## Identify
-Use [Identify](/docs/connections/sources/catalog/libraries/mobile/ios/#identify) to track user specific attributes. It equivalent to tracking [user attributes](https://taplytics.com/docs/guides/user-attributes-setup) on Taplytics. Taplytics supports traits supported by Segment as well as custom traits. If you set traits.id, we set that as the Unique ID for that user.
+Use [Identify](/docs/connections/sources/catalog/libraries/mobile/ios/#identify) to track user specific attributes. It equivalent to tracking [user attributes](https://docs.taplytics.com/docs/guides-user-insights) on Taplytics. Taplytics supports traits supported by Segment as well as custom traits. If you set traits.id, we set that as the Unique ID for that user.
 
 ## Track
 Use [track](/docs/connections/sources/catalog/libraries/mobile/ios/#track) to track events and user behaviour in your app.

src/connections/sources/catalog/libraries/mobile/ios/index.md

@@ -102,7 +102,7 @@ configuration.trackPushNotifications = YES;
 ```
 
 ### Automatic Deep Link Tracking
-Tracking deep linking will automatically track `Deep Link Clicked` and `Deep Link Opened`.
+Tracking deep linking will automatically track `Deep Link Opened`.
 
 ```objc
 SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration configurationWithWriteKey:@"YOUR_WRITE_KEY"];

src/connections/sources/catalog/libraries/website/javascript/middleware.md

@@ -53,6 +53,9 @@ var DMW1 = function({ payload, integration, next }) {
 };
 ```
 
+> note ""
+> Currently only Device-mode Destinations are supported by Destination Middlewares 
+
 ## Adding middlewares to Analytics.js
 
 The above defined Source & Destination Middleware can be added to the Analytics.js execution chain as:

src/connections/spec/mobile.md

@@ -51,13 +51,13 @@ The following events will be tracked automatically when lifecycle events are ena
 
 This event fires when a user **first** opens your mobile application. Note, if the user never opens your app after installing, we will not be able to collect this event. This event does not wait for attribution or campaign information to be received, and is collected automatically by our SDKs. Advertising providers like Facebook and Google require discrete install events to correctly attribute installs to ads served through their platform.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Application Installed", "properties": { "version": "1.2.3", "build": "1234" }}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Application Installed", "properties": { "version": "1.2.3", "build": "1234" }}'}}} {% endcomment %}
 
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Installed",
   "properties": {
     "version": "1.2.3", "build": "1234"
@@ -75,12 +75,12 @@ This event fires when a user **first** opens your mobile application. Note, if t
 
 This event fires when a user launches or foregrounds your mobile application after the first open. It will fire after the `Application Installed` event and again after the app is re-opened after being closed. This event does not wait for attribution information to be received but may include information about referring applications or deep link URLs if available to the application upon open.
 
-{% comment %} api-example '{"userId": "019mr8mf4r", "action": "track", "event": "Application Opened", "properties": { "from_background": false, "referring_application": "GMail", "url": "url://location" }}'}}} {% endcomment %}
+{% comment %} api-example '{"userId": "019mr8mf4r", "type": "track", "event": "Application Opened", "properties": { "from_background": false, "referring_application": "GMail", "url": "url://location" }}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Opened",
   "properties": {
     "from_background": false,
@@ -103,12 +103,12 @@ This event fires when a user launches or foregrounds your mobile application aft
 
 This event should be sent when a user backgrounds the application upon [`applicationDidEnterBackground`](https://developer.apple.com/reference/uikit/uiapplicationdelegate/1622997-applicationdidenterbackground)
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Application Backgrounded", "properties": {}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Application Backgrounded", "properties": {}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Backgrounded",
   "properties": {}
 }
@@ -118,12 +118,12 @@ This event should be sent when a user backgrounds the application upon [`applica
 
 This event fires when a user updates the application. Our SDK will automatically collect this event in lieu of an "Application Opened" event when we determine that the Open is first since an update.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Application Updated", "properties": { "previous_version": "1.1.2", "previous_build": 1234, "version": "1.2.0", "build": "1456" }}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Application Updated", "properties": { "previous_version": "1.1.2", "previous_build": 1234, "version": "1.2.0", "build": "1456" }}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Updated",
   "properties": {
     "previous_version": "1.1.2",
@@ -145,12 +145,12 @@ This event fires when a user updates the application. Our SDK will automatically
 
 Fire this event when a user uninstalls the application. Several destination partners will detect this for you using Silent Push Notifications and send this event to Segment on your behalf.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Application Uninstalled", "properties": {}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Application Uninstalled", "properties": {}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Uninstalled",
   "properties": {}
 }
@@ -160,12 +160,12 @@ Fire this event when a user uninstalls the application. Several destination part
 
 You can send this event when you receive a crash notification from your app, but is not meant to supplant traditional crash reporting tools. By tracking crashes as an analytics event with device and user information, you can analyze the which types of users are impacted by crashes and how those crashes, in turn, affect their engagement. You may also want to target those customers with tailored communications in other channels if they've encountered several crashes.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Application Crashed", "properties": {}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Application Crashed", "properties": {}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Application Crashed",
   "properties": {}
 }
@@ -179,12 +179,12 @@ As the walls between apps become increasingly lowered, capturing information abo
 
 When Segment or an integrated partner can discern the source of an install, we'll collect an `Install Attributed` event. This event may be sent to Segment using server-to-server connection from your attribution provider, or directly on the device using packaged destinations. In either case, this will happen **after** install, and does not apply to all installs, which is why it is a discrete event.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Install Attributed", "properties": { "provider": "Tune/Kochava/Branch/AppsFlyer", "campaign": { "source": "Network/FB/AdWords/MoPub/Source", "name": "Campaign Name", "content": "Organic Content Title", "ad_creative": "Red Hello World Ad", "ad_group": "Red Ones" }}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Install Attributed", "properties": { "provider": "Tune/Kochava/Branch/AppsFlyer", "campaign": { "source": "Network/FB/AdWords/MoPub/Source", "name": "Campaign Name", "content": "Organic Content Title", "ad_creative": "Red Hello World Ad", "ad_group": "Red Ones" }}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Install Attributed",
   "properties": {
     "provider": "Tune/Kochava/Branch/AppsFlyer",
@@ -214,12 +214,12 @@ When Segment or an integrated partner can discern the source of an install, we'l
 
 This event can be sent when a push notification is received in the app. It can be automatically enabled on [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#automatic-push-notification-tracking).
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Push Notification Received", "properties": { "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match."}}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Push Notification Received", "properties": { "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match."}}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Push Notification Received",
   "properties": {
     "campaign": {
@@ -244,12 +244,12 @@ This event can be sent when a push notification is received in the app. It can b
 
 This event can be sent when a user taps on a push notification associated with your app. It can be automatically enabled on [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#automatic-push-notification-tracking).
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event": "Push Notification Tapped", "properties": {"action": "Accept", "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match." }}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event": "Push Notification Tapped", "properties": {"action": "Accept", "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match." }}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Push Notification Tapped",
   "properties": {
     "action": "Accept",
@@ -277,12 +277,12 @@ This event can be sent when a user taps on a push notification associated with y
 
 This event fires when a push notification from a provider bounces. If your push notification provider forwards push lifecycle events to Segment, they should include this event in their suite.
 
-{% comment %} api-example '{ "userId": "019mr8mf4r", "action": "track", "event":"Push Notification Bounced", "properties": { "action": "Accept", "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match." }}}'}}} {% endcomment %}
+{% comment %} api-example '{ "userId": "019mr8mf4r", "type": "track", "event":"Push Notification Bounced", "properties": { "action": "Accept", "campaign": { "medium": "Push", "source": "Vendor Name", "name": "Referral Flow", "content": "Your friend invited you to play a match." }}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event":"Push Notification Bounced",
   "properties": {
     "action": "Accept",
@@ -313,12 +313,12 @@ This event is fired *in addition* to the associated `Application Opened` event.
 
 Our [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#automatic-deep-link-tracking) SDK can collect this event automatically if configured to do so.
 
-{% comment %} api-example '{"userId": "019mr8mf4r", "action": "track", "event": "Deep Link Opened", "properties": {"provider": "Branch Metrics", "url": "app://landing" }}'}}} {% endcomment %}
+{% comment %} api-example '{"userId": "019mr8mf4r", "type": "track", "event": "Deep Link Opened", "properties": {"provider": "Branch Metrics", "url": "app://landing" }}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Deep Link Opened",
   "properties": {
     "provider": "Branch Metrics",
@@ -337,12 +337,12 @@ Our [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#automatic-deep
 
 This event may be provided by deep link providers postback mechanisms or an internal redirect service if you use one in order to provide a waypoint funnel step between your content or advertisement and the resulting app open.
 
-{% comment %} api-example '{"userId": "019mr8mf4r", "action": "track", "event": "Deep Link Clicked", "properties": {"provider": "Branch Metrics", "url": "brnch.io/1234"}}'}}} {% endcomment %}
+{% comment %} api-example '{"userId": "019mr8mf4r", "type": "track", "event": "Deep Link Clicked", "properties": {"provider": "Branch Metrics", "url": "brnch.io/1234"}}'}}} {% endcomment %}
 
 ```json
 {
   "userId": "019mr8mf4r",
-  "action": "track",
+  "type": "track",
   "event": "Deep Link Clicked",
   "properties": {
     "provider": "Branch Metrics",