Condivisione di gruppi di pubblico personalizzato tra Business Manager

L'API Business Manager stabilisce ruoli e responsabilità chiari quando si accede a un gruppo di pubblico appartenente a un altro Business Manager.

Quando un pubblico personalizzato viene condiviso tra le parti, deve essere prima stabilita una partnership tra i Business Manager. Questo argomento è trattato nella sezione Partners di Business Settings in Business Manager. La parte che condivide il pubblico deve inoltre dichiarare la propria conformità ai termini di servizio del pubblico personalizzato forniti in Business Manager (vedi Facebook, Termini del pubblico personalizzato).

Una volta stabilita, una relazione di condivisione consente a un Business Manager di condividere gruppi di pubblico con un altro Business Manager. Tuttavia, la condivisione dei gruppi di pubblico è esclusivamente unidirezionale. Ciò significa che il pubblico è condiviso dal Business Manager n. 1 al Business Manager n. 2. Il Business Manager n. 2 non sarà in grado di ricondividere il pubblico con il Business Manager n. 1 a meno che non venga stabilita una relazione di condivisione separata dal Business Manager n. 2 al n. 1.

A partire dal 2018, per condividere un pubblico personalizzato tra più Business Manager, tali Business Manager devono stabilire una relazione di condivisione del pubblico nel modo seguente. È necessaria l'autorizzazione di amministratore di Business Manager per richiedere una relazione per condividere un pubblico. Se due Business Manager hanno già stabilito la relazione, un inserzionista può condividere direttamente il pubblico con l'altro Business Manager. Vedi inoltre Riferimento, Pubblico personalizzato e Riferimento, Informazioni su account condivisi per il pubblico personalizzato.

Per creare una relazione, effettua questa chiamata, su un custom_audience_id specifico:

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

Gestiamo le richieste in base allo stato della relazione con l'altro Business Manager:

• Per gli account pubblicitari che hanno una relazione approvata esistente, condividiamo il pubblico direttamente.
• Per gli account pubblicitari con una relazione esistente in corso, viene aggiunto l'ID del pubblico alla richiesta in modo che quando il Business Manager destinatario approva la richiesta, il pubblico viene condiviso.
• Per gli account pubblicitari che non hanno alcuna relazione, creiamo un accordo di condivisione al quale viene associato l'ID del pubblico in modo tale che, quando il Business Manager destinatario approva la richiesta, possiamo condividere il pubblico.

Facebook restituisce un oggetto sharing_data per ogni account pubblicitario passato nella richiesta. Ad esempio:

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

Le opzioni e i parametri per questa richiesta includono:

Esempi

Se non disponi delle autorizzazioni di amministratore per il Business Manager e tenti di condividere un pubblico, ottieni un errore simile al seguente:

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

Dopo aver effettuato una richiesta, il Business Manager proprietario dell'account pubblicitario destinatario, se non ha una relazione con te, può ricevere una richiesta di relazione per pubblico condiviso in sospeso. Questo stato può essere visualizzato sul proprio Business Manager. A questo punto, il Business Manager può approvare o rifiutare la richiesta di relazione:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

In caso di azione eseguita con successo, il Business Manager riceve questa risposta:

{  
    success: bool
}

Le opzioni includono:

Dopo aver ricevuto l'approvazione da parte del Business Manager che ha ricevuto una richiesta di relazione, puoi condividere il pubblico. Quando effettui una richiesta, sharing_data appare nel modo seguente:

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

Se sei un amministratore di Business Manager e condividi un pubblico con una richiesta di relazione in sospeso, Facebook aggiunge l'ID del pubblico alla relazione esistente:

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

Poiché nella richiesta è possibile specificare più account pubblicitari di condivisione di un pubblico, nella risposta vengono visualizzati i risultati per ciascun account:

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

Per visualizzare le richieste di condivisione di un pubblico ricevute dal tuo Business Manager:

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

La risposta si presenta così:

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

Per visualizzare le richieste inviate dal tuo Business Manager di condivisione di un pubblico con altre parti:

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

La risposta si presenta così:

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