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-API

Filter
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]

1 Filtert 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:

    Feldname Beschreibung order_id Interne ID der zugehörigen Transaktion / Bestellung ordertoken Bestellnummer der Transaktion aus dem Shopsystem campaign_id ID der Kampagne, welcher die Bestellung zugeordnet ist order_timestamp Zeitpunkt des Bestelleingangs (Format: YYYY-MM-DD HH:MM:SS+TZ) trigger_id ID des Triggers, der der Bestellung zugeordnet ist project_id ID des Projekts (Attribution Target) admedia_id ID des Werbemittels der Bestellung action_timestamp Zeitpunkt des Klicks oder der Einblendung (Touchpoint) type Art des Kontaktpunkts (z.B. click) action_campaign_id Kampagnen-ID des spezifischen Kontaktpunkts innerhalb der Journey action_project_id Projekt-ID des spezifischen Kontaktpunkts action_admedia_id Werbemittel-ID des spezifischen Kontaktpunkts referrer Die URL, von der der Nutzer zum Shop geleitet wurde (inkl. Tracking-Parametern)