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

Bei Anfragen an die API, die nicht abgeschlossen werden können, wird eine Fehlermeldung zurückgegeben. Anfragen, die Fehler zurückgeben, werden auf das Nutzerkontingent angerechnet und bei der Prüfung von Anfragen für zusätzliche Kontingente berücksichtigt. Fehlerantworten sollten verarbeitet und verarbeitet werden, um zukünftige Fehler zu vermeiden.

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

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

Im Folgenden finden Sie eine Liste häufiger API-Fehler sowie die empfohlene Maßnahme, wenn sie zurückgegeben werden:

Hinweis: Wenn der Fehler auch nach Ausführung der empfohlenen Maßnahme weiterhin besteht, wenden Sie sich an den Support, um das Problem zu melden.

Code	RPC	Empfohlene Maßnahme
400	INVALID_ARGUMENT	Es gibt ein Problem mit Ihrer Anfrage. Überprüfen Sie das Nachrichtenfeld in der Fehlerantwort und ändern Sie Ihre Anfrage entsprechend.
401	UNAUTHENTICATED	Ihre Anfrage konnte nicht ordnungsgemäß authentifiziert werden. Achten Sie darauf, dass die Anfrage gültige OAuth-Anmeldedaten enthält. Weitere Informationen hierzu finden Sie in unserem Startleitfaden.
403	PERMISSION_DENIED	Sie haben nicht die erforderlichen Berechtigungen, um Ihre Anfrage abzuschließen. Prüfen Sie, ob Ihr Nutzerkonto die erforderlichen Berechtigungen für den relevanten Partner oder Werbetreibenden hat.
404	NOT_FOUND	Die Ressource, die Sie abrufen möchten, wurde nicht gefunden. Prüfen Sie, ob die verwendete ID korrekt und der abzurufende Ressourcentyp stimmt.
409	ABORTED	Die Ressource, die Sie ändern möchten, wird an anderer Stelle geändert. Warten Sie einige Sekunden und wiederholen Sie die Anfrage.
429	RESOURCE_EXHAUSTED	Sie haben Ihr Raten- oder Tagesanfragekontingent überschritten. Überprüfen Sie Ihre API-Nutzung mit der Google API Console und passen Sie Ihren Workflow so an, dass er die bestehenden Kontingentlimits einhält. Weitere Informationen finden Sie auf der Seite Kontingentoptimierung. Wenn Ihre Vorgänge nicht im Rahmen des vorgegebenen Tageskontingents abgeschlossen werden können, können Sie ein zusätzliches Kontingent anfordern.
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 an den Support.
504	DEADLINE_EXCEEDED	Die Verarbeitung der Anfrage durch die API hat zu lange gedauert. Warten Sie einige Sekunden und wiederholen Sie die Anfrage. Wenn der Fehler weiterhin auftritt, wenden Sie sich an den Support.

SDF-Fehler

In der Display & Video 360 API wird eine asynchrone Methode zum Generieren und Herunterladen strukturierter Datendateien verwendet. Aus diesem Grund werden Fehler, die während der SDF-Erstellung ausgegeben werden, beim abgeschlossenen Download der SDF zurückgegeben. Ein SDF-Download, der in error abgeschlossen wird, ist als erledigt markiert. Allerdings enthält das Feld response ein ausgefülltes Fehlerfeld anstelle des Namens einer Medienressource, wie in diesem abgeschnittenen Beispiel:

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

Wenn Sie beim Generieren von SDFs eine Fehlermeldung erhalten, sollten Sie der Anleitung entsprechend folgen. Wenn aus der Fehlermeldung keine klar ersichtlichen Maßnahmen abgeleitet werden können, empfehlen wir das folgende Vorgehen:

• Prüfen Sie, ob der Nutzer die erforderlichen Berechtigungen für die übergeordneten Ressourcen vom Typ Partner oder Werbetreibender hat.
• Prüfen Sie, ob die im Filter angegebenen IDs korrekt sind, dem vorgesehenen Ressourcentyp entsprechen und im Kontext der angegebenen Stamm-ID stehen.
• Das Limit von zwanzig gleichzeitigen SDF-Downloadaufgaben pro Nutzer darf nicht überschritten werden.

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

Nicht blockierende Warnungen

Warnungen, die nicht zu einer Blockierung führen, werden Werbebuchungen zugewiesen, um auf ein Problem hinzuweisen, das sich auf die Auslieferung der 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 sie passiv sind, können Probleme, die diese Warnungen verursachen, die Auslieferung einer Werbebuchung so stark beeinträchtigen, dass sie vollständig verhindert wird.

Prävention

Viele Probleme, die Warnungen verursachen, die nicht zu einer Blockierung führen, lassen sich durch die richtige Konfiguration der Werbebuchungseinstellungen 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 generiert und die Werbebuchung wird nicht ausgeliefert. Achten Sie darauf, dass der Flight einer Werbebuchung nicht nach dem Flight des übergeordneten Anzeigenauftrags endet, um das letztere Problem zu vermeiden.
• Zugewiesene Creatives: Wenn einer Werbebuchung kein gültiges Creative zugewiesen ist, wird für die Werbebuchung eine Warnung generiert und 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 ganz verhindert werden.

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

Monitoring

Während eine Werbebuchung aktiv ist, können Probleme auftreten, die nicht zu einer Blockierung führen. Um sicherzustellen, dass Ihre Werbebuchungen korrekt geschaltet werden, überprüfen Sie Ihre aktiven Werbebuchungen auf neu generierte Warnungen. Mit der Funktion advertisers.lineItems.list können Werbebuchungen im Bulk abgerufen werden. Wenn eine Werbebuchung eine unerwartete Warnung generiert, sollten Sie das Problem sofort beheben, um die Auswirkungen auf die Auslieferung zu minimieren.

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