Custom Audiences zwischen Business Managern teilen

Die Business Manager API legt klare Rollen und Verantwortlichkeiten für den Zugriff auf eine Zielgruppe fest, die einem anderen Unternehmen gehört.

Wenn eine Custom Audience zwischen Parteien geteilt wird, muss zwischen den Business Managern zuerst eine Partnerschaftsbeziehung hergestellt werden. Das ist der Abschnitt Partners von Business Settings im Business Manager. Die Partei, die die Zielgruppe teilt, muss auch ihre Einhaltung unserer Nutzungsbedingungen für Custom Audiences bestätigen, die im Business Manager bereitgestellt werden, siehe Facebook, Nutzungsbedingungen für Custom Audiences.

Sobald eine Beziehung zum Teilen von Zielgruppen hergestellt wurde, kann ein Unternehmen Zielgruppen mit einem anderen Business Manager teilen. Allerdings können Zielgruppen nur in eine Richtung geteilt werden. Das bedeutet, dass die Zielgruppe von Unternehmen 1 mit Unternehmen 2 geteilt wird. Unternehmen 2 kann keine Zielgruppen mit Unternehmen 1 teilen, es sei denn, es wurde eine separate Beziehung zum Teilen von Zielgruppen von Unternehmen 2 zu Unternehmen 1 hergestellt.

Seit 2018 müssen Unternehmen, die eine Custom Audience zwischen Business Managern teilen möchten, wie folgt eine Beziehung zum Teilen von Zielgruppen einrichten. Du benötigst die Administratorberechtigung für Business Manager, um eine Beziehung zum Teilen von Zielgruppen anzufordern. Wenn zwei Business Manager bereits eine Beziehung aufgebaut haben, kann ein Werbetreibender die Zielgruppe direkt mit dem anderen Unternehmen teilen. Siehe auch Referenz, Custom Audience und Referenz, Kampagneninfos zu gemeinsamen Custom Audience-Konten.

Um eine Beziehung zu erstellen, führe diesen Aufruf an eine bestimmte custom_audience_id durch:

POST {custom_audience_id}/adaccounts?adaccounts=[<ad_account_id>]&relationship_type=[<relationship_type>] 

Wir verarbeiten eine Anfrage auf Basis des Beziehungsstatus mit dem anderen Unternehmen:

• Mit Werbekonten, die über eine bestehende genehmigte Beziehung verfügen, teilen wir die Zielgruppe direkt.
• Für Werbekonten mit einer bestehenden Beziehung, die sich in Bearbeitung befindet, fügen wir die Zielgruppen-ID zur Anfrage hinzu, damit wir die Zielgruppe teilen können, wenn das Empfängerunternehmen diese Anfrage genehmigt.
• Für Werbekonten, die über keine Beziehung verfügen, erstellen wir eine Vereinbarung zum Teilen von Zielgruppen mit der zugehörigen Zielgruppen-ID, sodass wir die Zielgruppe teilen können, wenn das empfangende Unternehmen dieser Anfrage zustimmt.

Facebook gibt für jedes Werbekonto, das in die Anfrage übergeben wird, ein sharing_data-Objekt zurück. Beispiel:

{  
    success: true,
    sharing_data : [
     {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
     },
     ...
    ]
}

Zu den Optionen und Parametern für diese Anfrage zählen:

Beispiele

Wenn du keine Admin-Berechtigungen für Business Manager hast und versuchst, eine Zielgruppe zu teilen, erhältst du eine Fehlermeldung wie folgende:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

Nachdem du eine Anfrage gestellt hast, kann das Unternehmen, das Eigentümer des empfangenden Werbekontos ist, eine ausstehende Anfrage für eine Beziehung zum Teilen von Zielgruppen erhalten, wenn es noch keine Beziehung zu dir hat. Das Unternehmen kann diesen Status in seinem Business Manager sehen. Zu diesem Zeitpunkt kann das Unternehmen die Beziehungsanfrage genehmigen oder ablehnen:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

Bei Erfolg erhält das Unternehmen diese Antwort:

{  
    success: bool
}

Verfügbare Optionen:

Nachdem das Unternehmen, das eine Beziehungsanfrage erhalten hat, sie genehmigt hat, kannst du Zielgruppen mit ihm teilen. Wenn du eine Anfrage stellst, sieht sharing_data folgendermaßen aus:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
...
]

Wenn du ein Business Manager-Admin bist und eine Zielgruppe mit einer ausstehenden Beziehungsanfrage teilst, hängt Facebook die Zielgruppen-ID mit der bestehenden Beziehung an:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
...
]

Da du in deiner Anfrage zum Teilen einer Zielgruppe mehrere Werbekonten angeben kannst, werden die Ergebnisse für jedes Konto in der Antwort angezeigt:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

So kannst du Anfragen zum Teilen einer Zielgruppe anzeigen, die von deinem Unternehmen empfangen wurden:

GET <BUSINESS_ID>/received_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

Die Antwort sieht folgendermaßen aus:

{
    "data": [   
        {         
           "initiator": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name1"         
            }, 
            "recipient": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]     
         }
         ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}

So kannst du Anfragen zum Teilen einer Zielgruppe mit anderen anzeigen, die von deinem Unternehmen gesendet wurden:

GET <BUSINESS_ID>/initiated_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

Die Antwort sieht folgendermaßen aus:

{
    "data": [
        {         
            "initiator": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name1"         
            }, 
            "recipient": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",         
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]    
        }
        ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}