Track details

Mit der E-Mail-Tracking-API können Sie E-Mail-Öffnungen und Klicks effizient nachverfolgen und auswerten. Sobald ein Empfänger Ihre E-Mail öffnet oder einen Link anklickt, wird dessen Adresse in die Liste der Öffnungen und Klicks aufgenommen. Über diese Liste lassen sich gezielt Aktivitäten zu einer bestimmten E-Mail-Adresse suchen und analysieren.

Aufrufadresse

Rechenzentrum	URL
Singapur	https://email.api.engagelab.cc
Türkei	https://emailapi-tr.engagelab.com

Achten Sie darauf, dass das gewählte Rechenzentrum zur jeweiligen Basis-URL passt, wenn Sie die REST API nutzen.

POST/v1/track_details

API-Abfrage: Tracking-Details

URL

https://email.api.engagelab.cc/v1/track_details

              
              https://email.api.engagelab.cc/v1/track_details

Diesen Codeblock im schwebenden Fenster anzeigen

HTTP-Anfragemethode

GET

GET

Diesen Codeblock im schwebenden Fenster anzeigen

Header

Header	Typ	Erforderlich	Beschreibung
Authorization	string	ja	Basic base64(api_user:api_key)

Beschreibung der Abfrageparameter

Parameter	Typ	erforderlich	Beschreibung
time_zone	string	ja	Zeitzone, z. B. +8, Standardwert ist +8
start_date	string	ja	Startdatum im Format `yyyy-MM-dd`
end_date	string	ja	Enddatum im Format `yyyy-MM-dd`
email	string	ja	E-Mail-Adresse, zu der Details abgerufen werden sollen
track_type	string	nein	`1` für Öffnungen, `2` für Klicks; ohne Angabe werden beide Typen abgefragt
api_users	string	nein	Statistiken für bestimmte API_USER abrufen; mehrere durch Semikolon getrennt, z. B. api_users=a;b;c
label_ids	string	nein	Statistiken für bestimmte Labels abrufen; mehrere durch Semikolon getrennt, z. B. label_ids=a;b;c
offset	int	nein	Startposition, [0-], Standardwert 0
limit	int	nein	Anzahl, [0-100], Standardwert 100

Beispiel für eine Anfrage:

curl -X GET -H 'Content-Type: application/json; charset=utf-8' \ -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \ 'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'

              
              curl -X GET -H 'Content-Type: application/json; charset=utf-8' \
     -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \
     'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'

Diesen Codeblock im schwebenden Fenster anzeigen

Beschreibung der Rückgabewerte

Parameter	Beschreibung
email	E-Mail-Adresse
label_id	E-Mail-Label-ID
track_type	Öffnungen oder Klicks
url	Angeklickte URL
api_user	Name des API-Users
curr_time	Zeitpunkt der Öffnung oder des Klicks
ip	IP-Adresse der Öffnung oder des Klicks
country	Land der IP-Adresse
province	Provinz der IP-Adresse
city	Stadt der IP-Adresse
browser	Browser bei Öffnung oder Klick
device	Gerät bei Öffnung oder Klick

Beispiel für Rückgabewerte:

{ "result": [ { "email": "opfwefs@gmail.com", "track_type": 1, "api_user": "sendcloud_op**s", "url": "", "curr_time": "2021-06-09 09:49:30", "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im", "ip": "47.190.78.5", "country": "United States", "province": "Texas", "city": "Southlake", "browser": "google", "device": "" } ], "count": 1, "total": 2 }

              
              {
  "result": [
    {
      "email": "opfwefs@gmail.com",
      "track_type": 1,
      "api_user": "sendcloud_op**s",
      "url": "",
      "curr_time": "2021-06-09 09:49:30",
      "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im",
      "ip": "47.190.78.5",
      "country": "United States",
      "province": "Texas",
      "city": "Southlake",
      "browser": "google",
      "device": ""
    }
  ],
  "count": 1,
  "total": 2
}

Diesen Codeblock im schwebenden Fenster anzeigen

Mit dieser API zur Nachverfolgung von E-Mails können Sie gezielt E-Mail-Öffnungen und Klicks auswerten und so Ihre E-Mail-Kommunikation datenbasiert optimieren.

API zur Verfolgung von E-Mail-Aktivitäten

Aufrufadresse

API-Abfrage: Tracking-Details