Anmelden

Willkommen in unserem Support Center

Hier erhalten Sie Hilfe zu Integration und Live-Kampagnen.

Willkommen in unserem Support Center. Hier erhalten Sie Hilfe zu Integration und Live-Kampagnen.

Informationen zur Marketing API

Die Criteo API erreichen Sie über die folgende URL: https://api.criteo.com/marketing

Endpunkte

Authentifizierung

Typ

Endpunkt

Ziel

Parameter

Anmerkungen

POST

/oauth2/token

Erhalt eines Tokens, mit dem Sie Ihre Anfrage an die API senden können.

  • client_id (notwendig)
  • client_secret (notwendig)
  • grant_type (notwendig)

Der Token ist für 300 Sekunden gültig.

 

Verwaltung von Werbetreibenden

Typ

Endpunkt

Ziel

Parameter

GET

/portfolio

Abruf Ihrer advertiser_Id(s)

Kein

GET

/advertiser/{advertiser_Id}/campaigns

Abruf Ihrer Kampagnen und Kategorien für einen spezifischen Werbetreibenden

advertiser_Id (Pflichtangabe): String

GET

/advertiser/{advertiser_Id}/categories

Abruf Ihrer Kampagnen und Kategorien für einen spezifischen Werbetreibenden

Filtern nach Kategorie-Status

advertiser_Id (Pflichtangabe): Integer

enabledOnly: Boolean

GET

/advertiser/{advertiser_Id}/categories/{categoryHashCode}

Abruf von einzelnen Kategorien für einen spezifischen Werbetreibenden

advertiser_Id (Pflichtangabe)

categoryHashCode (Pflichtangabe)

 


Kampagnenverwaltung

Typ

Endpunkt

Ziel

Parameter

GET

/campaigns/

Abruf von Kampagnen für ihr Portfolio

advertiser_Ids: String

campaignIds: String

campaignstatus: String

bidtype: String

GET

/campaigns/{campaignId}

Abruf Ihrer Kampagne und der Kategorien für eine spezifische Kampagne

campaignId (mandatory): Integer

GET

/campaigns/{campaignId}/categories

Abruf Ihrer Kampagne und der Kategorien für eine spezifische Kampagne

Filtern nach Kategorie-Status

campaignId (mandatory): Integer

enabledOnly: String

GET

/campaigns/{campaignId}/categories/{categoryHashCode}

Abruf von spezifischen Kampagnen-Kategorien Ihres Portfolios

campaignId (mandatory): Integer

categoryHashCodes (mandatory): Integer

GET

/campaigns/bids

Abruf von Geboten für Ihr Portfolio

advertiser_Ids: String

campaignIds: String

categoryHashCodes: String

bidtype: String

campaignStatus: String

pendingChanges: Boolean

PUT

/campaigns/bids

Neue Gebote für Ihre Kampagnen oder Kampagnen-Kategorien festlegen

bidChanges (Pflichtangabe): String

 

Kampagnen-Reporting

Typ

Endpunkt

Ziel

Parameter

Anmerkungen

POST

/statistics

Abruf von Reports zur Werbe-Performance

statsQuery (Pflichtangabe)

Informationen zu diesem Endpoint finden Sie im entsprechenden Abschnitt der Dokumentation.

 

Budgetverwaltung

Typ

Endpunkt

Ziel

Parameter

GET

/budgets

Abruf von Budgets für Ihr Portfolio

advertiser_Ids: String

budgetIds: String

onlyActiveCampaigns: Boolean

 

Kategorie-Verwaltung

Typ

Endpunkt

Ziel

Parameter

GET

/categories

Abruf von Kategorien für Ihr Portfolio

campaign_Ids: : String

advertiser_Ids: String

categoryHashCodes: String

enabledOnly: Boolean

PUT

/categories

Aktive und inaktive Kategorien

categoriesPerCatalog (Pflichtangabe)

 

Zielgruppenverwaltung

Typ

Endpunkt

Ziel

Parameter

Anmerkungen

GET

/audiences

