Skip to content

Add Broadcasts GA updates #5406

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 22, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 46 additions & 19 deletions src/engage/campaigns/broadcasts.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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

Expand All @@ -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

Expand All @@ -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.
Expand Down Expand Up @@ -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.