Merge pull request #3076 from segmentio/issue/2934

updates to braze [Issue 2934]

Author: stayseesong

src/connections/destinations/catalog/braze-cloud-mode-actions/index.md

@@ -28,6 +28,8 @@ Braze Cloud Mode (Actions) provides the following benefit over Braze Classic:
    - **App ID**: The app identifier used to reference specific Apps in requests made to the Braze API. Created under Developer Console in the Braze Dashboard.
    - **REST Endpoint**: Your Braze REST Endpoint. For more information, see [API Overview](https://www.braze.com/docs/api/basics/){:target="_blank"} in the Braze documentation.
 
+> info ""
+> Braze requires that you include a `userId` or `braze_id` for all calls made in cloud-mode. Segment sends a `braze_id` if the `userId` is missing. When you use a device-mode connection, Braze automatically tracks anonymous activity using the `braze_id` if a `userId` is missing.
 
 {% include components/actions-fields.html settings="true"%}
 
@@ -40,4 +42,3 @@ Braze Cloud Mode (Actions) provides the following benefit over Braze Classic:
 
 Keep the following in mind if you plan to move to Braze (Actions) from the classic Braze destination.
 {% include components/actions-map-table.html name="braze-cloud" %}
-

src/connections/destinations/catalog/braze-web-device-mode-actions/index.md

@@ -28,6 +28,10 @@ Braze Web Mode (Actions) provides the following benefits over Braze Classic:
 2. Search for "Braze" in the Catalog, select **Braze Web Mode (Actions)**, and choose which of your sources to connect the destination to.
 3. Configure the Connection Settings. **API Key** and **SDK Endpoint** are required settings.
 
+> info ""
+> If you're using a device-mode connection, Braze's SDK assigns a `device_id` and a backend identifier, `braze_id`, to every user. This allows Braze to capture anonymous activity from the device by matching on those identifiers instead of `userId`. This applies to _device-mode connections_.
+
+
 {% include components/actions-fields.html settings="true"%}
 
 {% include components/actions-fields.html%}
@@ -170,4 +174,3 @@ For more details on this snippet, see Braze's documentation [here](https://www.b
 
 Keep the following in mind if you plan to move to Braze (Actions) from the classic Braze destination.
 {% include components/actions-map-table.html name="braze-web" %}
-