Topik ini menjelaskan cara mengaktifkan pelacakan open dan klik email.
Prasyarat
Gunakan alamat pengirim dari domain dengan status Verified.
Pelacakan bergantung pada tag email. Buat tag di halaman Set Email Tag, lalu gunakan tag tersebut saat mengirim email.
Pertimbangan
Data event open dan klik dikumpulkan secara real time dan ditampilkan di Konsol.
Batasan
Anda harus menggunakan tag email yang sudah ada saat mengirim email.
Pelacakan hanya didukung untuk email HTML. Konten email harus menyertakan elemen body, misalnya:
<body>Konten email Anda</body>.Untuk pelacakan klik, hyperlink harus berupa tag HTML
<a>dalam konten HTML, misalnya:<html><body><a href="hyperlink_to_track">test</a></body></html>. Hyperlink tersebut harus dapat diakses dari internet publik dan diawali denganhttp://atauhttps://. Pelacakan klik mengganti hyperlink yang memenuhi syarat dengan URL redirect yang mengarah ke layanan pengumpulan kami. Hyperlink asli diteruskan sebagai parameter ke URL baru tersebut. Saat penerima mengklik tautan, mereka akan diarahkan ke layanan pengumpulan kami. Layanan tersebut memvalidasi tautan, mengurai parameternya, dan mengumpulkan data event, lalu mengarahkan pengguna kembali ke hyperlink asli.
Penggunaan
1. Kirim email dari Konsol
1. Saat membuat tugas pengiriman email baru, centang kotak Enable untuk pelacakan email.
2. Konten harus memenuhi batasan yang dijelaskan di atas.
2. Kirim email melalui API atau SDK
Saat mengirim email melalui API atau SDK, atur parameter Tag ke tag email yang sudah ada dan parameter ClickTrace ke "1".
Atur konten email menggunakan metode setHtmlBody. Konten harus memenuhi batasan yang dijelaskan di atas.
Untuk memverifikasi konfigurasi, periksa keberadaan tag img atau tautan pelacakan di akhir konten email mentah.
3. Kirim email melalui SMTP
Atur header X-AliDM-Trace sesuai petunjuk dalam Lacak data open email berdasarkan tag saat mengirim melalui SMTP. Tag harus berupa tag email yang sudah ada. Nilai OpenTrace dan LinkTrace harus diatur ke "1".
Untuk mengecualikan tautan tertentu dari pelacakan klik, tambahkan atribut data-alidm-traceoff ke tag <a>-nya dalam konten HTML. Contohnya:
<a href = "http://www.aliyun.com" data-alidm-traceoff>Alibaba Cloud</a>Batasan
Untuk email yang dikirim melalui SMTP, tipe MIME body email harus berupa
text/html;charset=UTF-8. Atur header Content-Transfer-Encoding kequoted-printable. Konten harus memenuhi batasan yang dijelaskan di atas.
Contoh Python:
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
msg = MIMEMultipart('alternative')
texthtml = MIMEText('''<html><body><a href="https://www.aliyun.com">Email Tracking</a></body></html>''', _subtype='html',
_charset='UTF-8')
if 'Content-Transfer-Encoding' in msg:
# Jika header sudah diatur, ganti nilai pertama (header ini biasanya hanya memiliki satu nilai).
msg.replace_header('Content-Transfer-Encoding', 'quoted-printable')
else:
# Jika header belum diatur, tambahkan.
msg['Content-Transfer-Encoding'] = 'quoted-printable'
msg.attach(texthtml)
Contoh pemanggilan SMTP untuk Python 3.6 dan versi lebih baru
Contoh Java:
import javax.mail.internet.MimeBodyPart;
// Asumsikan bahwa msg adalah objek MimeMessage yang sedang Anda gunakan. Contoh ini menggunakan MimeBodyPart untuk demonstrasi.
// Buat bagian body pesan.
MimeBodyPart textPart = new MimeBodyPart();
textPart.setContent("<html><body><a href=\"https://www.aliyun.com\">Email Tracking</a></body></html>", "text/html; charset=UTF-8");
// Periksa apakah 'Content-Transfer-Encoding' telah diatur.
String[] cte = textPart.getHeader("Content-Transfer-Encoding");
if (cte == null || cte.length == 0) {
// Jika belum diatur, tambahkan header tersebut.
textPart.addHeader("Content-Transfer-Encoding", "quoted-printable");
} else {
// Jika sudah diatur, ganti nilai pertama (header ini biasanya hanya memiliki satu nilai).
textPart.setHeader("Content-Transfer-Encoding", "quoted-printable");
}