Abruf der Zielgruppenliste

advertiser_Id : Integer

Wird keine advertiserID angegeben, wird das gesamte Portfolio des Nutzers zurückgegeben.

POST

 /audiences/userlist/ 

Erstellung einer Zielgruppe

advertiser_Id : Integer

name: String

description: String

Die Zielgruppen-ID ist die nächste ID. Diese wird jedes Mal erhöht, wenn eine Zielgruppe erstellt wird.

PUT

/audiences/{audienceId} 

Änderung der Metadaten einer Zielgruppe

name: String

description: String

 

PATCH

/audiences/userlist/{audienceId}

Nutzer zu einer Zielgruppe hinzufügen bzw. daraus entfernen

operation: String (ADD oder REMOVE) 

schema: String (E-Mail oder MADID)

identifiers: Liste von Strings

Begrenzt auf 50.000 IDs pro Anfrage.

IDs können sein:

E-Mails: Text, MD5 oder SHA256 von MD5

MADID: IDFA oder AAID

Hinweis: Die API akzeptiert keine Cookie IDs von DMPs.

DELETE 

/audiences/userlist/{audienceId}/users

Alle Nutzer aus einer Zielgruppe entfernen

   

DELETE 

/audiences/{audienceId}

Zielgruppe löschen

   

 

Parameter

Parameter

Genutzt für ...

Details

client_id

Token-Abruf

Ihre E-Mail-Adresse (die gleiche, die Sie auch für die Anmeldung im Criteo Management Center verwenden)

client_secret

Token-Abruf

Ihr Passwort (das gleiche, dass Sie auch für die Anmeldung im Criteo Management Center verwenden)

grant_type

Token-Abruf

Entspricht immer den "client_credentials"

advertiser_Id

Abruf der Daten eines spezifischen Werbetreibenden

Abgerufen vom Endpunkt "/portfolio"

Abgerufen vom Endpunkt "/advertisers"

Abgerufen vom Endpunkt "/audience"

Abgerufen von /audiences/userlist/ 

advertiser_Ids

Abruf der Daten von einem spezifischen Werbetreibenden

Abgerufen vom Endpunkt "/budget"

Abgerufen vom Endpunkt "/campaigns"

Abgerufen vom Endpunkt "/campaigns/bids"

Abgerufen vom Endpunkt "/categories"

Abgerufen vom Endpunkt "/statistics"

Sie können mehrere advertiser_Ids gleichzeitig abrufen. Bitte trennen Sie diese per Komma: 1, 2, 3

enabledOnly

Filtern einer Liste von Kategorien

Abgerufen von den "/categories"-Endpunkten

Abgerufen vom Endpunkt "/advertiser/{advertiser_d}/categories"

Abgerufen vom Endpunkt "/campaigns/{campaignid}/categories"

enabled

Aktualisierung des Status einer Kategorie

Abgerufen von den "/categories"-Endpunkten

categoryHashCode

Abruf der Daten Einer spezifischen Kategorie

Aktualisierung des Status einer spezifischen Kategorie

Abgerufen vom Endpunkt "/advertiser/{advertiser_id}/categories/{categoriesHashCode}"

categoryHashCodes

Abruf der Daten Von spezifischen Kategorien

Aktualisierung des Gebotswerts von spezifischen Kampagnen-Kategorien

Abgerufen vom Endpunkt "/categories"

Abgerufen vom Endpunkt "/campaigns/bids"

Abgerufen vom Endpunkt "/campaigns/{campaignid}//categories/{categoriesHashCode}"

Sie können mehrere categoryhashcodes gleichzeitig abrufen. Trennen Sie diese per Komma: 1, 2, 3

budgetIds

Abruf der Daten zu einem spezifischen Budget

Abgerufen vom Endpunkt "/budgets"

onlyactiveCampaigns

Filtern von Kampagnen nach Status

Abgerufen vom Endpunkt "/budgets"

campaignID

Abruf der Daten von spezifischen Kampagnen

Aktualisierung des Gebotswerts einer spezifischen Kampagne

