Skip to main content

Touchpoints API - Dokumentation

Dokumentation: Customerjourney Orders API

Die TouchpointsCustomerjourney Orders API ermöglichtdient den strukturiertendem Export und dieder Analyse von Touchpoints,Customer-Journey-Daten, die imüber Rahmen desdas Partnerprogramm-SystemsSystem erfasst wurden. Sie bietetermöglicht es, detaillierte EinblickeInformationen inzu einzelneden Touchpointseinzelnen Kontaktpunkten (Actions) einer Bestellung strukturiert als CSV-Datei abzurufen und unterstütztdie beiPfade der Abrechnung,Nutzer Erfolgsmessungbis sowiezur derConversion Integrationpräzise in interne oder externe Systeme.nachzuvollziehen.

AlleDie APIsAPI könnenkann im User-Interface unter dem Menüpunkt Daten-API verwendet werden.

API-Aufruf

https://www.domain.de/DOMAIN/api//ACCESS-TOKEN/admin/ID/ACCESS-TOKEN/admin/ID/get-customerjourney_orders.customerjourney_orders.csv

Wert Beschreibung
www.domain.deDOMAIN System-Partnerprogramm Domain
ACCESS-TOKEN Access Token des Users
ID User-ID
.csv Art des Downloads (Dateiformat)

Touchpoints-Customerjourney-API Filterung

Für die TouchpointsCustomerjourney API können verschiedene Parameter als Filter verwendet werden.
 Nachfolgend eine Übersicht allerder verfügbaren Parameter:

Touchpoints-APIFilter

Parameter Wert / Beispiel

Beschreibung

Parameter

Wert

Beschreibung

Beispiel

condition[period][from]

Startdatum

2026-02-04		 Definiert

Definitiondas Startdatum des Startdatums

Zeitraums

condition[period][from]=19.12.1909

(Bestelldatum).

condition[period][to]

Enddatum

2026-02-04		 Definiert

Definitiondas Enddatum des Enddatums

Zeitraums

condition[period][to]=19.12.1909

(Bestelldatum).

condition[dynamicdate]

 currentmonth,

currentmonthlastmonth, =last10d, aktueller Monat
lastmonth = letzter Monat
last10d = letzten 10 Tage
currentweek = Aktuelle Woche

Definition eines dynamischen Zeitraums.
(kann Hinweis: Kann nicht zusammen mit condition[period][period[from] oder condition[period][period[to] ausgewähltverwendet werden.

condition[dynamicdate]=currentweek
condition[l:campaigns] 1Filtert alle Daten, die einer bestimmten Kampagne zugeordnet sind. Mehrfachnennung möglich.
condition[l:projects]

Zahlenwert, entsprechend des Projekts

1234

Alle Transaktionen, welche unter der entsprechenden Projekt-ID des Programms hinterlegt sind. Mehrfachnennung möglich.

condition[l:projects]=1234

condition[l:campaigns]

Zahlenwert, entsprechend der Kampagne

Alle Transaktionen, welche unter der entsprechenden Kampagne des Programms hinterlegt sind. Mehrfachnennung möglich.

condition[l:campaigns]=1

Beispiele für gefilterte Aufrufe:

  • Fixer Zeitraum: condition[period][from]=2026-02-04&condition[period][to]=2026-02-04&condition[l:campaigns]=1
  • Dynamisch: condition[dynamicdate]=currentweek&condition[l:projects]=1234

Definition der Felder (Spalten)

Die heruntergeladenen Transaktionen enthalten folgende Spalten:

FeldnameBeschreibung
order_idInterne ID der zugehörigen Transaktion / Bestellung
ordertokenBestellnummer der Transaktion aus dem Shopsystem
campaign_idID der Kampagne, welcher die Bestellung zugeordnet ist
order_timestampZeitpunkt des Bestelleingangs (Format: YYYY-MM-DD HH:MM:SS+TZ)
trigger_idID des Triggers, der der Bestellung zugeordnet ist
project_idID des Projekts (Attribution Target)
admedia_idID des Werbemittels der Bestellung
action_timestampZeitpunkt des Klicks oder der Einblendung (Touchpoint)
typeArt des Kontaktpunkts (z.B. click)
action_campaign_idKampagnen-ID des spezifischen Kontaktpunkts innerhalb der Journey
action_project_idProjekt-ID des spezifischen Kontaktpunkts
action_admedia_idWerbemittel-ID des spezifischen Kontaktpunkts
referrerDie URL, von der der Nutzer zum Shop geleitet wurde (inkl. Tracking-Parametern)
Back to top