Merge pull request #8210 from braze-inc/develop

Leftover deployment - October 3, 2024

_docs/_api/objects_filters/user_alias_object.md

@@ -16,6 +16,7 @@ The user alias object consists of two parts: an `alias_name` for the identifier
 This object is used frequently in all of our endpoints, and oftentimes within other objects.
 
 ## Object body
+
 ```json
 {
   "user_alias" : {
@@ -24,3 +25,15 @@ This object is used frequently in all of our endpoints, and oftentimes within ot
   }
 }
 ```
+
+### Example
+
+```json
+{
+  "user_alias": {
+    "alias_name": "john_doe_123",
+    "alias_label": "email_id"
+  },
+  "external_id": "user_456"
+}
+```

_docs/_developer_guide/platform_wide/feature_flags/create.md

@@ -92,7 +92,7 @@ By default, Feature flags are always disabled, which allows you to separate your
 Do not set your rollout traffic above 0% until you are ready for your new feature to go live. When you initially define your feature flag in the dashboard, leave this setting at 0%.
 {% endalert %}
 
-## Verifying the feature flag {#enabled}
+## Using the "enabled" field for your feature flags {#enabled}
 
 Once you have defined your feature flag, configure your app or site to check whether or not it is enabled for a particular user. When it is enabled, you'll set some action or reference the feature flag's variable properties based on your use case. The Braze SDK provides getter methods to pull your feature flag's status and its properties into your app. 
 

_docs/_developer_guide/platform_wide/feature_flags/experiments.md

@@ -52,6 +52,8 @@ Though you specified default properties when you originally set up your feature
 
 To edit, add, or remove additional default properties, edit the feature flag itself from **Messaging** > **Feature Flags**.
 
+When a variant is disabled, the SDK will return an empty properties object for the given feature flag. 
+
 ## Step 3: Choose users to target
 
 Next, you need to [target users]({{site.baseurl}}/user_guide/engagement_tools/campaigns/building_campaigns/targeting_users/) by choosing segments or filters to narrow down your audience. Segment membership is calculated when feature flags are refreshed for a given user.

_docs/_user_guide/brazeai/generative_ai/ai_copywriting/brand_guidelines.md

@@ -7,35 +7,58 @@ description: "This reference article covers the brand guidelines for AI copywrit
 
 # Brand guidelines for AI copywriting assistant
 
-> Create and apply brand guidelines to tailor the style of the copy generated by the AI copywriting assistant to your brand and voice.
+> Tailor the style of your AI-generated copy to match your brand’s voice and personality with customized brand guidelines.
 
 ## Creating brand guidelines {#steps}
 
-To create new brand guidelines for use in the AI Copywriting Assistant, follow these steps:
+Follow these steps to create brand guidelines in the AI copywriting assistant.
 
