Business Management APIs

Referenz

Beitrag

Endpunkt	Beschreibung
`/{ad-account-id}/ads`	Werbeanzeigen erstellen
`/{agreement-request-id}`	Genehmige eine ausstehende Unternehmensvereinbarungsanfrage oder lehne sie ab.
`/{business-creative-folder-id}`	Erstelle und aktualisiere einen Business Creative Assets-Ordner.
`/{business-id}/creative_folders`	Stelle einen Business Creative Assets-Ordner bereit.
`/{business-id}/images`	Lade Bilder in einen Creative Assets-Ordner hoch.
`/{business-id}/videos`	Lade Videos in einen Creative Assets-Ordner hoch.
`/{business-creative-folder-id}/agencies`	Füge einen Partner zu einem Creative Assets-Ordner hinzu.
`/{business-creative-folder-id}/assigned_users`	Rufe eine Liste von Personen ab, die Zugriff auf den Business Creatives-Ordner haben.

Lesen

Endpunkt	Beschreibung
`/{business-creative-folder-id}`	Rufe Details über einen Business Creatives-Ordner ab.
`/{business-id}/creative_folders`	Rufe eine Liste der Business Creatives-Ordner ab, auf die ein Unternehmen zugreifen kann.
`/{business-id}/creatives`	Rufe Unternehmensbilder und Unternehmensvideos des Unternehmens ab.
`/{business-id}/initiated_sharing_agreement`	Rufe eine Liste der ausstehenden Vereinbarungsanfragen ab. Dieser Endpunkt wurde im Mai 2020 wieder eingeführt. Zuvor wurde `/initiated_sharing_agreement` mit der Einführung der Graph API V6.0 außer Kraft gesetzt.
`/{business-image-id}`	Rufe Details für ein Bild ab.
`/{business-image-id}/insights`	Erhalte Einblicke zu einem geteilten Bild.
`/{business-video-id}`	Rufe Details zum geteilten Video ab.
`/{business-video-id}/insights`	Erhalte Einblicke zum geteilten Video.
`/{business-creative-folder-id}/agencies`	Rufe eine Liste von Unternehmen ab, die Zugriff auf deinen Creative Assets-Ordner haben.
`/{business-creative-folder-id}/assigned_users`	Rufe eine Liste von Personen ab, die Zugriff auf deinen Creative Assets-Ordner haben.

Löschen

Endpunkt	Beschreibung
`/{business-creative-folder-id}`	Lösche einen Creative Assets-Ordner.
`/{business-creative-folder-id}/agencies`	Entferne einen Partner aus dem Creative Assets-Ordner.
`/{business-creative-folder-id}/assigned_users`	Entferne einen Nutzer aus dem Creative Assets-Ordner.
`/{business-image-id}`	Entferne ein geteiltes Bild.
`/{business-video-id}`	Entferne ein geteiltes Video.

Zulässige Aufgaben

Zulässige Aufgabe für Unternehmensnutzer	Beschreibung
`CREATE_CONTENT`	Dieser Nutzer darf Ordner erstellen.
`MANAGE_CONTENT`	Dieser Nutzer kann Elemente von Creative Assets-Ordnern verwalten.
`MANAGE_PERMISSIONS`	Dieser Nutzer kann Berechtigungen von Creative Assets-Ordnern verwalten.
`VIEW_CONTENT`	Dieser Nutzer kann Elemente in einem Creative Assets-Ordner ansehen.
`VIEW_INSIGHTS`	Dieser Nutzer kann Insights für eine Werbeanzeige ansehen.

Insights

Diese Kennzahlen befinden sich in Entwicklung.

Name der Kennzahl	Beschreibung
`impressions`	Die Häufigkeit, mit der dein Bild oder Video in einer Anzeige erschienen ist.
`inline_link_clicks`	Die Anzahl der Klicks auf Links in deiner Anzeige. Für Inline-Link-Klicks wird ein festes 1-Tages-Klick-Attributions-Fenster verwendet.
`video_play_actions`	Die Häufigkeit, mit der dein Video abgespielt wurde. Wir zählen hierbei jede Video-Impression und schließen Wiederholungen aus.
`actions`	Die Gesamtzahl der Handlungen von Personen, die deinen Werbeanzeigen zugeordnet werden. Diese Handlungen können Interaktionen, Klicks oder Conversions sein. In diese Dokumentation findest du eine vollständige Liste unterstützter Typen.
`video_thruplay_watched_actions`	Die Häufigkeit mit der dein Video vollständig oder mindestens 15 Sekunden lang abgespielt wurde.
`quality_ranking`	Ein Ranking der wahrgenommenen Qualität deiner Anzeige. Die Qualität wird mit Feedback für Anzeigen und dem Erlebnis nach dem Klick gemessen. Es wird ein Ranking der Anzeige im Vergleich zu anderen Anzeigen erstellt, die sich an dieselbe Zielgruppe richten. Mögliche Werte: `BELOW_AVERAGE_10` `BELOW_AVERAGE_20` `BELOW_AVERAGE_35` `AVERAGE` `ABOVE_AVERAGE` `UNKNOWN`, wenn es nicht genug Informationen zur Anzeige vorhanden sind. Das ist mit der Bestimmung der Anzeigenrelevanz verwandt.

Die folgenden Aufschlüsselungen sind verfügbar:

age
gender
country
objective
publisher_platform
platform_position
device_platform
optimization_goal