Marketing API-Version

Auslieferungsprüfungen für Anzeigen

Verwandte Themen

Werbeanzeige

Bei Auslieferungsprüfungen handelt es sich um verschiedene Tests, mit denen du potenzielle Probleme bei der Auslieferung von Anzeigen ermitteln kannst.

Ausführen und auslesen

Wenn du Auslieferungsprüfungen für Anzeigen ausführen und negative Ergebnisse abrufen möchtest, musst du das Feld failed_delivery_checks einer Anzeige auslesen. Hier ein Beispiel zum Ausführen von Auslieferungsprüfungen für die Anzeige 6014290603725:

curl -G \
  -d 'fields=failed_delivery_checks' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>

Wenn alle Prüfungen bestanden wurden, ist das Feld failed_delivery_checks nicht in der Antwort enthalten.

Die Antwort für eine Anzeige mit fehlgeschlagener Prüfung für „invalid_custom_audiences“ sieht beispielsweise wie folgt aus:

{
 "failed_delivery_checks": [
    {
      "summary": "Custom Audience No Longer Shared", 
      "description": "This ad uses a custom audience that's no longer being shared with you. Please contact the person who set up the audience for more information.", 
      "check_name": "invalid_custom_audiences", 
    }
  ], 
  "id": "6014290603725"
}

Bei dem Feld failed_delivery_checks handelt es sich um ein JSON-Array, das JSON-Objekte der fehlgeschlagenen Prüfungen enthält. Jede fehlgeschlagene Prüfung umfasst die folgenden Felder:

Name	Beschreibung	Typ
check_name	Der Name der fehlgeschlagenen Prüfung (siehe Typen von Auslieferungsprüfungen)	String
summary	Einzeilige Beschreibung des Fehlers	String
Beschreibung	Genauere Erläuterung des Fehlers	String

Typen von Auslieferungsprüfungen

Die folgenden Prüfungen stehen zum Prüfen der Anzeigenauslieferung zur Verfügung:

check_name	Fehlerursache
page_status	Seite nicht veröffentlicht: Diese Werbeanzeige kann nicht ausgeliefert werden, da die darin erwähnte Seite nicht veröffentlicht wurde.
mobile_eligible	Nicht für Mobilgeräte geeignet: Diese Werbeanzeige wird nicht an Personen mit Mobilgeräten ausgeliefert.
blocked_url	URL auf Blockierliste gesetzt: Diese Anzeige leitet auf eine verdächtige URL weiter.
invalid_custom_audiences	Eine der folgenden: 1. Custom Audience wird nicht mehr geteilt: Diese Werbeanzeige verwendet eine Custom Audience, die nicht mehr mit dir geteilt wird. Bitte kontaktiere die Person, die die Zielgruppe erstellt hat, um weitere Informationen zu erhalten. Wenn das Konto auf einige der Zielgruppen, die die Anzeige nutzt, nicht mehr zugreifen kann, kann die Anzeige nicht ausgeliefert werden. 2. Custom Audience-Deaktivierungskonflikt: Diese Werbeanzeige verwendet verschiedene Zielgruppen mit verschiedenen Deaktivierungs-Links. Du kannst verschiedene Custom Audiences für eine Werbeanzeige nur verwenden, wenn die Links nicht im Konflikt stehen. 3. Anzeige verwendet gelöschte Custom Audience: Diese Werbeanzeige verwendet eine Custom Audience, die von dir oder der Person, die sie eingerichtet hat, gelöscht wurde. Eine Werbeanzeige, die gelöschte Custom Audiences verwendet, kann nicht ausgeliefert werden. 4. Custom Audience-Fehler: Mit der dieser Werbeanzeige zugeordneten Custom Audience ist ein Fehler aufgetreten. Wir arbeiten an der Behebung des Problems. Versuche es später erneut.
logged_out_ads	Eine der folgenden: 1. Nur Anzeigen mit Seitenbeiträgen sind für abgemeldete Anzeigen zulässig. 2. Die für eine abgemeldete Anzeige verwendete Story ist nicht öffentlich.