All Products
Search
Document Center

Direct Mail:How Do I Enable The Data Tracking Feature?

Last Updated:Feb 21, 2024

This topic describes how to enable and use the data tracking feature to trace the data of opens and clicks.

Preconditions

1. In the Direct Mail console, create an email domain. In the Singapore (Singapore) or Australia (Sydney) region, you do not need to file the email domain. In the China (Hangzhou) region, perform the following steps to file the email domain. Choose ICP > Start IPC Filing to go to the ICP Filing page. On ICP Filing page, specify the required information.

2. You must configure the CNAME Record Verification parameter when you configure the email domain. The value of the parameter contains click records. The records help you collect the data of clicks. After the CNAME record is verified, the email domain is in the Verification successful state in the Direct Mail console.

image

For more information, see How do I configure a domain name on a DNS server?

3. Send emails by using the sender address that is created based on the verified email domain.

4. Create a strong dependency tag to track emails. On the Email Tags page, create a tag. Then, add the tag to subsequent emails.

Point of Attention

The data of opens and clicks is updated and persistently stored every hour on the hour. You can view the tracking data of the current hour in the console after 15 minutes of the next hour.

Limits

1. You must add an existing email tag to the emails that you want to send.

2. Only links that you want to track in the HTML format are supported. The content of each email must contain a document that is enclosed within a body tag. Example: <body>Content of your email</body>.

3. A link that you want to track must be included in an HTML file. Example:<html><body><a href=Sample link></body></html>. The link must be prefixed with http:// or https://.

Methods

DirectMail Console

In the New Email Task dialog box, select Enable in the Recipient Tracking section. The data of opens and clicks is recorded.

1330c464d6835a16afdd418ae3c9eaf9.png

The email content must comply with the preceding limits.

API or SDK

1. When you call an API operation or SDK to send an email, you must add an existing tag and set the ClickTrace parameter to 1. 1 is of the string type.

2. Set the setHtmlBody parameter to the content of the email. The email content must comply with the preceding limits.

SMTP

Referring to Track Email Open and Click Operation Based on Tags to set the email head "X-AliDM-Trace" , where tag must be created in the console, OpenTrace is assigned the string "1", and LinkTrace is assigned the string "1". Currently, only Java samples are provided, and other languages can be modified according to this logic.

Limit

The Multipurpose Internet Mail Extensions (MIME) type of the content of an email that is sent over SMTP is text/html;charset=UTF-8. We recommend that you set the Content-Transfer-Encoding header to quoted-printable. The email content must comply with the preceding limit.