Skip to content

Commit 01115a9

Browse files
pwsegpwseg
committed
Add Content for Subscription Groups GA
1 parent 3e76932 commit 01115a9

File tree

4 files changed

+121
-15
lines changed

4 files changed

+121
-15
lines changed

‎src/_data/sidenav/main.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -352,6 +352,8 @@ sections:
352352
title: Set User Subscriptions
353353
- path: /engage/user-subscriptions/subscription-states
354354
title: Subscription States
355+
- path: /engage/user-subscriptions/subscription-groups
356+
title: Subscription Groups
355357
- path: /engage/user-subscriptions/subscription-sql
356358
title: Subscriptions with SQL Traits
357359
- section_title: Profiles

‎src/connections/sources/catalog/cloud-apps/engage-events/index.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -58,21 +58,23 @@ Twilio powers Engage SMS delivery. For more information, view [Twilio's document
5858

5959
{% faqitem Email events %}
6060

61-
| Event | Definition |
62-
| ------------------------ | ------------------------------------------------------------------------------------- |
63-
| Email Processed | An email was processed and is ready to be delivered. |
64-
| Email Deferred | The receiving server temporarily rejected the email. |
65-
| Email Delivered | An email was successfully delivered to the receiving server. |
66-
| Email Opened | The recipient opened the email. |
67-
| Email Link Clicked | The recipient clicked a link within the email. |
68-
| Email Bounced | The receiving server permanently rejected the email. |
69-
| Email Dropped | The email was dropped before delivery. |
70-
| Email Marked as Spam | The recipient marked the email as spam. |
71-
| Email Machine Opened | The email was [machine opened](/docs/engage/analytics/#understanding-machine-opens). |
72-
| Email Unsubscribed | The recipient unsubscribed from all emails. |
73-
| Email Group Unsusbcribed | The recipient unsubscribed from a specific group. |
74-
| Email Subscribed | The recipient subscribed to all emails. |
75-
| Email Group Subscribed | The recipient subscribed to a specific group. |
61+
| Event | Definition |
62+
| ---------------------------- | ------------------------------------------------------------------------------------ |
63+
| Email Processed | An email was processed and is ready to be delivered. |
64+
| Email Deferred | The receiving server temporarily rejected the email. |
65+
| Email Delivered | An email was successfully delivered to the receiving server. |
66+
| Email Opened | The recipient opened the email. |
67+
| Email Link Clicked | The recipient clicked a link within the email. |
68+
| Email Bounced | The receiving server permanently rejected the email. |
69+
| Email Dropped | The email was dropped before delivery. |
70+
| Email Marked as Spam | The recipient marked the email as spam. |
71+
| Email Machine Opened | The email was [machine opened](/docs/engage/analytics/#understanding-machine-opens). |
72+
| Email Unsubscribed | The recipient unsubscribed from all emails. |
73+
| Email Group Unsusbcribed | The recipient unsubscribed from a specific group. |
74+
| Email Subscribed | The recipient subscribed to all emails. |
75+
| Email Group Subscribed | The recipient subscribed to a specific group. |
76+
| Channel Subscription Updated | The user's subscription state was globally updated. |
77+
| Group Subscription Updated | A change was made to the user's subscription state for a specific group. |
7678

7779
<br>
7880

‎src/engage/images/subscription_groups.png

109 KB
Loading

‎src/engage/user-subscriptions/subscription-groups.md

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
title: Subscription Groups
3+
plan: engage-premier
4+
---
5+
6+
Subscription groups let your users choose the emails they want to recieve from you. This page introduces subscription groups and explains how you can use them with [Engage email campaigns](/docs/engage/campaigns/email-campaigns/).
7+
8+
## About subscription groups
9+
10+
A subscription group let you send emails campaigns to specific groups of users. Subscription groups also give your customers the ability to manage their email preferences, ensuring they only get emails they want to receive.
11+
12+
For example, you may want to create a subscription group that will receive only promotional email campaigns. Should a customer decide to opt out of your promotional campaigns, they'll still be able to receive email campaigns from other subscription groups you've created and to which they've subscribed.
13+
14+
### What your users experience
15+
16+
With subscription groups, your customers can opt in and out of groups on an individual basis instead of unsubscribing from all your campaigns.
17+
18+
Your customers will have the chance to opt in and out of subscription groups on both a subscription preferences page and on the landing page that launches when they unsubscribe.
19+
20+
Customers can access these pages through the [unsubscribe and manage preference links](/docs/engage/content/email/editor/#add-unsubscribe-links) that you include in your [email templates](/docs/engage/content/email/template/).
21+
22+
![The subscription preferences page users see when opting in and out of subscription groups](../images/subscription_groups.png)
23+
24+
## Using subscription groups
25+
26+
To use a subscription group, you'll need to first create the group, add subscribers, then create a new email template.
27+
28+
### Create a subscription group
29+
30+
Follow these steps to create a subscription group:
31+
32+
1. Navigate to **Engage > Engage settings > Subscriptions**.
33+
2. Click **+Create subscription group**.
34+
3. Add a name and description for the group, then click **Next**.
35+
4. (Optional:) Add subscribers to your group with a CSV file upload, then click **Next**.
36+
5. Review your new subscription group, then click **Create Subscription Group**.
37+
38+
### Add group susbcribers
39+
40+
In addition to adding group subscribers when you first create a subscription group, you can also add subscribers to existing groups with a CSV file upload with these steps:
41+
42+
1. Navigate to **Engage > Engage settings > Subscriptions**.
43+
2. From the Subscription groups table, select the more options icon, then click **Add group subscribers**.
44+
3. Download the template CSV file, then fill it out by entering email addresses and subscription groups. The subscription group should follow the format `[group_name]_subscription_status`.
45+
4. Upload the CSV file, then click **Add Subscribers**.
46+
47+
### Create a new email template and send an email
48+
49+
> info ""
50+
> To use subscription groups, you'll need to create a new email template with new unsubscribe and manage preference links.
51+
52+
Once you've created a subscription group and added subscribers to it, follow these steps to send to the group:
53+
54+
1. [Build a new email template](/docs/engage/content/email/template/#build-an-email-template). The template should include both unsubscribe and manage preferences links. For more on special links, view [Add unsubscribe links](/docs/engage/content/email/editor/#add-unsubscribe-links).
55+
2. During email setup, select the subscription group you want to send to from the **Which subscription states should receive this message?** dropdown, then finish [setting up and publishing your campaign](/docs/engage/campaigns/email-campaigns/#create-test-and-publish-your-email-campaign).
56+
57+
## Frequently asked questions
58+
59+
{% faq %}
60+
{% faqitem How many subscription groups can I have? %}
61+
Your Engage space includes up to 25 subscription groups.
62+
{% endfaqitem %}
63+
64+
{% faqitem Can I use subscription groups with templates I've already built? %}
65+
No. Templates you've previously created aren't compatible with subscription groups. To use subscription groups, you'll need to create new templates that include new unsubscribe and manage preference links.
66+
{% endfaqitem %}
67+
68+
{% faqitem What happens if I delete a subscription group? %}
69+
If you delete a subscription group, Engage will still maintain the preferences of the group's end users.
70+
{% endfaqitem %}
71+
72+
{% faqitem What subscription group events does the Engage Channels Source send? %}
73+
The [Engage Events Source](/docs/connections/sources/catalog/cloud-apps/engage-events/) tracks four subscription group events: `Email Unsubscribed`, `Email Group Unsubscribed`, `Channel Subscription Updated`, and `Group Subscription Updated`.
74+
75+
{% endfaqitem %}
76+
77+
{% faqitem How can users opt back in if they've unsubscribed from all groups? %}
78+
If a user unsubscribes from all of your subscription groups, they'll need to re-subscribe by explicitly opting back in to each group.
79+
{% endfaqitem %}
80+
81+
{% faqitem Do subscription preference links work in test emails? %}
82+
Yes. Test emails include fully functional unsubscribe and subscription preference links. If a test email recipient unsubscribes using a test email, Segment updates that user's subscription state. <br><br>
83+
84+
Test emails temporarily override an email subscription state. This means that an unsubscribed email address can receive a test email but won't receive regular email campaigns from which they've unsubscribed.
85+
{% endfaqitem %}
86+
87+
{% faqitem Should I follow any conventions when naming a subscription group? %}
88+
89+
Yes. Keep the following table in mind when you name a subscription group:
90+
91+
<br>
92+
93+
| Field | Convention |
94+
| --------------------------------------------- | ------------------------------------------------------------------- |
95+
| Group Name Character Limit | Limited to 75 characters, including spaces |
96+
| Group Description Character Limit | Limited to 500 characters, including spaces |
97+
| Spaces in Group Names | Spaces aren't allowed at the beginning and/or end of the Group name |
98+
| Unsupported characters for Group Names | `!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?` |
99+
| Unsupported accent characters for Group Names | `á, é, í, ó, ú, à, è, ì, ò, ù, ë, ï, ã` |
100+
{% endfaqitem %}
101+
102+
{% endfaq %}

0 commit comments

Comments
 (0)