Abgerufen vom Endpunkt "/campaigns/{campaignid}"

Abgerufen vom Endpunkt "/campaigns/{campaignid}/categories"

Abgerufen vom Endpunkt "/campaigns/{campaignid}/categories/{categoriesHashCode}"

Abgerufen vom Endpunkt "/campaigns/bids"

campaignIds

Abruf von Daten zu spezifischen Kampagnen

Abgerufen vom Endpunkt "/campaigns"

Abgerufen vom Endpunkt "/campaigns/bids"

Abgerufen vom Endpunkt "/categories"

Sie können mehrere Kampagnen-IDs gleichzeitig abrufen. Trennen Sie diese per Komma: 1, 2, 3

bidType

Filtern nach Gebotstypen

Abgerufen vom Endpunkt "/campaigns"

Abgerufen vom Endpunkt "/campaigns/bids"

bidValue

Aktualisierung des Gebotswerts von spezifischen Kampagnen-Kategorien

Abgerufen vom Endpunkt "/campaigns/bids"

campaignStatus

Filtern nach Kampagnen-Status

Abgerufen vom Endpunkt "/campaigns"

Abgerufen vom Endpunkt "/campaigns/bids"

pendingChanges

Filtern von Kampagnen nach anstehenden oder umgesetzten Änderungen

Abgerufen vom Endpunkt "/campaigns/bids"

catalogId

Aktualisierung des Kategorie-Status

Abgerufen von den "/categories"-Endpunkten

audienceId

Aktualisierung einer spezifischen Zielgruppe

Abgerufen von /audiences/ 

name

Aktualisierung des Zielgruppennamens

Abgerufen vom Endpunkt "/audiences/userlist/"

Abgerufen vom  Endpunkt "/audiences/userlist/{audience_id}"

description

Aktualisierung der Zielgruppenbeschreibung

Abgerufen vom Endpunkt "/audiences/userlist/"

Abgerufen vom  Endpunkt "/audiences/userlist/{audience_id}"

operation

Aktionen zu einer Zielgruppe

Abgerufen vom Endpunkt  "/audiences/userlist/{audience_id}"

Variable muss einen der folgenden Werte haben: ADD / REMOVE

schema

Art der Zielgruppendaten

Abgerufen vom Endpunkt "/audiences/userlist/{audience_id}"

identifiers

Liste von User-IDs

Abgerufen vom  Endpunkt "/audiences/userlist/{audience_id}"

reportType

Export von Statistik-Reports

Abgerufen von "/statistics"

Diese Variable muss einen der folgenden Werte haben: Campaign performance / Facebook DPA Report / Transaction ID Report

ignoreXDevice

Export von Statistik-Reports

Abgerufen von "/statistics"

startDate

Export von Statistik-Reports

Abgerufen von "/statistics"

endDate

Export von Statistik-Reports

Abgerufen von "/statistics"

dimensions

Export von Statistik-Reports

Abgerufen von "/statistics"

Maximal 3 Dimensionen

metrics

Export von Statistik-Reports

Abgerufen von "/statistics"

Die Metriken sollten in der Benutzeroberfläche des Management Centers ausgewählt werden.

format

Export von Statistik-Reports

Abgerufen von "/statistics"

Die Variable muss einen der folgenden Werte haben: XML, JSON, CSV, EXCEL, HTML

currency

Export von Statistik-Reports

Abgerufen von "/statistics"

Der Wert der Variable muss dem aktuellen ISO-Währungscode entsprechen

Zeitzone

Export von Statistik-Reports

Abgerufen von "/statistics"

Die Variable muss einen der folgenden Werte haben: GMT / PST / JST 


Antwort-Codes

Antwort-Code

Grund

200

Erfolg

400

Ungültige Anfrage oder fehlerhafte Syntax

401

Authentifizierung fehlgeschlagen

403

Zugriff untersagt

429

Maximale Zugriffszahl erreicht: Nicht mehr als 200 Abfragen pro Minute und Klient

500

Unbekannter Fehler

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich
Powered by Zendesk