Zum Hauptinhalt springen
GET
Rufen Sie Anzeigen ab, die für einen bestimmten Facebook-Beitrag beworben wurden. Dieser Endpunkt für beworbene Anzeigen liefert detaillierte Informationen zu den beworbenen Anzeigen, einschließlich Status, aktueller Ausgaben, Leistungskennzahlen (Analytics) und Vorschau-Links.
  • Die Kennzahlen sind Echtzeit-Gesamtwerte für die Anzeigen. Wenn Sie historische Daten benötigen, verwenden Sie den Endpunkt für den Anzeigenverlauf.
  • review ist Metas Prüfung der Anzeige: status ist pending, solange Meta sie prüft, rejected, wenn Meta sie abgelehnt oder Richtlinien-Feedback dazu hinterlassen hat, und approved, wenn die Anzeige aktiv oder vorab genehmigt ist. reasons enthält Metas Erklärungen oder den Namen der Richtlinie, wenn Meta keinen Text liefert, und ist leer, wenn es kein Feedback gibt. review ist null, wenn weder der Status der Anzeige noch ein Feedback die Prüfung erkennen lässt, zum Beispiel bei einer Anzeige, die vor der Prüfung pausiert wurde.
  • Über die previewLink-URL können Sie die Vorschauanzeige mit Ihren Kolleginnen und Kollegen teilen, sodass diese die Anzeige 24 Stunden lang in den verschiedenen Instagram-Formaten sehen. Die Aufrufe Ihrer Kolleginnen und Kollegen werden nicht auf Ihre Werbeausgaben angerechnet.

Header-Parameter

Query-Parameter

string
erforderlich
Ruft alle Anzeigen unter der Konto-ID ab.Die ID des Werbekontos, mit oder ohne das Präfix act_ (1234567890 oder act_1234567890).Erforderlich, wenn adId, socialPostId oder postId nicht gesetzt ist.
string
erforderlich
Ruft eine Anzeige mit der Anzeigen-ID ab.Erforderlich, wenn accountId, socialPostId oder postId nicht gesetzt ist.
string
erforderlich
Ruft Anzeigen mit der Instagram-Social-Post-ID ab.Erforderlich, wenn accountId, adId oder postId nicht gesetzt ist.
number
Standard:25
Ruft maximal limit Anzeigen ab. Maximal 300; höhere Werte werden auf 300 begrenzt.
string
erforderlich
Ruft Anzeigen mit der Ayrshare-Post-ID ab.Erforderlich, wenn accountId, adId oder socialPostId nicht gesetzt ist.
string
Standard:"all"
Filtert Anzeigen nach Status. Lassen Sie diesen Parameter weg, um Anzeigen mit jedem Status zurückzugeben. Gültige Werte sind:
  • active
  • paused
  • deleted
  • archived