Fehler und Warnungen

Die Display & Video 360 API kann mit einer Reihe von Fehlern und Warnungen reagieren. Eine funktionierende API-Lösung muss diese Fehler abfangen.

API-Fehler

Anfragen an die API, die die beabsichtigte Aktion nicht ausführen, geben einen Fehler zurück. Fehlerantworten sollten abgefangen und verarbeitet werden.

Eine API-Fehlerantwort enthält einen HTTP-Antwortcode, eine Fehlermeldung und einen Google RPC-Code-Status. Sie hat folgendes Format:

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

Im Folgenden finden Sie eine Liste häufiger API-Fehler und empfohlener Maßnahmen:

Fehlercodes
`400`	`INVALID_ARGUMENT` Es gibt ein Problem mit Ihrer Anfrage. Sehen Sie sich das Nachrichtenfeld in der Fehlerantwort an und aktualisieren Sie Ihre Anfrage entsprechend.
`401`	`UNAUTHENTICATED` Ihre Anfrage konnte nicht richtig authentifiziert werden. Prüfen Sie, ob Sie gültige OAuth-Anmeldedaten in Ihre Anfrage aufnehmen. Weitere Informationen finden Sie in unserer Kurzanleitung.
`403`	`PERMISSION_DENIED` Sie haben nicht die erforderlichen Berechtigungen, um die Anfrage zu bearbeiten. Prüfen Sie, ob Ihr Nutzerkonto die erforderlichen Berechtigungen für den entsprechenden Partner oder Werbetreibenden hat.
`404`	`NOT_FOUND` Die Ressource, die Sie abrufen möchten, wurde nicht gefunden. Prüfen Sie, ob die ID, die Sie verwenden, korrekt ist und zum abzurufenden Ressourcentyp gehört.
`409`	`ABORTED` Die Ressource, die Sie ändern möchten, wird gerade an anderer Stelle geändert. Warten Sie einige Sekunden und wiederholen Sie die Anfrage.
`429`	`RESOURCE_EXHAUSTED` Sie haben Ihr Ratenlimit oder Ihr tägliches Anfragekontingent überschritten. Google Cloud Console verwenden, um die API-Nutzung zu prüfen Aktualisieren Sie Ihren Workflow, damit er die vorhandenen Kontingentlimits einhält. Weitere Informationen finden Sie in unserem Leitfaden zur Nutzungsoptimierung.
`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 Bearbeitung 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

In der Display & Video 360 API werden zeitaufwendige Aufgaben verwendet, um strukturierte Datendateien (SDFs) zu erstellen. Fehler beim Erstellen der SDFs werden in der fertigen operation zurückgegeben. Das Feld error enthält die Details. Hier ein gekürztes Beispiel:

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

Wenn die Fehlermeldung nicht eindeutig ist, empfehlen wir Folgendes:

Prüfen Sie, ob Ihr Nutzer mindestens die Nutzerrolle Standard für den übergeordneten Partner oder Werbetreibenden hat.
Prüfen Sie, ob die im Filter angegebenen IDs korrekt sind. Die IDs müssen dem vorgesehenen Ressourcentyp entsprechen und untergeordnete Ressourcen der Stamm-ID sein.
Achten Sie darauf, dass Ihr Nutzer weniger als 20 gleichzeitige SDF-Downloadaufgaben hat.

Wenn weiterhin Fehler angezeigt werden, wenden Sie sich an den Support.

Warnungen, die nicht zu einem Dienstausfall führen

Nicht blockierende Warnungen weisen auf ein Problem hin, das sich auf die Anzeigenbereitstellung eines Line-Items auswirken kann. Ähnliche Warnungen werden in der Benutzeroberfläche angezeigt. Diese Warnungen sind passiv und werden in der Werbebuchung aufgeführt.

Die Ursache einer Warnung kann sich auf die Auslieferung einer Werbebuchung auswirken. In einigen Fällen kann dies die Anzeigenauslieferung vollständig verhindern.

Prävention

Einige nicht blockierende Warnungen werden durch die falsche Konfiguration einer Werbebuchung verursacht:

Laufzeit: Anzeigen für eine Werbebuchung werden nicht ausgeliefert, wenn die Laufzeit ungültig ist oder die Laufzeit des zugehörigen Anzeigenauftrags abgelaufen ist. Achten Sie darauf, dass die Laufzeit einer Werbebuchung innerhalb der Laufzeit des zugehörigen Anzeigenauftrags liegt.
Zugewiesene Creatives: Eine Werbebuchung kann nicht ausgeliefert werden, wenn ihr kein gültiges Creative zugewiesen ist.
Targeting: Die Anzeigenbereitstellung einer Werbebuchung kann beeinträchtigt oder ganz verhindert werden, wenn das Targeting nicht richtig zugewiesen ist.

Prüfen Sie, ob für eine vorhandene Werbebuchung Warnungen angezeigt werden, bevor Sie ihre Konfigurationen in einer neuen Werbebuchung verwenden.

Monitoring

Nicht blockierende Warnungen können während der Laufzeit einer Werbebuchung auftreten. Behalten Sie Ihre aktiven Positionen im Blick, um neue Warnungen zu erkennen und dafür zu sorgen, dass die Anzeigen richtig ausgeliefert werden. Rufen Sie Werbebuchungen mit einer list-Anfrage im Bulk ab. Wenn für eine Werbebuchung eine unerwartete Warnung angezeigt wird, sollten Sie das Problem so schnell wie möglich beheben, um die Auswirkungen auf die Auslieferung zu minimieren.

Warnungen können auch dann hinzugefügt werden, wenn sich die Einstellungen oder das Targeting nicht geändert haben. Beispiele:

Der Anzeigenauftrag ist pausiert oder läuft ab.
Eine Nutzerliste oder Targeting-Option wird nicht mehr unterstützt.