You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To gain insights into your customer email engagements, enable user engagement tracking. Only emails sent from Azure Communication Services verified email domains that are enabled for user engagement analysis can receive engagement tracking metrics.
16
16
17
17
> [!IMPORTANT]
18
-
> By enabling this feature, you are acknowledging that you are enabling open/click tracking and giving consent to collect your customers' email activity.
18
+
> By enabling this feature, you acknowledge that you are enabling open/click tracking and giving consent to collect your customers' email activity.
19
19
20
20
In this quick start, you learn how to enable user engagement tracking for a verified email domain in Azure Communication Services.
21
21
22
22
## Enable email engagement
23
+
23
24
1. Go the overview page of the Email Communications Service resource that you created in [Quickstart: Create and manage an Email Communication Service resource](./create-email-communication-resource.md).
25
+
24
26
2. In the left navigation panel, click **Provision Domains** to open a list of provisioned domains.
27
+
25
28
3. Click on the name of the custom domain that you would like to update.
26
29
27
-
:::image type="content" source="./media/email-domains-custom-provision-domains.png" alt-text="Screenshot that shows how to get to overview page for Domain from provisioned domains list.":::
30
+
:::image type="content" source="./media/email-domains-custom-provision-domains.png" alt-text="Screenshot that shows how to get to overview page for Domain from provisioned domains list.":::
28
31
29
32
When you click the custom domain name, it opens the Domain Overview page. The first time you open this page, User interaction tracking is **Off** by default.
30
33
31
34
4. Click **Turn On** to enable engagement tracking.
32
35
33
-
:::image type="content" source="./media/email-domains-custom-overview.png" alt-text="Screenshot that shows the overview page of the domain." lightbox="media/email-domains-custom-overview-expanded.png":::
36
+
:::image type="content" source="./media/email-domains-custom-overview.png" alt-text="Screenshot that shows the overview page of the domain." lightbox="media/email-domains-custom-overview-expanded.png":::
34
37
35
38
5. A confirmation dialog box opens. Click **Turn On** to confirm that you want to enable engagement tracking.
36
39
37
-
:::image type="content" source="./media/email-domains-user-engagement.png" alt-text="Screenshot that shows the user engagement turn-on page of the domain." lightbox="media/email-domains-user-engagement-expanded.png":::
40
+
:::image type="content" source="./media/email-domains-user-engagement.png" alt-text="Screenshot that shows the user engagement turn-on page of the domain." lightbox="media/email-domains-user-engagement-expanded.png":::
38
41
39
42
**Your email domain is now ready to send emails with user engagement tracking. Note that user engagement tracking applies to HTML content and does not function if you submit the payload in plaintext.**
40
43
41
44
You can now subscribe to Email User Engagement operational logs, which provide information about **open** and **click** user engagement metrics for messages sent from the email service.
42
45
43
46
> [!NOTE]
44
-
> User Engagement Tracking cannot be enabled for Azure Managed Domains or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../concepts/service-limits.md#rate-limits).
47
+
> User Engagement Tracking cannot be enabled for Azure Managed Domains or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../concepts/service-limits.md#rate-limits-for-email).
45
48
46
49
> [!IMPORTANT]
47
50
> If you plan to enable open/click tracking for your email links, ensure that you are correctly formatting the email content in HTML. Specifically, make sure that your tracking content is properly encapsulated within the payload, as follows:
51
+
48
52
```html
49
53
<ahref="https://www.contoso.com">Contoso Inc.</a>
50
54
```
51
-
---
55
+
52
56
## Next steps
53
57
54
58
- Access logs for [Email Communication Service](../../concepts/analytics/logs/email-logs.md).
55
59
56
60
## Related articles
57
61
58
-
- Familiarize yourself with the [Email client library](../../concepts/email/sdk-features.md)
59
-
-[Quickstart: How to connect Email Communication Service with an Azure Communication Services resource](../../quickstarts/email/connect-email-communication-resource.md)
62
+
- Familiarize yourself with the [Email client library](../../concepts/email/sdk-features.md).
63
+
-[Quickstart: How to connect Email Communication Service with an Azure Communication Services resource](../../quickstarts/email/connect-email-communication-resource.md).
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/email/includes/create-sender-username-resource-az-portal.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,27 +12,28 @@ ms.author: v-vprasannak
12
12
- An Azure Communication Services Email Resource created and ready to add the domains. See [Get started with Creating Email Communication Resource](../../../quickstarts/email/create-email-communication-resource.md).
13
13
- A custom domain with higher than default sending limits provisioned and ready. See [Quickstart: How to add custom verified email domains](../../../quickstarts/email/add-custom-verified-domains.md).
14
14
15
-
16
15
## Create multiple sender usernames
17
16
18
17
An email domain that is provisioned to send email has a default MailFrom address, formatted as `[email protected]`. If you configure a custom domain such as `notification.azuremails.net`, then the default MailFrom address has `[email protected]` added. You can configure and add more MailFrom addresses and FROM display names to use values that are easier to read.
19
18
20
19
> [!NOTE]
21
-
> Sender usernames cannot be enabled for Azure Managed Domains regardless of the sending limits or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../../concepts/service-limits.md#rate-limits).
20
+
> Sender usernames cannot be enabled for Azure Managed Domains regardless of the sending limits or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../../concepts/service-limits.md#rate-limits-for-email).
22
21
23
22
1. Open the Overview page of the Email Communication Service resource that you created in [Get started with Creating Email Communication Resource](../../../quickstarts/email/create-email-communication-resource.md).
23
+
24
24
2. Click **Provision Domains** on the left navigation panel to see list of provisioned domains.
25
-
3. Click on the one of the provisioned domains to open the Domain Overview page.
26
25
27
-
:::image type="content" source="../../../quickstarts/email/media/email-provisioned-domains.png" alt-text="Screenshot that shows Domain link in list of provisioned email domains." lightbox="../../../quickstarts/email/media/email-provisioned-domains-expanded.png":::
26
+
3. To open the Domain Overview page, click on the one of the provisioned domains.
27
+
28
+
:::image type="content" source="../../../quickstarts/email/media/email-provisioned-domains.png" alt-text="Screenshot that shows Domain link in list of provisioned email domains." lightbox="../../../quickstarts/email/media/email-provisioned-domains-expanded.png":::
28
29
29
30
4. Click the **MailFrom Addresses** link in left navigation to see the default `donotreply` in MailFrom addresses list.
30
31
31
32
:::image type="content" source="../../../quickstarts/email/media/email-mailfrom-overview.png" alt-text="Screenshot that explains how to list of MailFrom addresses.":::
32
33
33
34
5. Click **Add**.
34
35
35
-
:::image type="content" source="../../../quickstarts/email/media/email-domains-mailfrom-add.png" alt-text="Screenshot that explains how to change MailFrom address and display name.":::
36
+
:::image type="content" source="../../../quickstarts/email/media/email-domains-mailfrom-add.png" alt-text="Screenshot that explains how to change MailFrom address and display name.":::
36
37
37
38
6. Enter the Display Name and MailFrom address. Click **Save**.
38
39
@@ -47,6 +48,7 @@ An email domain that is provisioned to send email has a default MailFrom address
47
48
## Removing multiple sender usernames
48
49
49
50
1. Open the Domains overview page.
51
+
50
52
2. Click on **MailFrom addresses** link in left navigation to see the MailFrom addresses list.
51
53
52
54
:::image type="content" source="../../../quickstarts/email/media/email-mailfrom-overview-updated.png" alt-text="Screenshot that shows MailFrom addresses." lightbox="../../../quickstarts/email/media/email-mailfrom-overview-updated-expanded.png":::
0 commit comments