Deploy - December 10, 2024

_docs/_api/objects_filters/messaging/android_object.md

@@ -30,14 +30,15 @@ You must include an Android push object in `messages` if you want users you have
    // Specifying "default" in the sound field will play the standard notification sound
    "sound": (optional, string) the location of a custom notification sound within the app,
    "custom_uri": (optional, string) a web URL, or Deep Link URI,
+   "use_webview": (optional, boolean) whether to open the web URL inside the app if the action is "URI", defaults to false,
    "summary_text": (optional, string),
    "time_to_live": (optional, integer (maximum of 2,419,200 seconds)),
    "notification_id": (optional, integer),
    "push_icon_image_url": (optional, string) an image URL for the large icon,
    "accent_color": (optional, integer) accent color to be applied by the standard Style templates when presenting this notification, an RGB integer value,
    "send_to_most_recent_device_only": (optional, boolean) defaults to false, if set to true, Braze will only send this push to a user's most recently used Android device, rather than all eligible Android devices,
    "buttons" : (optional, array of Android push action button objects) push action buttons to display
-   "conversation_data" : (optional, Android Conversation Push Object) the data to be displayed through Conversation Push.
+   "conversation_data" : (optional, Android Conversation Push Object) the data to be displayed through Conversation Push
 }
 ```
 

_docs/_api/objects_filters/messaging/apple_object.md

@@ -27,6 +27,7 @@ description: "This reference article lists and explains the different Apple obje
    "relevance_score": (optional, float) specifies the relevance score between 0.0 and 1.0 used for grouping notification summaries (iOS 15+),
    "expiry": (optional, ISO 8601 date string) if set, push messages will expire at the specified datetime,
    "custom_uri": (optional, string) a web URL, or Deep Link URI,
+   "use_webview": (optional, boolean) whether to open the web URL inside the app if the action is "URI", defaults to true,
    "message_variation_id": (optional, string) used when providing a campaign_id to specify which message variation this message should be tracked under (must be an iOS Push Message),
    "notification_group_thread_id": (optional, string) the notification group thread ID the notification will be sent with,
    "asset_url": (optional, string) content URL for rich notifications for devices using iOS 10 or higher,

_docs/_developer_guide/platform_wide/banner_cards.md → _docs/_developer_guide/banner_cards.md

@@ -1,7 +1,6 @@
 ---
 nav_title: Banner Cards
 article_title: Banner Cards
-page_order: 4
 layout: dev_guide
 hidden: true
 guide_top_header: "Banner Cards"
@@ -12,15 +11,17 @@ channel:
 
 guide_featured_title: "Section articles"
 guide_featured_list:
+- name: Creating placements
+  link: /docs/developer_guide/banner_cards/creating_placements/
+  image: /assets/img/braze_icons/compass-01.svg
 - name: Creating Banner Cards
   link: /docs/create_banner_card/
   image: /assets/img/braze_icons/channel-content-cards.svg
 - name: Integrating Banner Cards
-  link: /docs/developer_guide/platform_wide/banner_cards/integration/
+  link: /docs/developer_guide/banner_cards/integration/
   image: /assets/img/braze_icons/code-01.svg
 ---
 
 {% alert important %}
 Banner Cards are currently in early access. Contact your Braze account manager if you’re interested in participating in this early access.
 {% endalert %}
-

_docs/_developer_guide/banner_cards/creating_placements.md

@@ -0,0 +1,54 @@
+---
+nav_title: Creating placements
+article_title: Creating Banner Card placements for the Braze SDK
+hidden: true
+description: "This reference article covers Banner Cards and how to integrate this feature in the Braze SDK."
+platform:
+  - iOS
+  - Android
+  - Web
+
+---
+
+# Creating Banner Card placements
+
+> Before launching a Banner Card campaign in your app, you'll need to create a placement in the Braze dashboard. Placements are locations that you define in your app that can display Banner Cards.
+
+{% alert important %}
+Banner Cards are currently in early access. Contact your Braze account manager if you’re interested in participating in this early access.
+{% endalert %}
+
+## Prerequisites
+
+These are the minimum SDK versions to start using Banner Cards:
+
+{% sdk_min_versions swift:11.3.0 android:33.1.0 web:5.6.0 %}
+
+## Creating a placement
+
+### Step 1: Create a new placement
+
+Go to **Settings** > **Banner Cards Placements**, then select **Create Placement**.
+
+![Banner Card Placements section to create placement IDs.]({% image_buster /assets/img/banner_cards/create_placement.png %})
+
+### Step 2: Fill in the details
+
+Name your placement and give it a **Placement ID**. Optionally, you can add a description for your placement.
+
+Work with your marketing team to create this ID. This is the ID you'll reference in your app's code, and your marketing team will use the ID to assign a campaign to the location in your app. 
+
+{% alert important %}
+Avoid editing your placement ID after launch, as this can break the integration with your app or website.
+{% endalert %}
+
+![Placement details that designate a Banner Card will display in the left sidebar for spring sale promotion campaigns.]({% image_buster /assets/img/banner_cards/placement_details_example.png %})
+
+For steps on how to launch a Banner Card campaign, refer to [Creating a Banner Card]({{site.baseurl}}/create_banner_card/).
+
+## Next steps
+
+Now that you've created your Banner Card placements, you can:
+
+- [Integrate Banner Cards]({{site.baseurl}}/developer_guide/banner_cards/integration/)
+- [Create Banner Cards]({{site.baseurl}}/create_banner_card/)

_docs/_developer_guide/platform_wide/banner_cards/integration.md → _docs/_developer_guide/banner_cards/integration.md

@@ -1,6 +1,6 @@
 ---
-nav_title: Integrating Banner Cards
-article_title: Integrating Banner Cards
+nav_title: Banner Cards
+article_title: Banner Cards for the Braze SDK
 hidden: true
 description: "This reference article covers Banner Cards and how to integrate this feature in the Braze SDK."
 platform:
@@ -12,43 +12,23 @@ platform:
 
 # Integrating Banner Cards
 
-Similar to [Content Cards]({{site.baseurl}}/user_guide/message_building_by_channel/content_cards/about), Banner Cards are embedded directly in your app or website so that you can engage users with an experience that feels natural. They’re a quick and seamless solution to create personalized messaging for your users all while extending the reach of other channels (such as email or push notifications).
+> Similar to [Content Cards]({{site.baseurl}}/user_guide/message_building_by_channel/content_cards/about), Banner Cards are embedded directly in your app or website so that you can engage users with an experience that feels natural. They’re a quick and seamless solution to create personalized messaging for your users all while extending the reach of other channels (such as email or push notifications).
 
 {% alert important %}
 Banner Cards are currently in early access. Contact your Braze account manager if you’re interested in participating in this early access.
 {% endalert %}
 
-This feature is available as of the following [SDK versions]({{site.baseurl}}/user_guide/engagement_tools/campaigns/ideas_and_strategies/new_features/#filtering-by-most-recent-app-versions):
+## Prerequisites
 
-{% sdk_min_versions swift:11.3.0 android:33.1.0 web:5.6.0 %}
-
-## Dashboard prerequisites
-
-### Define placements {#define-placements}
-
-Before launching a Banner Card campaign in your app, you must set up a placement in the Braze dashboard. Placements are locations that you define in your app that can display Banner Cards.
-
-#### Step 1: Create a new placement
-
-Go to **Settings** > **Banner Cards Placements**, then select **Create Placement**.
-
-![Banner Card Placements section to create placement IDs.]({% image_buster /assets/img/banner_cards/create_placement.png %})
-
-#### Step 2: Fill in the details
+Before you can integrate Banner Cards, you'll need to [create Banner Card placements]({{site.baseurl}}/developer_guide/banner_cards/creating_placements) in your app.
 
-Name your placement and give it a **Placement ID**. Optionally, you can add a description for your placement.
+In addition, these are the minimum SDK versions needed to start using Banner Cards:
 
-Work with your marketing team to create this ID. This is the ID you'll reference in your app's code, and your marketing team will use the ID to assign a campaign to the location in your app. 
-
-{% alert important %}
-Avoid editing your placement ID after launch, as this can break the integration with your app or website.
-{% endalert %}
-
-![Placement details that designate a Banner Card will display in the left sidebar for spring sale promotion campaigns.]({% image_buster /assets/img/banner_cards/placement_details_example.png %})
+{% sdk_min_versions swift:11.3.0 android:33.1.0 web:5.6.0 %}
 
-For steps on how to launch a Banner Card campaign, refer to [Creating a Banner Card]({{site.baseurl}}/create_banner_card/).
+## Integrating Banner Cards
 
-## Refresh placements in your app {#requestBannersRefresh}
+### Step 2: Refresh placements in your app {#requestBannersRefresh}
 
 Placements can be requested each session and will be cached automatically when a user's session expires or when you change identified users using the `changeUser` method.
 
@@ -119,7 +99,7 @@ This feature is not currently supported on Roku.
 {% endtab %}
 {% endtabs %}
 
-## Listen for updates {#subscribeToBannersUpdates}
+### Step 3: Listen for updates {#subscribeToBannersUpdates}
 
 {% alert tip %}
 If you insert banners using the SDK methods in this guide, all analytics events will be handled automatically. If you want to manually render the HTML, [let us know](mailto:banners-feedback@braze.com).
@@ -202,7 +182,7 @@ This feature is not currently supported on Roku.
 {% endtab %}
 {% endtabs %}
 
-## Get and insert a Banner Card by placement ID {#insertBanner}
+### Step 4: Insert cards by placement ID {#insertBanner}
 
 {% tabs %}
 {% tab JavaScript %}
@@ -411,15 +391,10 @@ This feature is not currently supported on Roku.
 
 {% enddetails %}
 
-## Best practices
-
-### Banner Card dimensions and sizing
+## Dimensions and sizing
 
-- No dimension information is sent from Braze.
-
-{% alert note %}
-The composer allows a user to preview banners in different dimensions. That information is not saved or sent to the SDK.
-{% endalert %}
+Here's some things to know about Banner Card dimensions and sizing:
 
+- While the composer let's you preview banners in different dimensions, that information is not saved or sent to the SDK.
 - The HTML will take up the full width of the container it's rendered in.
-- As a best practice, we recommend making a fixed dimension element and testing those dimensions in composer.
+- We recommend making a fixed dimension element and testing those dimensions in composer.