Apps-Dokumentation

Daten-Exporte

Erzeuge API-Keys, um deine Marketing-Daten programmatisch abzurufen.

Daten-ExporteBald

Überblick

Mit Daten-Exporten erzeugst du API-Anmeldedaten, um auf deine Adverfly-Daten programmatisch zuzugreifen. Erstelle API-Keys, verwalte Zugänge und nutze die eingebaute Doku, um Events, Sessions, Conversions und Ad-Performance via REST-API abzufragen.

Wichtigste Funktionen

  • API-Key-Management: API-Keys erstellen, benennen, widerrufen
  • Client-Secret-Sicherheit: Client-Secrets werden nur einmal beim Erstellen gezeigt — sofort kopieren oder herunterladen
  • Eingebaute API-Docs: Verfügbare Endpunkte, Parameter und Beispiel-Requests direkt in der App
  • Mehrere Keys: Mehrere Keys für unterschiedliche Use Cases oder Team-Mitglieder

Verfügbare API-Endpunkte

Alle Endpunkte nutzen die Base-URL https://api.adverfly.com mit Header-Authentifizierung:

EndpunktBeschreibung
GET /v3/eventsPageviews, Klicks und Custom-Events
GET /v3/sessionsUser-Sessions mit Entry-/Exit-Page
GET /v3/conversionsKäufe und Conversion-Events
GET /v3/adsAd-Performance (Spend, Impressions, Clicks, Reach)

Authentifizierung

Jede Anfrage benötigt zwei Header:

  • x-api-key — Dein API-Key
  • client-secret — Dein Client-Secret

Häufige Parameter

ParameterBeschreibung
start_dateBeginn (YYYY-MM-DD)
end_dateEnde (YYYY-MM-DD)
nameFilter nach Event-Name
sourceKomma-getrennte Ad-Sources (z. B. meta,google) — nur Ads-Endpunkt
limitErgebnisse pro Seite (max. 500)
offsetPagination-Offset

So funktioniert's

Beim Erstellen eines API-Keys erzeugt Adverfly ein Schlüsselpaar (API-Key + Client-Secret). Der Key erbt deine Workspace-Berechtigungen. Nutze die Credentials in Skripten, Pipelines oder BI-Tools.

Anwendungsfälle

  • Daten-Pipelines: Daten in dein Warehouse oder BI-Tool ziehen
  • Eigene Dashboards: Custom-Visualisierungen mit deinen Tools
  • Automatisiertes Reporting: Skripte planen, die Daten ziehen und formatieren
  • Drittanbieter-Integrationen: Adverfly-Daten an nicht nativ unterstützte Tools anbinden

Erste Schritte

  1. Öffne Daten-Exporte über die Sidebar
  2. Klicke API-Key erstellen
  3. Benenne deinen Key und bestätige
  4. Kopiere oder lade das Client-Secret sofort (wird nicht erneut gezeigt)
  5. Verwende API-Key und Client-Secret in deinen HTTP-Requests