Domena śledzenia

Domena śledzenia to brandowana nazwa hosta w Twojej domenie wysyłkowej, która obsługuje śledzenie otwarć i kliknięć. Przepisane linki używają tej nazwy hosta przez HTTPS zamiast domeny współdzielonej. W odróżnieniu od domeny odbić jest opcjonalna i nigdy nie blokuje wysyłki.

Rekord

Domena śledzenia to rekord CNAME w Twojej domenie wysyłkowej, który wskazuje na naszą infrastrukturę śledzenia w Twoim regionie:

Typ	Host	Wartość
CNAME	links.example.com	<region>.links.bird.com

Wartość zależy od regionu: us1.links.bird.com lub eu1.links.bird.com. Skopiuj ją z Email > Domains lub z zasobu domeny. Domyślna nazwa hosta to links. w Twojej domenie wysyłkowej.

Dostosowywanie nazwy hosta

Wybierz etykietę podczas rejestracji domeny, przekazując tracking.name; pełną nazwę hosta komponujemy automatycznie:

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" }
  }'

To rejestruje click.mail.acme.com jako host śledzenia zamiast domyślnego links.mail.acme.com. Podobnie jak return-path, należy do konfiguracji domeny Twojego obszaru roboczego.

Nie blokuje wysyłki

Domena ze zweryfikowanymi DKIM, return-path i DMARC może wysyłać nawet bez żadnego rekordu śledzenia; capabilities.tracking jest raportowany oddzielnie od capabilities.sending. Dopóki rekord CNAME śledzenia nie przejdzie weryfikacji, otwarcia i kliknięcia nie są śledzone przez Twój brandowany host, a dostarczalność się nie zmienia.

Śledzenie to AND trzech rzeczy, więc sama zweryfikowana domena śledzenia nie włącza śledzenia:

Flaga per wysyłka: track_opens / track_clicks na wiadomości (obie domyślnie true).
Ustawienie domeny: settings.open_tracking / settings.click_tracking (oba domyślnie wyłączone; włączenie jednego bez skonfigurowanej domeny śledzenia zwraca 409). Możesz je włączyć przed weryfikacją CNAME; zaczną działać, gdy CNAME przejdzie weryfikację.
Zweryfikowany rekord CNAME śledzenia.

Otwarcia i kliknięcia zaczną napływać dopiero po skonfigurowaniu i zweryfikowaniu domeny śledzenia oraz włączeniu ustawienia domeny. Zobacz Metryki e-mail, aby dowiedzieć się, jak każda flaga wpływa na wiadomość.

Zmiana domeny śledzenia

Zmiany nazwy hosta śledzenia są etapowane tak samo jak zmiany return-path: nazwa hosta, która jest już zweryfikowana, nigdy nie zostanie zastąpiona niezweryfikowaną. Nowy rekord CNAME śledzenia weryfikujemy równolegle z aktywnym i awansujemy go dopiero po pomyślnej weryfikacji, dzięki czemu brandowane śledzenie nigdy nie znika w trakcie zmiany. Po zamianie stare rekordy są raportowane jako deprecated, a śledzone linki we wcześniej wysłanych wiadomościach nadal działają.

Usuwanie domeny śledzenia

Dwie ścieżki usuwają domenę śledzenia, z różnym zakresem skutków:

Usuń śledzenie z domeny, aktualizując ją z tracking: null. Oba ustawienia śledzenia muszą być wcześniej wyłączone; w przeciwnym razie aktualizacja zwróci 409. Wysyłka nie jest zakłócona, nowe wysyłki przestają korzystać z brandowanego śledzenia, a linki we wcześniej wysłanych wiadomościach nadal działają, podczas gdy stare rekordy są raportowane jako deprecated.
Zwolnij nazwę hosta za pomocą endpointu zwalniania, gdy chcesz ją udostępnić do ponownego użycia. Nazwa hosta śledzenia jest zajęta przez jedną organizację w danym regionie, więc inna organizacja nie może jej zarejestrować, dopóki ją trzymasz. Zwolnienie usuwa konfigurację śledzenia, wyłącza oba ustawienia śledzenia i zwalnia Twoje roszczenie. To jest twarde usunięcie: śledzone linki we wcześniej dostarczonych wiadomościach przestaną działać, gdy żadna inna domena w Twojej organizacji nie używa tej samej nazwy hosta.

Jeśli migrujesz na nową nazwę hosta, zamiast zwalniać, etapuj zmianę: zamień przez aktualizację, poczekaj na weryfikację nowego CNAME, a stare linki będą dalej działać.

Kolejne kroki

Metryki e-mail: co rejestruje śledzenie otwarć i kliknięć oraz flagi per wysyłka
Domeny wysyłkowe: rejestracja domeny i cykl życia weryfikacji
Domena odbić: wymagana nazwa hosta return-path
DKIM, SPF & DMARC: wszystkie rekordy domeny i co potwierdzają

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikGetting started with email Poznaj możliwościEmail Podążaj ścieżką naukiBuild your first integration Przewodnik wdrożeniowySend your first email

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy