Merge pull request #5406 from segmentio/broadcast-ga-updates

Add Broadcasts GA updates

Author: pwseg

src/engage/campaigns/broadcasts.md

@@ -3,9 +3,6 @@ title: Broadcasts
 plan: engage-premier
 ---
 
-> info ""
-> Broadcasts are in public beta.
-
 Broadcasts are one-time email or SMS campaigns that you can send with Twilio Engage. Use broadcasts for single, one-off occasions like the following:
 
 - **Special events**, like webinars or conferences
@@ -14,7 +11,7 @@ Broadcasts are one-time email or SMS campaigns that you can send with Twilio Eng
 
 For more on the different types of Engage campaigns, read [Audiences, Journeys, and Broadcasts](/docs/guides/audiences-and-journeys/).
 
-On this page, you'll find step by step instructions for how to create a broadcast.
+On this page, you'll find step by step instructions for how to create a broadcast, as well as information on broadcast best practices and analytics.
 
 ## Create and send an email broadcast
 
@@ -25,16 +22,20 @@ Follow these steps to create an email broadcast:
 3. Add a name and description, then click **Choose recipients**.
 4. Click **Add condition** to add users who will receive your campaign, then click **Build**.
     - To send a message to a pre-built audience, choose `Part of an Audience`, then select the audience.
-5. Select **Build a new email** or use an email template, then click **Continue**.
-6. Fill out the **Email settings** fields, choose your email editor, then click **Continue**.
-7. Configure your email, then click **Continue**.
-8. On the **Review and schedule** page, confirm your broadcast's settings.
-9. Schedule your broadcast:
+    - To exclude users from the audience, click **Add condition** in the **And who** section. Click **And who**, then select **And not who**. Segment will exclude users from the audience you choose.
+5. Click **Preview** to estimate the audience size.
+6. Select the subscription group that you want to receive your broadcast.
+    - Segment recommends only sending broadcasts to users with a `subscribed` status. 
+7. Select **Build**, then choose either **Build a new email** or select a template.
+8. Fill out the **Email settings** fields, choose your email editor, then click **Continue**.
+9. Configure your email, then click **Continue**.
+10. On the **Review and schedule** page, confirm your broadcast's settings.
+11. Schedule your broadcast:
     - To send your broadcast immediately, select **Send now**, then click **Send now ->**. Confirm a final time by clicking **Send** in the popup.
     - To send your broadcast later, select **Schedule**, then enter the date, time, and time zone for your scheduled broadcast. Click **Schedule ->**, then confirm by clicking **Schedule** in the **Schedule message** popup.
 
 > info ""
-> It's best practice to only send emails to users with a `subscribed` status. However, if you need to send an email broadcast to someone who hasn't subscribed, you can configure an email to [send to all users](/docs/engage/campaigns/email-campaigns/#send-an-email-to-all-users/).
+> Segment recommends sending email broadcasts to users with a `subscribed` status. However, if you need to send an email broadcast to someone who hasn't subscribed, you can configure an email to [send to all users](/docs/engage/campaigns/email-campaigns/#send-an-email-to-all-users/).
 
 ## Create and send an SMS broadcast
 
@@ -45,9 +46,13 @@ Follow these steps to create an email broadcast:
 3. Add a name and description, then click **Choose recipients**.
 4. Click **Add condition** to add users who will receive your campaign, then click **Build**.
     - To send a message to a pre-built audience, choose `Part of an Audience`, then select the audience.
-5. Select **Build a new SMS** or use an SMS template, then click **Continue**.
-6. Choose a messaging service, enter your message into the body field, and add any merge tags. 
-7. Test your SMS, then select **Review and schedule**.
+    - To exclude users from the audience, click **Add condition** in the **And who** section. Click **And who**, then select **And not who**. Segment will exclude users from the audience you choose.
+5. Click **Preview** to estimate the audience size.
+7. Select **Build**.
+8. Choose a messaging service, enter your message into the body field, and add any merge tags. 
+    - (Optional:) Test your SMS.
+    - Include opt out instructions; your SMS broadcast must contain `Reply STOP to unsubscribe`.
+9. Test your SMS, then select **Review and schedule**.
 8. On the **Review and schedule** page, confirm your broadcast's settings.
 9. Schedule your broadcast:
     - To send your broadcast immediately, select **Send now**, then click **Send now ->**. Confirm a final time by clicking **Send** in the popup.
@@ -82,17 +87,39 @@ To learn more, view SendGrid's [email limits](https://docs.sendgrid.com/api-refe
 
 ### Scale and throughput
 
-The following table lists geographic availability, scale, and speed details for email broadcasts and [short code SMS](https://support.twilio.com/hc/en-us/articles/223182068-What-is-a-Messaging-Short-Code-){:target="_blank"} broadcasts:
+The following table lists geographic availability, scale, and speed details for email and SMS broadcasts:
+
+| Broadcast type        | Availability   | Throughput            |
+| --------------------- | -------------- | --------------------- |
+| Email                 | US and EU      | 5 million per hour    |
+| SMS short code        | US, Canada, UK | 360,000 per hour      |
+| SMS long code (10DLC) | US, Canada     | Trust-score dependent |
 
-| Broadcast type | Availability                            | Throughput                                                                 |
-| -------------- | --------------------------------------- | -------------------------------------------------------------------------- |
-| Email          | All countries where Engage is available | 1 million per hour                                                         |
-| SMS short code | US, Canada, UK                          | 360,000 per hour                                                            |
 
 Long-code message throughput depends on a number of factors, including your [10DLC trust score](https://support.twilio.com/hc/en-us/articles/1260803225669-Message-throughput-MPS-and-Trust-Scores-for-A2P-10DLC-in-the-US){:target="_blank"}. 
 
 Segment recommends that you use short code phone numbers for SMS broadcasts sent to more than 5000 recipients.
 
 ## Broadcast analytics
 
-Engage tracks analytics for both email and SMS broadcasts. For more information on Engage analytics, view [Analytics Overview](/docs/engage/analytics/).
+Segment provides analytics for each broadcast. By selecting a sent broadcast from the broadcasts list, you can view both high-level performance metrics and granular insights on what actions individual recipients have taken on the Broadcast campaign.
+
+Engage powers analytics for both email and SMS broadcasts. For more information on Engage analytics, view [Analytics Overview](/docs/engage/analytics/).
+
+## Review sent broadcasts 
+
+To view information for a sent broadcast, navigate to **Engage > Broadcasts**, and select a broadcast from the broadcasts list.
+
+### Content tab
+
+The content tab shows the message content and email or SMS settings that you configured for the broadcast.
+
+### Recipients tab
+
+Segment maintains a recipients list for broadcasts. The recipients list lets you filter through several analytics statuses. Selecting an individual profile from the recipients list opens a preview pane with that profile's details.
+
+### Settings tab
+
+The settings tab shows your broadcast's setup info, the recipient audience and its subscription status, as well as the broadcast's scheduled time.
+
+On the settings tab, you can also find the broadcast's campaign key, which you can use to reference the broadcast. For example, you can use the campaign key to create an audience for future targeting or to create a suppression list of recipients you don't want to receive future broadcasts.