Merge branch 'master' into littledata-docs-update

edwardupton · edwardupton · commit f78d55bcb904 · 2021-04-22T17:46:30.000+01:00
diff --git a/src/_layouts/default.html b/src/_layouts/default.html
@@ -83,7 +83,7 @@
     Production: https://app.segment.com/segment_prod/sources/segment_docs_v2_prod
     Everything else: https://app.segment.com/segment-engineering/sources/segment_docs
   {%- endcomment -%}
-  {%- if jekyll.environment == "production" -%}
+  {%- if site.env.CONTEXT == "production" -%}
     {%- assign write_key = "QAKKJEtNsXpsNfCCBeWCLNxkaaLO7pgp" -%}
   {%- else -%}
     {%- assign write_key = "f5c1iWVVwikUDoh5NuVq0G52EPFrMmrX" -%}
@@ -118,7 +118,6 @@
   {%- comment -%}
     Consent Manager
   {%- endcomment -%}
-
 <script>
   window.consentManagerConfig = function (exports) {
     var React = exports.React
diff --git a/src/connections/destinations/catalog/google-analytics/index.md b/src/connections/destinations/catalog/google-analytics/index.md
@@ -621,8 +621,16 @@ If you want to send UTM parameters to Google Analytics using one of the Segment
 
 Your UTM params need to be passed in the `context` object in `context.campaign`. For Google Analytics `campaign.name`, `campaign.source` and `campaign.medium` all need to be sent together for things to show up in reports. The other two params (`campaign.term` and `campaign.content`) are both optional, but will be forwarded to GA if you send them to Segment.
 
+### Measurement Protocol Parameters
 
----
+Google Analytics uses a reserved set of [Measurement Protocol Parameters](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters) which are automatically collected by the device-mode Google Analytics tracker. 
+
+To include Measurement Protocol Parameters when sending server-side events to Google Analytics:
+
+1. Collect the value of the parameter as a Segment trait or property
+2. Configure the Segment Google Analytics destination to [map the trait or property](#map-traits-or-properties-to-measurement-protocol-params) to a specific Measurement Protocol Parameter key
+
+Segment supports the `plt`, `pdt`, `gclid`, `dt`, and `cid` Measurement Protocol Parameters.
 
 
 ## Features
diff --git a/src/connections/sources/catalog/libraries/website/shopify-littledata/index.md b/src/connections/sources/catalog/libraries/website/shopify-littledata/index.md
@@ -35,7 +35,7 @@ Here's an architecture diagram that shows how the Littledata app mediates data f
 7. Segment's **analytics.js** library, Littledata **tracking script** and **webhooks** will be automatically applied to the store and the installation process will then be complete.
    ![](images/kvjNx4M.png)
 
-## Device-mode Events
+## Device-mode events
 
 Below is a table of events that **Shopify by Littledata** sends to Segment through the analytics.js library. These events will show up as tables in your warehouse, and as regular events in your other Destinations supporting device-mode.
 
@@ -50,11 +50,11 @@ Below is a table of events that **Shopify by Littledata** sends to Segment throu
 | Product Viewed        | A user has viewed a product page                                    |
 | Products Searched     | A user has searched for products (with search `query`)              |
 | Registration Viewed   | A user has viewed the /account/register page                        |
-| Thank you Page Viewed | A user has viewed the thank you page after completing an order \*   |
+| Thank you Page Viewed | A user has viewed the thank you page after completing an order\*    |
 
-> info "" \* This is less reliable than the de-duplicated `Order Completed` event sent from the Littledata servers, but you can use it in device-mode destinations to trigger a conversion. The `payment_method` and `shipping_method` properties are not available with this event.
+> note "" \* This is less reliable than the de-duplicated `Order Completed` event sent from the Littledata servers, but you can use it in device-mode destinations to trigger a conversion. The `payment_method` and `shipping_method` properties are not available with this event.
 
-## Cloud-mode Events
+## Cloud-mode events
 
 Below is a table of events that **Shopify by Littledata** sends to Segment from Littledata's servers. These events appear as tables in your warehouse, and as regular events in your other Destinations that support cloud-mode. They include the `anonymousId` that links them to the device-mode events where the event was part of a previous user session, or associated with a `userId` that was previously linked with an `anonymousId`. See Littledata's [troubleshooting guide on attribution](https://blog.littledata.io/help/posts/troubleshooting-marketing-attribution-for-shopify/) for more details.
 
@@ -76,7 +76,7 @@ Below is a table of events that **Shopify by Littledata** sends to Segment from
 | Product Added            | A user has added a product to the cart, and left it in the cart for more than 10 seconds                                                                                                    |
 | Product Removed          | A user has removed a product from the cart                                                                                                                                                  |
 
-## User Identity
+## User identity
 
 In the Littledata application you can choose which of the following fields you want to send as the `userId` for known customers:
 
@@ -87,7 +87,7 @@ In the Littledata application you can choose which of the following fields you w
 
 For [Segment Personas](/docs/personas/) we also send `shopify_customer_id` as an [externalID](/docs/personas/identity-resolution/externalids/) for advanced matching.
 
-## Identify Calls
+## Identify calls
 
 For every event where there is an identifiable Shopify customer (from both the device-mode and cloud-mode) Littledata also sends an Identify call. This happens when the customer logs into the storefront, on the last step of the checkout, with the order, and also after purchase with any customer update in Shopify admin.
 
@@ -118,11 +118,11 @@ All events (device-mode and cloud-mode) contain the Google Analytics `clientId`
 
 Email marketing platforms such as [Klaviyo](/docs/connections/destinations/catalog/klaviyo/#server-side-track), [Iterable](/docs/connections/destinations/catalog/iterable/#track) and [Hubspot](/docs/connections/destinations/catalog/hubspot/#server) require an email property with any server-side event in order to associate events with a customer (they cannot use an `anonymousId`). Littledata adds that `email` property whenever an email address is set in the user `traits()` object (in device-mode) or from the Shopify customer record (in cloud-mode). Iterable can also [receive cookie values](#cookiesToTrack) with the Order Completed event.
 
-## Alias Calls
+## Alias calls
 
 To support seamless customer tracking the [Mixpanel](/docs/connections/destinations/catalog/mixpanel/#alias), [Vero](/docs/connections/destinations/catalog/vero/#alias) and [KISSMetrics](/docs/connections/destinations/catalog/kissmetrics/#alias) destinations, Littledata ensures the pre-checkout `anonymousId` is added as an alias of the `userId` (used from checkout step 2 onwards).
 
-## Subscription Events
+## Subscription events
 
 Additional events available through Littledata's [ReCharge connection](https://www.littledata.io/connections/recharge), and available in cloud-mode destinations.
 
@@ -136,7 +136,7 @@ Additional events available through Littledata's [ReCharge connection](https://w
 | Subscription Created     | A customer has created a subscription (with `status`, `order_interval_frequency` and `order_interval_unit`) |
 | Subscription Updated     | A customer has updated a subscription (with `status`, `order_interval_frequency` and `order_interval_unit`) |
 
-## Event Properties
+## Event properties
 
 The list below outlines the properties included in the events listed above.
 
@@ -168,9 +168,9 @@ The list below outlines the properties included in the events listed above.
 | `total`                                | The total value of the order                                                                       | Float         |
 | `userId`                               | Chosen user identifier, defaulting to Shopify Customer ID                                          | String        |
 
-\* `revenue` is available only with the Order Completed event, and only if the store opts in via the Littledata application. Revenue is a reserved property in many Segment destinations. Opting in will override the `total` property sent to Google Analytics.
+> note "" \* `revenue` is available only with the Order Completed event, and only if the store opts in via the Littledata application. Revenue is a reserved property in many Segment destinations. Opting in will override the `total` property sent to Google Analytics.
 
-## Product Properties
+## Product properties
 
 Each item in the `products` array, or Product Viewed and Product Added events, will have the following properties
 
@@ -196,7 +196,7 @@ Each item in the `products` array, or Product Viewed and Product Added events, w
 
 With a [Littledata Plus plan](https://www.littledata.io/app/enterprise) you can import all Shopify orders and refunds from before you started using Segment, to sync with destinations that support timestamped events (for example, a data warehouse). This enables you to build a complete customer history in your chosen destination.
 
-## Advanced Device-mode Settings
+## Advanced Device-mode settings
 
 You can edit the LittledataLayer object in your Shopify theme to manually change these advanced settings. For more information, see the [Shopify tracker GitHub repository](https://github.com/littledata/shopify-tracker#segment-configuration).
 
diff --git a/src/personas/product-limits.md b/src/personas/product-limits.md
@@ -0,0 +1,43 @@
+---
+title: Limits
+---
+
+
+
+
+These rate limits were added to our product documentation on December 9, 2020.
+
+## Summary of Limits
+
+| Name                                        | Limit                                                       |
+| ------------------------------------------- | ----------------------------------------------------------- |
+| Inbound Data Throughput                     | 1000 events per second                                      |
+| Inbound Historical Replay Throughput        | 1000 events per second                                      |
+| Outbound Downstream Destination Rate Limits | Reduced retries when failures exceed 1000 events per second |
+| Profile API throughput                      | 100 requests per second                                     |
+| Identity Merges                             | 100 merges                                                  |
+| Identity Mappings                           | 1000 mappings                                               |
+
+## Inbound Data Throughput
+
+If within a ten minute period a Customer’s sources (in aggregate) send more than 600,000 events (average of 1,000 events per second) without prior arrangement, Segment reserves the right to queue any additional events and process those at a rate that does not exceed 600,000 events in any ten minute period. Any requests to raise that limit must be made in writing with Segment. Please reach out to friends@segment.com with details on your use case and estimated throughput.
+
+## Inbound Historical Replay Throughput
+
+Similar to live data ingestion, any requests to replay historical customer data into Personas will be capped at a rate of 1000 events per second. Replays are initiated by the Segment support team. If you have a need for a higher replay throughput, please reach out to friends@segment.com with details on your use case.
+
+## Outbound Downstream Destination Rate Limits
+
+Most destinations have their own rate limits that Segment cannot control. In some instances, Segment is able to ingest and attempt to deliver data faster than the downstream destination is able to accept data. Outbound requests to a destination may also fail for other reasons outside of Segment’s control. When requests to downstream destinations fail, Segment makes additional attempts to deliver the data (retries). However, when more than 1,000 requests per second to a downstream destination fail or when the failure rate for a downstream destination exceeds 50% for more than 72 hours, Segment reserves the right to reduce the number of retries until the condition is resolved.
+
+## Profile API throughput
+
+If a Customer sends more than 100 requests a second per space to the Profile API, Segment will return a 429 rate-limiting error. Any requests to raise that limit must be made in writing with Segment. Please reach out to friends@segment.com with details on your use case and estimated throughput.
+
+## Identity Merges
+
+Personas supports up to 100 merges per profile in its identity graph. A merge occurs when two existing profile are joined together by a common external_id. For example, if a user starts their journey on mobile, and then signs in via a web application, those two user profiles are joined together by a common identifier like a user_id. Messages that attempt additional merges are usually a sign of a corrupt profile and are dropped.
+
+## Identity Mappings
+
+Personas supports up to 1000 mappings per profile in its identity graph. Mappings are external id values like a user_id, email, mobile advertising id, or any custom id's. Messages that attempt to add additional mappings are usually a sign of a corrupt profile and are dropped. Note that this limit counts mappings across all merged profiles.
