Product
Standortermittlung und User-Agent-Erkennung jetzt in Webhooks verfügbar
Wir nehmen unseren Kunden die harte Arbeit gerne ab. Als wir uns also entschlossen, unsere Webhooks für Öffnungen, Klicks und Abmeldungen um Standort- und User-Agent-Parameter zu erweitern, wollten wir noch einen Schritt weiter gehen, als unseren Kunden lediglich eine IP-Adresse und einen rohen User-Agent-String zur Verfügung zu stellen. Wenn wir nur diese Werte bereitstellen, müssen Sie die IP-Adresse in eine Stadt oder ein Land übersetzen und in die undurchsichtige Welt der User-Agent-Strings eintauchen, um herauszufinden, ob die E-Mail auf einem Tablet, einem Desktop-Rechner oder einem anderen Gerät geöffnet wurde. Sie haben Besseres zu tun, daher hier die Details.
Mit den neuen Standortparametern in den Webhooks für Öffnungen, Klicks und Abmeldungen stellt Mailgun Folgendes bereit:
IP – Die IP-Adresse, von der das Ereignis ausging.
Land – Zweistelliger Ländercode (wie festgelegt in ISO3166), aus dem das Ereignis stammte, oder „unknown“, falls dieser nicht ermittelt werden konnte.
Region – Zweistelliger Buchstaben- oder Zahlen- Regionscode oder „unknown“, falls dieser nicht ermittelt werden konnte.
Stadt – Name der Stadt, aus der das Ereignis stammte, oder „unknown“, falls diese nicht ermittelt werden konnte.
Kurz gesagt: Sie erhalten weiterhin die IP-Adresse, bekommen aber auch die häufigsten Informationen, die sich daraus ableiten lassen, ohne dass Sie diese selbst parsen oder decodieren müssen.
Für die User-Agent-Erkennung erhalten Sie
User-agent – User-Agent -String des Clients, der das Ereignis ausgelöst hat.
Device-type – Gerätetyp, auf dem der Link angeklickt wurde. Mögliche Werte sind „desktop“, „mobile“, „tablet“, „other“ oder „unknown“.
Client-type – Art der Software, in der der Link geöffnet wurde, z. B. „browser“, „mobile browser“, „email client“.
Client-name – Name der Client-Software, z. B. „Thunderbird“, „Chrome“, „Firefox“.
Kurz gesagt: Sie erhalten eine verständliche Version des User-Agents, ohne einen eigenen Parser schreiben zu müssen.
Eine vollständige Liste der Webhook-Parameter finden Sie in unserer Dokumentation für Öffnungen, Klicks genannt, und Abmeldungen.
Einrichtung von Webhooks im Überblick
Wenn Sie diese detaillierten Standort- und User-Agent-Daten in Ihrer Anwendung erfassen möchten – beispielsweise um benutzerdefinierte Berichte in Ihrer auf Mailgun basierenden E-Mail-Marketing-Anwendung zu erstellen –, ist das ganz einfach. Sie müssen lediglich einen Webhook im Mailgun Control Panel einrichten. Wenn Sie eine URL angeben, unter der Sie POST-Anfragen akzeptieren, sendet Mailgun Ihnen all diese Parameter.
Gibt es noch etwas, das in Webhooks übergeben werden sollte? Teilen Sie es uns in den Kommentaren mit.
Ihr Mailgun-Team
