Partage d’audiences personnalisées entre comptes Business Manager

L’API Business Manager établit clairement les rôles et les responsabilités liés à l’accès à une audience appartenant à une autre entreprise.

Lorsqu’une audience personnalisée est partagée entre plusieurs groupes, une relation de partenariat doit d’abord être établie entre les comptes Business Manager. Ceci se trouve dans la section Partners des Business Settings dans le compte Business Manager. Le groupe qui partage l’audience doit également affirmer sa conformité avec nos conditions du service d’Audience personnalisée fournies dans le compte Business Manager. Voir Facebook, Conditions d’audience personnalisée.

Une fois établie, une relation de partage permet à une entreprise de partager des audiences avec un autre compte Business Manager. Cependant, les audiences ne peuvent être partagées que dans un seul sens. Cela signifie qu’une audience est partagée depuis l’entreprise n° 1 vers l’entreprise n° 2. L’entreprise n° 2 ne peut partager des audiences avec l’entreprise n° 1 que si une relation de partage distincte est établie depuis l’entreprise n° 2 vers l’entreprise n° 1.

Depuis 2018, pour pouvoir partager une audience personnalisée entre comptes Business Manager, lesdites entreprises doivent établir une relation de partage d’audience de la façon suivante. Il vous faut une autorisation admin de compte Business Manager pour demander une relation afin de partager une audience. Si deux comptes Business Manager ont déjà établi la relation, un annonceur peut alors partager directement l’audience avec l’autre entreprise. Voir aussi Audience personnalisée : documentation de référence et Informations du compte partagé d’audience personnalisée : documentation de référence.

Pour créer une relation, effectuez cet appel, à une custom_audience_id spécifique :

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

Nous traitons chaque demande selon le statut de la relation avec l’autre entreprise :

• Nous partageons directement l’audience avec les comptes publicitaires qui ont une relation approuvée.
• Pour les comptes publicitaires qui ont une relation en cours d’approbation, nous ajoutons l’ID d’audience à la demande, de sorte que quand l’entreprise destinataire approuve la demande, nous partageons ensuite l’audience.
• Pour les comptes publicitaires qui n’ont aucune relation, nous élaborons un accord de partage auquel nous joignons l’ID d’audience, de sorte que quand l’entreprise destinataire approuve la demande, nous partageons ensuite l’audience.

Facebook renvoie un objet sharing_data pour chaque compte publicitaire associé à la demande. Par exemple :

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

Les options et les paramètres de cette demande comprennent :

Exemples

Si vous ne disposez d’aucune autorisation admin pour un compte Business Manager et que vous essayez de partager une audience, vous recevrez un message d’erreur similaire à celui-ci :

[   
    {         
       "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"
       ]
    }
...
]

Une fois votre demande effectuée, si l’entreprise à laquelle appartient le compte publicitaire destinataire n’a aucune relation établie avec vous, elle est susceptible de recevoir une demande de relation de partage d’audience en attente. Ce statut est visible sur le compte Business Manager de l’entreprise. Ici l’entreprise peut approuver ou refuser la demande de relation :

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

En cas de réussite, l’entreprise reçoit cette réponse :

{  
    success: bool
}

Options possibles :

Une fois que l’entreprise ayant reçu la demande de relation l’a approuvée, vous pouvez partager une audience avec elle. Lorsque vous effectuez une demande, sharing_data ressemble à ceci :

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

Si vous êtes admin d’un compte Business Manager et que vous partagez une audience avec une demande de relation en attente, Facebook ajoute l’ID d’audience à la relation existante :

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

Comme vous pouvez spécifier plusieurs comptes publicitaires dans votre demande de partage d’audience, les résultats correspondant à chaque compte figurent dans la réponse :

[   
    {         
       "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"
       ]
    }
...
]

Pour visualiser les demandes de partage d’audience reçues par votre entreprise :

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

La réponse se présente comme suit :

{
    "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>"
        }
    }
}

Pour visualiser les demandes de partage d’audience adressées par votre entreprise :

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

La réponse se présente comme suit :

{
    "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>"
        }
    }
}