-1. Open the AI copywriting assistant.
-2. Select **Apply brand guideline** and then select **Create a brand guideline**.
-2. Enter a name for this guideline. It will serve as the label you see in the previous selection.
-3. For **When will you use these brand guidelines?**, describe the context or type of marketing in which you will use this guideline.
-4. For **Brand personality**, describe the personality of your brand, such as any traits, values, voice, and archetype.
-5. (Optional) For **Exclusions**, add any language or style that should be avoided in generated content. For example, you can exclude "sarcasm", "negative attitudes", "condescending", and other personality traits that you don't want.
-6. Fine-tune your guidelines by testing them. To generate example copy with these guidelines, expand **Test your guidelines** and enter a prompt.
-7. When you're satisfied, select **Save brand guideline**.
+### Step 1: Create a brand guideline
+
+1. From your message composer, select <i class="fa-solid fa-wand-magic-sparkles"></i> **Launch AI Copywriter**.
+   * In the drag-and-drop editor for in-app messages, select a text block and select <i class="fa-solid fa-wand-magic-sparkles" title="AI Copywriter"></i> in the block's toolbar.
+2. Select **Apply brand guideline** and then **Create a brand guideline**.
+3. Enter a name for this guideline. It will be the label you see in the previous selection.
+4. For **When will you use these brand guidelines?**, add details to help your colleagues (and future you) understand the context for using this guideline.
+
+![Brand guideline creation view.][1]
+
+### Step 2: Describe your brand personality
+
+For **Brand personality**, think about what makes your brand unique. Include traits, values, voice, and any archetypes that define your brand. Here are some characteristics to consider:
+
+| **Characteristic**       | **Definition**                                                                       | **Example**                                                        |
+|--------------------------|--------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| Reputation               | How you want your brand to be perceived in the market.                               | We are known for being the most reliable and customer-focused brand in our industry. |
+| Personality traits       | Human-like characteristics that describe your brand’s character.                     | Our brand is friendly, approachable, and always upbeat.          |
+| Values                   | Core values that guide your brand’s actions and decisions.                           | We value sustainability, transparency, and community.            |
+| Differentiation          | Unique qualities that set your brand apart from competitors.                         | We stand out by offering personalized customer service that goes above and beyond. |
+| Brand voice              | The tone and style of communication your brand uses.                                 | Our voice is casual yet informative, ensuring clarity without being too formal. |
+| Brand archetype          | The archetype that represents your brand’s persona (The Hero, The Creator, and so on).    | We embody the ‘Explorer’ archetype, always seeking new challenges and adventures. |
+{: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3}
 
-You can now return to the copywriting view. Your new guidelines will be saved to your workspace for future use.
+### Step 3: Define language that should be avoided (optional)
+
+For **Exclusions**, list any language or style that doesn’t align with your brand. For example, you might want to avoid "sarcasm," "negative attitudes," or "condescending" tones.
+
+### Step 4: Test your guidelines
+
+Test your guidelines to see how they perform. Expand **Test your guidelines** to generate example copy and adjust as needed.
+
+### Step 5: Save your guidelines
+
+When you're happy with your guidelines, select **Save brand guideline**. Your new guidelines will be saved in your workspace for future use.
 
 {% alert important %}
-You can change the output language regardless of what language your copy is in, but neither Braze nor OpenAI guarantee the quality of translation. You should test and verify translations before using them.
+You can change the output language regardless of what language your copy is in, but neither Braze nor OpenAI guarantee the quality of translation. Always test and verify translations before using them.
 {% endalert %}
 
-![Brand guideline creation view"][1]
-
 ## Editing guidelines
 
-To edit existing brand guidelines:
+To edit your existing brand guidelines:
 
 1. Open the AI copywriting assistant.
-2. Apply the brand guidelines you want to edit. A button will appear near the field.
+2. Apply the brand guidelines you want to change. A button will appear near the field.
 3. Select **Edit guideline**.
 
 ## How is my data used and sent to OpenAI?

_docs/_user_guide/data_and_analytics/cloud_ingestion/file_storage_integrations.md

@@ -186,7 +186,7 @@ Cloud Data Ingestion supports JSON, CSV, and Parquet files. Each file must conta
     - `ALIAS_NAME` and `ALIAS_LABEL` - These two columns create a user alias object. `alias_name` should be a unique identifier, and `alias_label` specifies the type of alias. Users may have multiple aliases with different labels but only one `alias_name` per `alias_label`.
     - `BRAZE_ID` - The Braze user identifier. This is generated by the Braze SDK, and new users cannot be created using a Braze ID through Cloud Data Ingestion. To create new users, specify an external user ID or user alias.
     - `EMAIL` - The user's email address. If multiple profiles with the same email address exist, the most recently updated profile will be prioritized for updates. If you include both email and phone, we will use the email as the primary identifier.
-    - `PHONE` - The user's email address. If multiple profiles with the same phone number exist, the most recently updated profile will be prioritized for updates. 
+    - `PHONE` - The user's phone number. If multiple profiles with the same phone number exist, the most recently updated profile will be prioritized for updates. 
 - `PAYLOAD` - This is a JSON string of the fields you want to sync to the user in Braze.
 
 {% alert note %}