Technische Grundlagen

• Funktionsweise
• Endpoint & Parameter

Funktionsweise

Das Baskettracking basiert auf einem serverseitigen Aufruf vom Shop-System (Advertiser) an das Tracking-System von easy.MARKETING.

Dabei werden Transaktions- und Artikeldaten in einem JSON-Array übergeben.
Jedes bestellte Produkt entspricht einem Basket-Item, das mit den relevanten Informationen (z. B. Preis, Anzahl, Produktname) befüllt wird.

---

Ablauf im Überblick

1. Klick auf Werbemittel

   • Ein Nutzer klickt auf ein Werbemittel (z. B. Banner oder Link).
   • Das System hängt die EMID (Tracking-ID) an die Ziel-URL an.

2. Besuch der Landingpage

   • Die EMID wird vom Advertiser-System (Frontend oder Backend) gespeichert.
   • Dadurch ist die Zuordnung des Nutzers sichergestellt.

3. Bestellung im Shop

   • Der Nutzer führt eine Transaktion durch.
   • Das Shop-System erstellt eine Liste aller bestellten Produkte (Basket).

4. Serverside Tracking-Call

   • Das Shop-System baut einen Trackingaufruf auf und übergibt:
     • Kampagnen- und Triggerdaten
     • Bestellnummer (Token)
     • Basket-Daten (Artikel, Preis, Menge, Kategorie, etc.)
     • Die gespeicherte EMID
   • Der Aufruf erfolgt an den Tracking-Endpoint von easy.MARKETING.

---

Rolle der EMID

Die EMID ist eine eindeutige Kennung, die für die Attribution der Transaktion notwendig ist:

• Sie wird beim Klick erzeugt und an den Advertiser übergeben.
• Sie muss beim Conversion-Aufruf mitgesendet werden.
• Ohne EMID kann die Customer Journey nicht korrekt zugeordnet werden.

Endpoint & Parameter

Damit Baskettracking funktioniert, müssen die Daten vom Shop-System an den entsprechenden Tracking-Endpoint von easy.MARKETING übermittelt werden. Die Übergabe erfolgt per HTTP-GET-Request mit einem JSON-Array im Parameter json.

---

Endpoint

Der Basis-Endpoint lautet:

https://SUB-DOMAIN/trck/ebasket/

SUB-DOMAIN wird individuell pro Advertiser/Kunde konfiguriert. Der Endpoint akzeptiert die GET-Parameter json (Pflicht) und optional currency.

Pflichtparameter

Parameter	Beschreibung
json	URL-encodiertes JSON-Array mit allen Basket-Items (Pflichtfeld). Ein Objekt pro bestelltem Produkt.

Optionaler Parameter

Parameter	Beschreibung
currency	Übergabe der Währung. Standard: EUR. Bei Bedarf z. B. CHF, USD, …

Beispielaufrufe

Mit Standard-Währung (EUR)

https://DOMAIN/trck/ebasket/?json=[{"campaign_id":"CAMPAIGN_ID","trigger_id":"TRIGGER_ID","token":"TOKEN","emid":"EMID","amount":"AMOUNT","price":"PRICE","article_number":"ARTICLE_NUMBER","productname":"PRODUKTNAME","category":"CATEGORY","additional":{"VARIABLE":"VALUE","VARIABLE2":"VALUE2"}}]&currency=EUR

Mit alternativer Währung (CHF)

https://DOMAIN/trck/ebasket/?json=[{"campaign_id":"1","trigger_id":"5","token":"12345","emid":"abc123","amount":"2","price":"19.90","article_number":"SKU-123","productname":"Sneaker XY","category":"Schuhe"}]&currency=CHF

---

Anforderungen an den json-Parameter

• URL-Encoding: Der komplette json-Parameter muss URL-encodiert übertragen werden, damit Sonderzeichen korrekt verarbeitet werden.
• Struktur: Das JSON ist ein Array von Objekten (ein Objekt pro Basket-Item).
• Pflichtfelder je Item: campaign_id, trigger_id, token, action_id (bzw. emid je nach Implementierung), amount, price, article_number, productname, category.
• Additional-Daten: Über das Feld additional können beliebige Key-Value-Paare (z. B. vouchercode, customerType, …) übergeben werden.

Kurzreferenz JSON-Item

{
  "campaign_id": "CAMPAIGN_ID",
  "trigger_id": "TRIGGER_ID",
  "token": "TOKEN",
  "action_id": "EMID",
  "amount": "AMOUNT",
  "price": "PRICE",
  "article_number": "ARTICLE_NUMBER",
  "productname": "PRODUCT_NAME",
  "category": "CATEGORY",
  "additional": {
    "vouchercode": "WINTER20",
    "zusatzinfo": "additional_1"
  }
}