Table of contents
Criteo Resellers Program API V2 – Vollständiges Referenzhandbuch
Konzepte
Die folgenden Konzepte werden in der Criteo Reseller Program API verwendet
- Budget – ein Budget begrenzt die Ausgaben eines Verkäufers für eine oder mehrere Kampagnen. Es gibt einen Anfangsbetrag und einen ausgegebenen Betrag. Es gibt auch ein Start- und Enddatum. Klicks auf eine über eine Verkäuferkampagne verkaufte Anzeige werden gemäß dem ausgehandelten Preis mit dem zugehörigen Budget abgerechnet. Ein Budget kann von mehreren Verkäuferkampagnen verbraucht werden, sofern diese demselben Verkäufer gehören.
- Kampagne – eine Kampagne ist eine Aktion zur Werbung für Produkte Ihrer Verkäufer.
- Werbetreibender – Der Werbetreibende ist die juristische Person, die im Namen des Verkäufers Werbung macht. Typischerweise handelt es sich beim Werbetreibenden um einen Marktplatz, der die CRP-Lösung zur Monetarisierung des Werbebudgets des Verkäufers nutzt. Aliase: Marktplatz
- Verkäufer – ein Verkäufer, der Produkte auf Ihrem Marktplatz verkauft. Ein Verkäufer profitiert von einer Kampagne, indem er über die Criteo-Plattform eine größere Präsenz seiner Produkte im Internet erhält. Ein Verkäufer interagiert jedoch nicht finanziell mit Criteo.
- Verkäuferkampagne – eine Verkäuferkampagne ist eine Ressource, die die vom Verkäufer vereinbarten Geschäftsregeln zur Verwendung in einer bestimmten Kampagne zusammenfasst. Es enthält beispielsweise das Höchstgebot, das der Verkäufer für eine Kampagne abzugeben bereit ist. Verschiedene Plattformen (Web oder Mobilgeräte) haben normalerweise unterschiedliche Kampagnen.
Die in dieser API bereitgestellten Ressourcen sind die folgenden:
- Werbetreibende (Werbetreibende)
- Verkäufer (Verkäufer)
- Verkäuferkampagne (Verkäuferkampagnen)
- Budget (Budgets)
Darüber hinaus wird von der API auch auf die v1- Kampagnenressource (/marketing/v1/campaigns) verwiesen.
Diese Ressourcen verfügen jeweils über global eindeutige Kennungen, mit Ausnahme der Verkäuferkampagne, für die die Verkäufer-ID und die Kampagnen-ID als eindeutige Kennung dienen.
Die Verkäuferressource ist einem Werbetreibenden zugeordnet und hat in diesem Zusammenhang auch einen eindeutigen Namen.
Design
Der Entwurf des v2-Schemas basiert auf dem folgenden Beziehungsdiagramm für die wichtigsten Ressourcen.
Beachten Sie, dass jede Verkäuferkampagne einen zusammengesetzten Primärschlüssel verwendet, der aus einem einzelnen Verkäufer und einer einzelnen Kampagne besteht. Es kann mehreren Budgetressourcen zugeordnet werden. Ein Budget kann von mehreren Verkäuferkampagnen verbraucht werden, sofern diese demselben Verkäufer gehören. Allerdings sehen die Geschäftsregeln vor, dass es höchstens ein aktuelles Tagesbudget und ein aktuelles Nicht-Tagesbudget gibt. Ein Tagesbudget kann ohne ein nicht-Tagesbudget dahinter konfiguriert werden, aber ein Tagesbudget allein reicht nicht aus, um eine Verkäuferkampagne zu aktivieren und mit der Schaltung von Anzeigen zu beginnen; Es ist ein nicht tägliches Budget (auch „Gesamtbudget“) erforderlich.
API-Endpunkte
- Dieses Designdokument beschreibt Dienste, die im folgenden Dienststammverzeichnis zu finden sind: https://api.criteo.com/marketing/v2/crp
- Eine Beschreibung der API finden Sie hier: https://api.criteo.com/marketing/swagger
Dieser Service-Root wird ausschließlich für die Reseller-Programm-Domain verwendet. In der Vergangenheit war das Reseller-Programm Teil des https://api.criteo.com/marketing/v1/-Dienststammverzeichnisses unter dem URI-Pfadsegment des Verkäufers.
Der Rest dieses Abschnitts ist nach URI-Adresse organisiert. Es gibt vier Hauptunterabschnitte:
- Werbetreibende
- Verkäufer (Verkäufer)
- Verkäuferkampagnen (Verkäuferkampagnen)
- Budgets (Budgets)
Jeder Unterabschnitt beginnt mit einer Tabelle der unterstützten Endpunkte.