Diese Seite wurde von der Cloud Translation API übersetzt.

API-Workflows

Deal erstellen

Prüfen Sie, ob ein Produkt bereits erstellt wurde, indem Sie Produkte mit dem Filter „external_deal_id“ LIST. Die „External_deal_id“ muss für alle Produkte eindeutig sein.
```
GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
```
Auftrag erstellen Der Name wird von DV3 generiert. Wir empfehlen, diese ID in Ihrem System zu speichern, damit Sie sie später abrufen können.
Produkt unter „Auftrag“ erstellen Der Produktname wird von DV3 generiert. Wir empfehlen, diese ID zur späteren Verwendung in Ihrem System zu speichern.

Alternativ können Sie immer LIST mit external_deal_id ausführen. Das Feld „Name“ enthält sowohl die Bestell-ID als auch die Produkt-ID, sodass Sie das übergeordnete Element auf diese Weise leicht identifizieren können.

Angebot stornieren

Bestellstatus auf „Storniert“ aktualisieren Die Stornierung wird nur unterstützt, wenn die Bestellung noch nicht angenommen wurde. „Abgebrochen“ ist ein Endstatus. Eine stornierte Bestellung kann nicht reaktiviert werden.

Details zu einem Deal abrufen

Details zu einer Bestellung abrufen Der Status wird aktualisiert, sobald der Nutzer die Bestellung annimmt, archiviert oder storniert.
Details zum Produkt abrufen:

Liste mit Deals abrufen

LIST-Bestellungen mit einem Statusfilter, um alle akzeptierten/ausstehenden Bestellungen zu erhalten.
LIST-Produkte mit dem Filter „external_deal_id“.
LIST alle Produkte in einer Bestellung auf.

Deal aktualisieren

Aktualisieren der Kontaktdaten für Publisher für die Bestellung.
1. Der Name darf nicht aktualisiert werden(kann nicht in „field_mask“ festgelegt werden). Der Status kann nur über die API auf „Canceled“ (Abgebrochen) gesetzt werden.
2. Die partner_id erlaubt keine Aktualisierung.
Aktualisieren Sie das Produkt für eine bestimmte Aktualisierung der Deal-Laufzeit.
1. name, externalDealId, transactionType, pricingType und updateTime können nicht aktualisiert werden.
2. Für die Aktualisierung von „displayName“ ist keine Nutzerbestätigung erforderlich.
3. Wenn Sie rateDetails und creativeConfig aktualisieren, ändert sich der Status der übergeordneten Bestellung in „Ausstehende Annahme“. DV3-Werbetreibende werden auf der Seite „Verhandlungen“ aufgefordert, den neuen Begriff zu akzeptieren, unabhängig davon, ob die vorherige Bestellung akzeptiert wurde oder nicht.

Prüfen, ob der Nutzer das Angebot angenommen hat

Get Order (Bestellung abrufen), wenn Sie die entsprechende Bestell-ID kennen. Prüfen Sie das Statusfeld.
Wenn die Bestell-ID nicht erfasst wurde: Produkte mit dem Filter „external_deal_id“ auflisten, Bestellnamen anhand des Produktnamens ermitteln und dann Bestellung abrufen. Prüfen Sie das Statusfeld.

Prüfen, ob der Nutzer das Angebot konfiguriert hat(nur für PG)

Inventarquelle abrufen: Der Name ist „exchanges/{exchangeId}/inventorysources/{external_deal_id}“. Prüfen Sie den Käuferstatus.
1. Angebote für Reservierungen
  1. BUYER_STATUS_ACTIVE bedeutet, dass ein Deal akzeptiert und konfiguriert wurde. Es wird erwartet, dass für den Deal Ausgaben anfallen, wenn DV3 eine Gebotsanfrage erhält, die den Deal-Bedingungen entspricht. Im Schritt „Deal Configuration“ (Deal-Konfiguration) wird automatisch eine Position generiert. Weitere Informationen finden Sie unter Angebot konfigurieren.
  2. BUYER_STATUS_PENDINGbedeutet, dass die Bestellung angenommen wurde, der Deal aber noch nicht konfiguriert ist. In diesem Status werden keine Ausgaben getätigt.
  3. BUYER_STATUS_PAUSED: Der Deal wurde vom Werbetreibenden explizit pausiert. In diesem Status werden keine Ausgaben getätigt.
2. Deals ohne Reservierung
  1. BUYER_STATUS_ACTIVE bedeutet, dass ein Deal akzeptiert wurde. Es wird erwartet, dass für den Deal in diesem Status Ausgaben anfallen, wenn DV3 eine Gebotsanfrage erhält, die den Deal-Bedingungen entspricht UND es eine aktive Werbebuchung gibt, die auf diesen Deal ausgerichtet ist UND die Gebotsanfrage den Targeting-Kriterien der Werbebuchung entspricht. Weitere Informationen finden Sie unter Werbebuchung.** Es gibt KEINE Seller API, mit der abgefragt werden kann, ob ein Deal auf Werbebuchungen ausgerichtet ist. **
  2. BUYER_STATUS_PENDINGnicht zutreffend.
  3. BUYER_STATUS_PAUSED: Der Deal wurde vom Werbetreibenden explizit pausiert. In diesem Status werden keine Ausgaben getätigt.

Deal nach der Annahme pausieren/fortsetzen

Aktualisieren Sie den Verkäuferstatus der Inventarquelle.
1. Das Pausieren und Fortsetzen hat keine Auswirkungen auf die Auslieferung von Deals. Wenn ein Verkäufer einen Deal pausiert, wird Werbetreibenden nur eine String-Meldung zur Information angezeigt. So können Werbetreibende Probleme mit einem Deal ohne Ausgaben beheben.

Erneute Verhandlung (Deal nach Annahme aktualisieren)

Die Neuverhandlung bezieht sich auf Aktualisierungen, die an einem Deal vorgenommen werden, nachdem er vom Käufer akzeptiert wurde. Das kann sowohl für Börsen als auch für Käufer sehr nützlich sein, um neue Änderungen an akzeptierten Deals vorzunehmen. So kann es beispielsweise vorkommen, dass die Endzeit eines akzeptierten Deals nicht korrekt ist. In diesem Fall kann die Exchange-Seite das DV3-Produkt aktualisieren, um Updates an DV3-Käufer zu senden, sofern der Deal noch nicht begonnen hat.