Anleitung
Eigene Tracking-Domain einrichten
Legen Sie den Tracking-CNAME für Ihre Versanddomain an, verifizieren Sie ihn und aktivieren Sie das Öffnungs- und Klick-Tracking, damit Links und Pixel Ihren eigenen Hostnamen über HTTPS verwenden.
Öffnungs- und Klick-Tracking läuft bei Emailit immer über einen Hostnamen auf Ihrer eigenen Domain, etwa go.acme.com. Diese Anleitung zeigt, wie Sie den CNAME-Eintrag für diesen Hostnamen anlegen, ihn verifizieren und das Tracking aktivieren.
Voraussetzungen
- Fügen Sie die Versanddomain hinzu und verifizieren Sie sie. Siehe Versanddomain hinzufügen.
- Stellen Sie sicher, dass Sie die DNS-Einträge der Domain bearbeiten können.
- Wählen Sie einen Hostnamen, der für nichts anderes verwendet wird. Der Standardwert ist
go, wasgo.acme.comergibt.
Tracking-Subdomain wählen
Der Tracking-Hostname lautet <tracking subdomain>.<sending domain>. So verwenden Sie etwas anderes als go:
Suchen Sie auf der Domainseite unter Email APIDomains die Karte Custom Subdomains. Geben Sie unter Tracking Subdomain ein Präfix ein, zum Beispiel links, und wählen Sie Save.
Rufen Sie Domain aktualisieren mit tracking_key auf. Sie können den Wert auch beim Erstellen der Domain übergeben.
curl https://api.emailit.com/v2/domains/acme.com \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "tracking_key": "links" }'Das Präfix darf Kleinbuchstaben, Ziffern und Bindestriche enthalten, höchstens 63 Zeichen lang sein und muss mit einem Buchstaben oder einer Ziffer beginnen und enden. Wenn Sie es ändern, wird der Tracking-Eintrag auf Not checked zurückgesetzt. Legen Sie also einen CNAME für den neuen Hostnamen an und prüfen Sie das DNS erneut.
CNAME anlegen und verifizieren
-
CNAME-Eintrag hinzufügen. Legen Sie bei Ihrem DNS-Anbieter diesen Eintrag an:
Typ Host Ziel CNAME go(oder Ihre Tracking-Subdomain)go.emailitmail.comFür
acme.comergibt das:go.acme.com. CNAME go.emailitmail.com.Wenn Sie von einer Subdomain wie
mail.acme.comsenden, lautet der Hostgo.mailin der Zoneacme.com. -
Proxy bei Cloudflare deaktivieren. Liegt Ihr DNS bei Cloudflare, setzen Sie den Proxy-Status des Eintrags auf DNS only (graue Wolke). Ein über den Proxy geleiteter Eintrag liefert die IP-Adressen von Cloudflare statt des CNAME, und das Tracking kann weder verifiziert werden noch Anfragen beantworten. Die Einrichtung mit Cloudflare legt den Eintrag automatisch als DNS only an.
-
DNS prüfen. Wählen Sie auf der Domainseite Check DNS. Das Status-Badge in der Karte Tracking wechselt zu OK, sobald der CNAME auf
go.emailitmail.comzeigt. -
Tracking aktivieren. Aktivieren Sie in der Karte Tracking Track loads, Track clicks oder beides. Die Schalter bleiben deaktiviert, bis der CNAME OK zeigt.
Per API rufen Sie Domain aktualisieren mit
"track_loads": trueund"track_clicks": trueauf.
Diese Schalter legen den Standard für E-Mails von der Domain fest. Für eine einzelne E-Mail können Sie sie beim Senden per API mit dem Feld tracking überschreiben. Siehe Öffnungs- und Klick-Tracking.
HTTPS
Alle Tracking-Links und Pixel verwenden https://. Emailit stellt das Zertifikat für Ihren Tracking-Hostnamen automatisch aus und erneuert es, sobald die erste Anfrage dafür eingeht. Sie müssen kein Zertifikat hochladen und nichts weiter ändern.
Ergebnis prüfen
-
Test-E-Mail senden von der Domain, mit mindestens einem Link, zum Beispiel mit Compose auf der Seite Emails.
-
Links prüfen. Bewegen Sie in der empfangenen Nachricht den Mauszeiger auf einen Link. Er sollte mit
https://go.acme.com/beginnen, nicht mit Ihrer ursprünglichen URL. -
Öffnen und klicken. Öffnen Sie die E-Mail und klicken Sie auf den Link. Die Seite der E-Mail unter Email APIEmails listet die Öffnung unter Loads und den Klick unter Clicks auf, und der Status wechselt zu
loadedund dann zuclicked.
Fehlerbehebung
| Symptom | Lösung |
|---|---|
| Tracking zeigt Missing | Der CNAME ist nicht unter dem erwarteten Host angelegt. Prüfen Sie das mit dig +short CNAME go.acme.com @1.1.1.1. Eine häufige Ursache: Sie haben den vollständigen Namen eingegeben, wo der Anbieter nur go erwartet. |
| Tracking zeigt Invalid | Der CNAME zeigt woandershin, oder der Eintrag wird bei Cloudflare über den Proxy geleitet. Lassen Sie ihn auf go.emailitmail.com zeigen und setzen Sie ihn auf DNS only. |
| Track loads und Track clicks sind ausgegraut | Der CNAME ist noch nicht verifiziert. Wählen Sie Check DNS, nachdem Sie ihn angelegt haben. |
| E-Mails kommen mit den ursprünglichen Links an | Das Tracking ist für die Domain deaktiviert, die Nachricht wurde mit "tracking": false gesendet, oder der Tracking-Eintrag war bei der letzten DNS-Prüfung nicht OK. Emailit sendet dann ohne Tracking, statt fehlzuschlagen. |
| Links zeigen eine Zertifikatswarnung | Der CNAME wurde gerade erst angelegt. Warten Sie eine Minute und versuchen Sie es erneut. Bleibt die Warnung, prüfen Sie, ob der Eintrag über den Proxy geleitet wird. |
Unter go gibt es bereits einen CNAME |
Wählen Sie eine andere Tracking-Subdomain, etwa links oder t, und legen Sie den CNAME dort an. |