Skip to main content

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

Hinweis zu emid/action_id:

In der JSON-Struktur wird die EMID in neueren Implementierungen als action_id übergeben. In älteren Beispielen kann noch emid auftauchen. Bitte halte dich konsistent an action_id innerhalb der JSON-Items, sofern eure Implementierung darauf setzt.

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"
  }
}
Back to top