Teilen des Meta-Pixels zwischen Unternehmen
In mehreren Situationen kann es vorkommen, dass Unternehmen (in der Regel Agenturen) auf den Pixeldatensatz eines anderen Unternehmens zugreifen müssen, um Werbeanzeigen zu verwalten, die Leistung zu analysieren oder Events hochzuladen.
Die folgenden API-Integrationen werden benötigt, um eine Beziehung zwischen dem Pixel und der Agentur herzustellen. Wenn das Empfangsunternehmen (die Agentur) auch Werbeanzeigen für den Kunden verwaltet und dieses Pixel für Werbekonten verwenden muss, gehe zu Schritt 3.
Voraussetzungen: App-Anforderungen
Apps müssen über das Feature Standardzugriff für das Anzeigenmanagement (erweiterter Zugriff) verfügen. Apps sollten auch über die folgenden Berechtigungen verfügen:
business_managementads_managementoderads_readundmanage_pages
Schritt 1: Teilen des Pixels mit Agentur einleiten
Dazu ist ein Nutzer-Zugriffstoken mit den oben genannten App-Berechtigungen von einem Unternehmens-Admin des Pixels erforderlich.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Zu den Optionen und Parametern für diese Anfrage zählen:
| Name | Beschreibung |
|---|---|
Typ: numerisch | Erforderlich. Die ID der Agentur, die Zugriff auf das Pixel erhält |
Typ: list:string | Erforderlich. Beispiel: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Für die Agentur zulässige Aufgaben mit dem Pixel Mögliche Werte: ANALYZE: Anzeigen, analysieren und Werbung schalten. UPLOAD: Website-Conversion-Daten in diesen Datensatz hochladen. ADVERTISE: Werbekonten mit diesem Facebook-Datensatz verbinden. Diesen Datensatz für Werbung verwenden. EDIT: Datensatz verwalten, Einstellungen bearbeiten, analysieren und Werbung schalten. (Der EDIT-Zugriff ist momentan eingeschränkt. Bitte deine*n Meta-Ansprechpartner*in, deine App zuzulassen.) |
Wir verarbeiten eine Anfrage auf Basis des Beziehungsstatus mit dem anderen Unternehmen:
- Unternehmen mit einer genehmigten Beziehung: Wir teilen das Pixel direkt mit diesen Unternehmen.
- Unternehmen mit einer laufenden Beziehung: Wir fügen das Pixel zur Anfrage hinzu und teilen es, wenn das Empfangsunternehmen die Anfrage genehmigt.
- Unternehmen ohne Beziehung: Wir erstellen eine Vereinbarung zum Teilen mit angehängtem Pixel. Wenn das Empfangsunternehmen diese Anfrage genehmigt, wird das Pixel mit dem Unternehmen geteilt.
Wenn das Pixel erfolgreich mit dem Unternehmen geteilt wurde, wird die folgende Antwort zurückgegeben:
{
success: true,
}
Wenn die Annahme der Vereinbarung zum Teilen aussteht, gibt die API-Anfrage die folgende Antwort mit pending_request_id zurück. Wenn das Empfangsunternehmen die Anfrage annimmt, wird das Pixel automatisch mit dem Empfangsunternehmen geteilt. Infos zum Annehmen/Ablehnen der Anfrage findest du in Schritt 2.
{
"success": true,
"pending_request_id": "{request_id}"
}
Beachte, dass ein Pixel nur mit einer begrenzten Anzahl an Unternehmen geteilt werden kann.
Schritt 2: Ausstehende Anfrage annehmen (wenn erforderlich)
Nach Einleitung der Anfrage zum Teilen des Pixels kann die Agentur eine ausstehende Vereinbarungsanfrage erhalten, wenn sie noch keine Beziehung mit dem Eigentümerunternehmen des Pixels hat. Admins des Empfangsunternehmen können diese Anfrage im Business Manager sehen und annehmen.
Um die Beziehungsanfrage mit der API zu genehmigen oder abzulehnen, rufe die request_id von der Fehlerantwort aus Schritt 1 ab.
Die API erfordert ein Nutzer-Zugriffstoken von den Admins des Empfangsunternehmen mit business_mangement oder ads_management permission für die App.
POST <request_id>?request_status="approve"
Wenn der Vorgang erfolgreich ist, gibt die API diese Antwort zurück:
{
success: bool
}
Zu den Optionen und Parametern für diese Anfrage zählen:
| Name | Beschreibung |
|---|---|
Typ: String | Erforderlich. Gibt an, ob das Unternehmen, das eine Anfrage zum Teilen des Pixels erhält, die Anfrage genehmigt oder ablehnt. Mögliche Werte: |
Schritt 3: Pixel mit Werbekonten der Agentur teilen
Wenn eine Agentur Werbeanzeigen für einen Kunden verwaltet und den Werbekonten des Kunden die Nutzung des Pixeldatensatzes gestatten muss, verwende diese API.
Wenn das Pixel mit einem Unternehmen mit Werbe-/Analyseberechtigungen geteilt wurde, kann das Unternehmen es den Werbekonten im Unternehmen gestatten, den Pixeldatensatz für Werbung zu verwenden.
Die API erfordert ein Nutzer-Zugriffstoken mit business_management-, ads_management- oder ads_read-Berechtigungen von den Unternehmens-Admins.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Name | Beschreibung |
|---|---|
Typ: numerisch | Erforderlich. Unternehmen, das Werbeanzeigen verwaltet und Zugriff auf Pixel und Werbekonten hat. Die Person, deren Zugriffstoken verwendet wurde, sollte über Admin-Berechtigungen in diesem Unternehmen verfügen. |
Typ: numerisch | Erforderlich. Für das Pixel zulässige Werbekonto. |
Schritt 4: Verbindung zum Teilen des Pixels löschen
Wenn die Verbindung zwischen Pixel und Agentur nicht mehr benötigt wird, lösche sie mit der folgenden API.
Delete <adspixel>/agencies?business=<agency_business_id>
Die API erfordert ein Nutzer-Zugriffstoken vom Eigentümerunternehmen des Pixels.
Wenn der Vorgang erfolgreich ist, gibt die API diese Antwort zurück:
{
success: true
}