Tracking domain

Tracking domain adalah hostname bermerek pada sending domain Anda yang melayani pelacakan buka dan klik. Tautan yang ditulis ulang menggunakan hostname ini melalui HTTPS alih-alih domain bersama. Berbeda dengan bounce domain, tracking domain bersifat opsional dan tidak pernah menghalangi pengiriman.

Rekaman DNS

Tracking domain adalah CNAME di bawah sending domain Anda yang mengarah ke infrastruktur pelacakan kami di region Anda:

Tipe	Host	Nilai
CNAME	links.example.com	<region>.links.bird.com

Nilainya spesifik per region: us1.links.bird.com atau eu1.links.bird.com. Salin dari Email > Domains atau resource domain. Host default-nya adalah links. di bawah sending domain Anda.

Menyesuaikan hostname

Pilih label saat Anda mendaftarkan domain dengan mengirimkan tracking.name; kami menyusun hostname lengkapnya:

const domain = await bird.domains.create({
  domain: "mail.acme.com",
  tracking: { name: "click" },
});

domain = client.domains.create(
    domain="mail.acme.com",
    tracking={"name": "click"},
)

domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
	Domain:   "mail.acme.com",
	Tracking: &bird.DomainTrackingConfig{Name: "click"},
})

$domain = $bird->domains->create(
    (new DomainCreate())
        ->setDomain('mail.acme.com')
        ->setTracking((new DomainTrackingConfig())->setName('click')),
);

bird email domains create mail.acme.com --body-file - <<'JSON'
{
  "domain": "mail.acme.com",
  "tracking": {
    "name": "click"
  }
}
JSON

curl -s https://us1.platform.bird.com/v1/email/domains \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "mail.acme.com",
    "tracking": { "name": "click" }
  }'

Ini mendaftarkan click.mail.acme.com sebagai tracking host menggantikan default links.mail.acme.com. Seperti return-path, ini termasuk dalam konfigurasi domain workspace Anda.

Tidak menghalangi pengiriman

Domain dengan DKIM, return-path, dan DMARC yang terverifikasi tetap dapat mengirim meskipun tanpa rekaman tracking sama sekali; capabilities.tracking dilaporkan terpisah dari capabilities.sending. Sampai CNAME tracking terverifikasi, buka dan klik tidak dilacak melalui host bermerek Anda, dan tidak ada perubahan pada pengiriman.

Pelacakan adalah AND dari tiga hal, jadi tracking domain yang terverifikasi saja tidak mengaktifkan pelacakan:

Flag per-pengiriman: track_opens / track_clicks pada pesan (keduanya default true).
Pengaturan domain: settings.open_tracking / settings.click_tracking (keduanya default off; mengaktifkan salah satu tanpa tracking domain yang dikonfigurasi akan mengembalikan 409). Anda dapat mengaktifkan ini sebelum CNAME terverifikasi; pengaturan berlaku setelah CNAME terverifikasi.
CNAME tracking yang terverifikasi.

Jadi buka dan klik baru mulai tercatat setelah Anda mengonfigurasi dan memverifikasi tracking domain dan mengaktifkan pengaturan domain. Lihat Metrik email untuk mengetahui apa yang dilakukan setiap flag terhadap pesan.

Mengubahnya nanti

Perubahan tracking hostname dilakukan secara bertahap sama seperti perubahan return-path: hostname yang sudah terverifikasi tidak pernah digantikan oleh yang belum terverifikasi. Kami memverifikasi CNAME tracking baru berdampingan dengan yang aktif dan mempromosikannya hanya setelah rekaman baru lolos pemeriksaan, sehingga pelacakan bermerek tidak pernah terputus saat pergantian. Setelah pertukaran, rekaman lama dilaporkan sebagai deprecated, dan tautan yang dilacak di email yang sudah terkirim tetap dapat diakses.

Menghapusnya

Ada dua cara untuk menghapusnya, dengan dampak yang berbeda:

Hapus pelacakan dari domain dengan memperbarui domain menggunakan tracking: null. Kedua pengaturan pelacakan harus dinonaktifkan terlebih dahulu; jika tidak, pembaruan mengembalikan 409. Pengiriman tidak terpengaruh, pengiriman baru berhenti menggunakan pelacakan bermerek, dan tautan di email yang sudah terkirim tetap dapat diakses selama rekaman lama dilaporkan sebagai deprecated.
Lepaskan hostname dengan release endpoint jika Anda ingin membebaskannya untuk digunakan kembali. Tracking hostname diklaim oleh satu organisasi per region, sehingga organisasi lain tidak dapat mendaftarkannya selama Anda memegangnya. Melepaskan akan menghapus konfigurasi pelacakan, menonaktifkan kedua pengaturan pelacakan, dan melepas klaim Anda. Ini adalah penghapusan permanen: tautan yang dilacak di pesan yang sudah terkirim berhenti dapat diakses jika tidak ada domain lain di organisasi Anda yang menggunakan hostname yang sama.

Jika Anda bermigrasi ke hostname baru, lakukan pergantian bertahap alih-alih melepaskan: tukar melalui pembaruan, biarkan CNAME baru terverifikasi, dan tautan lama tetap berfungsi.

Langkah selanjutnya

Metrik email: apa yang dicatat pelacakan buka dan klik, serta flag per-pengiriman
Sending domain: mendaftarkan domain dan siklus verifikasi
Bounce domain: hostname return-path yang wajib ada
DKIM, SPF & DMARC: semua rekaman pada domain dan apa yang dibuktikannya

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaGetting started with email Jelajahi kemampuannyaEmail Ikuti jalur pembelajaranBuild your first integration Panduan implementasiSend your first email

Coba praktiknya dan dapatkan ringkasan implementasi