Häufig gestellte Fragen zur Deal Sync API

Hier finden Sie Antworten auf häufig gestellte Fragen zur Integration mit der Display & Video 360 Deal Sync API.

F: Was ist meine Exchange-ID?

A: Die ID der Anzeigenplattform wird vom Display & Video 360-Team während der Einrichtung der Authentifizierung zugewiesen.

F: Was ist der Zweck der Auftrags- und Produkthierarchie?

A: Mit dieser Hierarchie können Publisher und Werbetreibende mehrere Deals verhandeln und sie gemeinsam als einzelnes Verhandlungsobjekt einreichen. Es gibt Einschränkungen: Alle Produkte in einer Bestellung müssen denselben Transaktions- und Preistyp haben. Sie können immer ein Setup mit einer Bestellung und einem Produkt verwenden.

F: Gibt es einen Dealtyp für ALLE Werbetreibenden?

A: Die Deal Sync API ist für private Deals konzipiert. Öffentliche Deals, die für alle Werbetreibenden kuratiert wurden, finden Sie unter Auktionspakete (Inventarpakete).

F: Was passiert, wenn ein Angebot kein Enddatum hat?

A: Ein Enddatum ist erforderlich. Ein Datum in der Zukunft ist also in Ordnung. Das maximal zulässige Jahr ist 2036. Enddaten können in Zukunft aktualisiert oder verlängert werden.

F: Sind im Feld „dimensionCreativeConfig“ mehrere Größen zulässig?

A: Ja, aber pro Produkt ist nur ein Creative-Typ zulässig.

F: Werden native Creatives für programmatisch garantierte Deals unterstützt?

A: Nein. Bei garantierten Deals werden keine nativen Creatives unterstützt (CREATIVE_TYPE_NATIVE).

Wenden Sie sich an Ihren Google-Ansprechpartner, wenn Sie programmatisch garantierte Deals mit Native-Creatives ausführen möchten.

F: Akzeptieren Sie Auktionspreise für reservierte Transaktionen?

A: Nein. Bei garantierten Deals mit Reservierung wird nur ein fester Preis unterstützt.

F: Ist die Dauer für programmatisch garantierte Video-Deals erforderlich?

A: Nein. Wenn keine Angabe gemacht wird, lautet der Standardwert für „duration“ ANY.

F: Führen bestimmte Bestellstatus dazu, dass ein Deal nicht mehr ausgeführt wird?

A: Nein. Die Bestellung ist nur ein Verhandlungsobjekt. Änderungen werden erst für die Anzeigenbereitstellung übernommen, wenn der Werbetreibende die Bestellung akzeptiert.

F: Was passiert mit einem akzeptierten Deal, wenn die Exchange einen Update-Aufruf sendet?

A: Der Deal wird weiterhin gemäß den zuvor akzeptierten Bedingungen ausgeliefert. Sobald der Werbetreibende die aktualisierten Bedingungen akzeptiert hat, werden die Anzeigen des Deals mit den neuen Bedingungen ausgeliefert.

F: Werden Anzeigen für einen Deal weiterhin ausgeliefert, wenn die aktualisierten Nutzungsbedingungen noch nicht akzeptiert wurden?

A: Angenommen, der CPM wurde bereits auf der Exchange-Seite geändert und ist in der Gebotsanfrage enthalten:

  1. Bei Reservierungsdeals:Der Deal wird erst wieder aktiviert, wenn er vom Werbetreibenden noch einmal akzeptiert wurde. Werbebuchungen werden auf Grundlage der Dealbedingungen erstellt. Aktualisierungen werden erst übernommen, wenn der Werbetreibende sie akzeptiert.
  2. Bei nicht reservierten Deals hängt die Auslieferung vom Werbebuchungs-Targeting ab, mit dem auf den Deal ausgerichtet wird. Wenn Gebotsanfragen den Kriterien der Werbebuchung entsprechen, die auf diesen Deal ausgerichtet ist, wird die Auslieferung fortgesetzt.

F: Können wir eine Deal-ID für mehrere Deals wiederverwenden?

A: Nein. external_deal_id muss für alle Produkte eindeutig sein.

F: Kann ein Deal mehrere Partner haben?

A: Wenn Sie einen Deal mehreren Partnern zuordnen möchten, senden Sie ihn an einen „Zentralen Partner“.

F: Kann die mit einem Deal verknüpfte Partner-ID nach der Erstellung geändert werden?

A: Nein. Der Partner kann nicht mehr geändert werden, nachdem ein Auftrag erstellt wurde.

F: Unterstützen Sie mehrere Publisher-Namen in einer Bestellung?

A: Das Feld „Publisher-Name“ ist ein String, der zu Informationszwecken für den Werbetreibenden verwendet wird. Sie können mehrere Publisher-Namen durch Kommas getrennt angeben oder „Mehrere Publisher von Exchange X“ angeben.

F: Was ist der Unterschied zwischen den Bestellstatus „CANCELED“ (Abgebrochen) und „ARCHIVED“ (Archiviert)?

A: Nutzer können Bestellungen archivieren und wiederherstellen. Nach der Stornierung kann eine Bestellung nicht mehr reaktiviert oder die Stornierung nicht mehr rückgängig gemacht werden.

F: Was sind „Instant Deals“?

A: Instant Deals erfordern eine separate Einbindung über den Seller API-Endpunkt. Ignorieren Sie Attribute, die speziell für Sofortangebote gelten. Sie stehen nicht im Zusammenhang mit dem Workflow für die Angebotsynchronisierung.

F: Was sollte ich prüfen, wenn ich einen „Bad Request“-Fehler erhalte?

A: Hier sind einige häufige Ursachen:

  1. Prüfen Sie im Referenzhandbuch, ob alle Pflichtfelder ausgefüllt sind.
  2. Prüfen Sie, ob external_deal_id für alle Produkte eindeutig ist.
  3. In Reservierungsangeboten darf kein Auktionspreis angegeben sein.

Wenn das Problem weiterhin besteht, testen Sie die Anfrage mit einem HTTP-Client wie Postman, um detaillierte Fehlermeldungen im Antworttext zu prüfen.

Wenn das Problem durch keine der oben genannten Lösungen behoben wird, wenden Sie sich an das Supportteam für die Display & Video 360 Seller API.