Targeting API

Die Targeting API dient der Personalisierung von Webseiten in Echtzeit. Die Personalisierung findet in dem Moment statt, wenn der Besucher auf die Webseite kommt.

Bei der Targeting API handelt es sich um einen REST-Service, der sich in Content Management- oder Shop-Systeme integrieren lässt.

Mit Hilfe der übertragenen Daten können je nach Kundeninteresse automatisch Webseiteninhalte dynamisch generiert oder ausgetauscht werden. Auf diese Weise hilft die etracker Targeting API nicht nur dabei, die User Experience zu verbessern, sondern auch die Konversionsrate und den Umsatz zu steigern.

Zugang zur TAPI

Folgende Voraussetzungen müssen erfüllt sein, um die etracker Targeting API nutzen zu können:

• Gewünschte Targeting-Daten müssen von etracker erfasst und über Events (mittels eCommerce API) oder Bestellparameter beim Seitenaufruf übergeben werden.
  Bestellungen, Product Performance Events (‚Produkt gesehen‘, ‚Produkt in Warenkorb gelegt‘ und/oder ‚Produkt bestellt‘).
• Die gewünschten Targeting-Daten (Attribute) sind von etracker konfiguriert.

Um die Schnittstelle aufzurufen, schicken Sie einen Request an die URI der Targeting API. Sie können die Schnittstelle im Frontend mittels JavaScript oder im Backend über HTTPS aufrufen. Pro Session genügt eine Abfrage (zu Beginn der Session).

Der Request an die Schnittstelle muss zwei Parameter enthalten:

• _et übergibt den Account-Schlüssel, den Sie in der etracker Applikation unter Einstellung > Setup/Tracking Code finden. Der Account-Schlüssel ist Base64 encodiert.
• _et_coid übergibt den First-Party Cookie aus der Domain des etracker Kunden.

Hinweis:
Sie können die _et_coid auch per JavaScript ermitteln.
Für Testzwecke können Sie die Cookie-ID _et_coid per Firebug aus der Webseite entnehmen.

https://ws.etracker.com/api/v6/realtime/user?et=<Account-Schlüssel>&_et_coid=<CookieId>

Beispiel:

https://ws.etracker.com/api/v6/realtime/user?et=YM9dM9&_et_coid=6bbece51587a6f7aac4989953149ca47

Response

Hinweis:
Wenn ein Besucher eine Webseite das erste Mal besucht, kann es aus technischen Gründen bis zu einer halben Stunde dauern, bis die Targeting API ein neues Nutzerprofil zur Verfügung stellt.

Response-Aufbau

In ihrem Response stellt die Schnittstelle Nutzerprofildaten bereit. Der Response wird im JSON-Format zur Verfügung gestellt und zwar in Tabellenform mit n Spalten für die Attributnamen (Header) und n Zeilen für die Attributwerte (Data). Die Anzahl der Zeilen ist abhängig von der Größe des Nutzerprofils. Die JSON-Response-Struktur sieht aus wie folgt:

{
"status": "success",","version":2,
"header": [
...
 ],
"data": [
...
]
}

Beispiel mit Standardattributen:

{  
"status":"success","version":2,  
"header":[  
"avg_order_value_seg",  
"customer_type",   
"device_type",  
"device_type_detail",  
"frequency_seg",  
"is_newsletter_recipient",  
"purchaser_type",  
"time_since_last_order_seg",  
"visit_count_seg",  
"visitor_type"  ],  
"data":[  
"STC_CC_ATTR_VALUE_AVG_ORDER_VALUE_SEG_01",
 "STC_CC_ATTR_VALUE_CUSTOMER_TYPE_2", 
 "STR_CC_ATTR_VALUE_DEVICE_TYPE_DESKTOP",
 "STR_CC_ATTR_VALUE_DEVICE_TYPE_DESKTOP",
 "STC_CC_ATTR_VALUE_FREQUENCY_SEG_02",
 "STC_CC_ATTR_VALUE_NEWSLETTER_2",
 "STC_CC_ATTR_VALUE_PURCHASER_TYPE_1",
 "STC_CC_ATTR_VALUE_TIME_SINCE_LAST_ORDER_SEG_01",
 "STC_CC_ATTR_VALUE_VISIT_COUNT_SEG_04",
 "STC_CC_ATTR_VALUE_VISITOR_TYPE_1"
 ]
}

Response-Attribute

Über die konfigurierten Attribute werden die Nutzerprofildaten bereitgestellt. etracker konfiguriert die Attribute beim Kauf des Produktes nach den Wünschen des Kunden. Zur Zeit sind maximal zehn Attribute erlaubt.

Hinweis: Es existieren zur Zeit zehn Standardattribute, die auch in den Testing & Targeting Reports ausgewertet werden.

etracker stellt folgende Attribute bereit:

Allgemeine Attribute

Um die folgenden Attribute auszuwerten, muss der UserAgent vom Client Request mit dem http-Header ‚User-Agent‘ an die TAPI übermittelt werden. Beispiel Übermittlung Client User-Agent User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0

Geo-Attribute

Die Targeting API (TAPI) bietet die Möglichkeit, den Standort eines Webseitenbesuchers ohne die Lokalisierungs-API des Browers zu verwenden. Mittels eines GeoIP-Auflösungsdienstes erfolgt eine Zurückverfolgung bis zum Internetprovider. Die TAPI liefert Informationen zum Standort des Besuchers in Bezug auf Landes-, Bundeslands- und Stadtebene. Um die folgenden Attribute auszuwerten muss die Client IP vom Client Request mit dem http-Header ‚X-Forwarded-For‘ an die TAPI übermittelt werden. Beispiel Übermittlung Client IP X-Forwarded-For: 31.19.38.145

eCommerce-Attribute

Hinweis: Um die eCommerce-Attribute nutzen zu können, muss eine erweiterte Datenerfassung in die zu messende Website integriert werden. Nur so können Events wie z. B. ‚Produkt gesehen‘, ‚Produkt in den Warenkorb gelegt‘ oder ‚Produkt bestellt‘ über die eCommerce API an etracker übergeben werden.

Profilinformationen

Bestellinformationen

Produktinformationen

Engagement & Lead Attribute

Hinweis: Um die folgende Top 10-Liste für Bereiche oder Seiten nutzen zu können, müssen die Parameter für Seitennamen und Bereiche im Parameterblock des Tracking Codes übergeben werden.

Statusattribute

Fehlermeldungen

Darstellung Smart Messages

Auf GitHub stellt etracker ein jQuery-Plugin für die Darstellung von Smart Messages zur Verfügung. Mit dem Plugin jquery.smartmessage wird gezeigt wie Exit-Intent, Attention Grabber oder Greeter Messages implementiert werden können. Das Plugin fragt die Targeting API für Nutzerprofile ab und nutzt für das Tracking etracker Analytics.