Fehlermeldungen und Warnungen

Auf dieser Seite werden die verschiedenen Arten von Fehlern und Warnungen beschrieben, die bei der Verwendung der Display & Video 360 API auftreten können.

API-Fehler

Für nicht abgeschlossene Anfragen an die API wird eine Fehlermeldung zurückgegeben. Anfragen, die Fehler zurückgeben, werden auf das Nutzerkontingent angerechnet und bei der Prüfung von Anfragen für ein zusätzliches Kontingent berücksichtigt. Fehlerantworten sollten verarbeitet und behandelt werden, um zukünftige Fehler zu vermeiden.

Eine Fehlerantwort hat das folgende Format und enthält einen HTTP-Antwortcode, eine Fehlermeldung und einen Google RPC-Statuscode:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Im Folgenden finden Sie eine Liste häufiger API-Fehler und die empfohlenen Maßnahmen, die Sie ergreifen sollten, wenn sie auftreten:

Code RPC Empfohlene Maßnahme
400 INVALID_ARGUMENT Es gibt ein Problem mit Ihrer Anfrage. Prüfen Sie das Nachrichtenfeld in der Fehlerantwort und ändern Sie Ihre Anfrage entsprechend.
401 UNAUTHENTICATED Ihre Anfrage konnte nicht richtig authentifiziert werden. Prüfen Sie, ob Sie in Ihrer Anfrage gültige OAuth-Anmeldedaten angeben. Weitere Informationen finden Sie in unserem Einstiegsleitfaden.
403 PERMISSION_DENIED Sie haben nicht die erforderlichen Berechtigungen, um Ihre Anfrage abzuschließen. Prüfen Sie, ob Ihr Nutzerkonto die entsprechenden Berechtigungen für den entsprechenden Partner oder Werbetreibenden hat.
404 NOT_FOUND Die Ressource, die Sie abrufen möchten, konnte nicht gefunden werden. Prüfen Sie, ob die verwendete ID korrekt ist und für den abgerufenen Ressourcentyp gilt.
409 ABORTED Die Ressource, die Sie ändern möchten, wird gerade woanders geändert. Warten Sie einige Sekunden und wiederholen Sie die Anfrage.
429 RESOURCE_EXHAUSTED Sie haben Ihr Limit für die Häufigkeit von Anfragen oder Ihr Tageskontingent überschritten. Prüfen Sie Ihre API-Nutzung in der Google API Console und ändern Sie Ihren Workflow so, dass er innerhalb der bestehenden Kontingentlimits liegt. Weitere Informationen finden Sie auf unserer Seite Kontingentoptimierung.
500 INTERNAL In der API ist ein interner Fehler aufgetreten. Warten Sie einige Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin auftritt, wenden Sie sich bitte an den Support.
504 DEADLINE_EXCEEDED Die API hat zu lange für die Ausführung der Anfrage benötigt. Warten Sie einige Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin auftritt, wenden Sie sich bitte an den Support.

SDF-Fehler

Die Display & Video 360 API verwendet eine asynchrone Methode zum Generieren und Herunterladen strukturierter Datendateien (SDFs). Aus diesem Grund werden Fehler, die während der SDF-Generierung auftreten, in der abgeschlossenen SDF-Downloadaufgabe zurückgegeben. Eine SDF-Downloadaufgabe, die mit error endet, ist als abgeschlossen markiert, enthält aber ein ausgefülltes Fehlerfeld anstelle eines Namens der Medienressource im Feld response, wie in diesem gekürzten Beispiel zu sehen:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Wenn Sie beim Versuch, SDFs zu generieren, eine ausführbare Fehlermeldung erhalten, sollten Sie dieser entsprechend folgen. Wenn die Fehlermeldung nicht eindeutig umsetzbar ist, empfehlen wir Folgendes:

  • Prüfen Sie, ob Ihr Nutzer die erforderlichen Berechtigungen für die übergeordneten Ressourcen des Partners oder Werbetreibenden hat.
  • Prüfen Sie, ob die im Filter angegebenen IDs korrekt sind, dem gewünschten Ressourcentyp entsprechen und zum Kontext der angegebenen Stamm-ID gehören.
  • Achten Sie darauf, dass Sie nicht mehr als 20 gleichzeitige SDF-Downloadaufgaben pro Nutzer ausführen.

Wenn weiterhin Fehler auftreten, wenden Sie sich an den Support, um das Problem zu melden.

Nicht blockierende Warnungen

Nicht blockierende Warnungen werden Werbebuchungen zugewiesen, um auf ein Problem hinzuweisen, das sich auf die Auslieferung einer Werbebuchung auswirken kann. Ähnliche Warnungen werden in der Benutzeroberfläche über ein Benachrichtigungsbanner angezeigt. Diese Warnungen sind passiv und werden im Feld warningMessages einer Werbebuchung aufgeführt.

Obwohl diese Probleme passiv sind, können sie sich auf die Auslieferung eines Werbebuchungselements auswirken und diese sogar vollständig verhindern.

Prävention

Viele Probleme, die zu nicht blockierenden Warnungen führen, lassen sich durch eine korrekte Konfiguration der Anzeigenblock-Einstellungen vermeiden. Dazu gehören:

  • Laufzeit: Wenn die Laufzeit einer Werbebuchung ungültig ist oder die Laufzeit des übergeordneten Anzeigenauftrags abgelaufen ist, wird für die Werbebuchung eine Warnung ausgegeben und es erfolgt keine Auslieferung. Um das letztere Problem zu vermeiden, darf die Laufzeit einer Werbebuchung nicht später als die Laufzeit der übergeordneten Anzeigenauftragsposition enden.
  • Zugewiesene Creatives: Wenn einer Werbebuchung kein gültiges Creative zugewiesen ist, wird eine Warnung ausgegeben und die Anzeigen werden nicht ausgeliefert.
  • Targeting: Wenn das Targeting einer Werbebuchung nicht richtig zugewiesen ist, wird möglicherweise eine Warnung ausgegeben und die Auslieferung kann beeinträchtigt oder verhindert werden.

Wenn Sie Konfigurationen aus einer vorhandenen Werbebuchung replizieren, achten Sie darauf, dass die vorhandene Werbebuchung keine unerwarteten Warnungen generiert.

Monitoring

Probleme, die zu nicht blockierenden Warnungen führen, können auftreten, während eine Werbebuchung ausgeführt wird. Damit Ihre Werbebuchungen korrekt ausgeliefert werden, sollten Sie Ihre aktiven Werbebuchungen auf neu generierte Warnungen prüfen. Mit der Funktion advertisers.lineItems.list können Sie mehrere Werbebuchungen gleichzeitig abrufen. Wenn für eine Werbebuchung eine unerwartete Warnung angezeigt wird, sollten Sie das Problem sofort beheben, um die Auswirkungen auf die Anzeigenbereitstellung zu minimieren.

Probleme können auch dann auftreten, wenn sich die Einstellungen oder das Targeting einer Werbebuchung nicht geändert haben. Beispiele hierfür sind die Pausierung oder das Ablaufen des übergeordneten Anzeigenauftrags und die Einstellung von Nutzerlisten oder anderen Targeting-Optionen.