Compartilhamento de Públicos Personalizados entre Gerenciadores de Negócios

A API do Gerenciador de Negócios estabelece funções e responsabilidades claras ao acessar um público pertencente a outro negócio.

Quando um Público Personalizado for compartilhado entre as partes, um relacionamento de parceria deverá ser estabelecido antes entre os Gerenciadores de Negócios. Essa é a seção Partners das Business Settings no Gerenciador de Negócios. A parte que estiver compartilhando o público também deverá afirmar sua conformidade com os termos de serviço do Público Personalizado fornecidos no Gerenciador de Negócios. Consulte Facebook, Termos do Público Personalizado.

Depois de estabelecido, um relacionamento de compartilhamento possibilitará que uma empresa compartilhe públicos com outro Gerenciador de Negócios. Porém, os públicos só podem ser compartilhados em uma direção. Isso significa que o público é compartilhado da empresa 1 para a empresa 2. A empresa 2 não poderá compartilhar públicos de volta para a empresa 1, a menos que seja estabelecida uma relação de compartilhamento separada da empresa 2 para a 1.

Desde 2018, para compartilhar um Público Personalizado entre Gerenciadores de Negócios, essas empresas devem estabelecer um relacionamento de compartilhamento de públicos conforme abaixo. Você precisa ter permissão de administrador do Gerenciador de Negócios para solicitar um relacionamento a fim de compartilhar um público. Se dois Gerenciadores de Negócios já tiverem estabelecido um relacionamento, o anunciante poderá compartilhar diretamente o público com a outra empresa. Consulte também Referências, Público Personalizado e Referências, Informações da conta compartilhada de Público Personalizado.

Para criar um relacionamento, faça esta chamada a um custom_audience_id específico:

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

Controlamos uma solicitação com base no status de relacionamento com a outra empresa:

• Para contas de anúncios com um relacionamento existente aprovado, compartilhamos o público diretamente com elas.
• Para contas de anúncios que têm um relacionamento existente em andamento, adicionamos o ID do público a uma solicitação para que a empresa destinatária aprove essa solicitação antes de compartilharmos o público.
• Para contas de anúncios que não têm um relacionamento, criamos um acordo de compartilhamento com o ID do público anexado a ele para que a empresa destinatária aprove essa solicitação. Depois, poderemos compartilhar o público.

O Facebook retorna um objeto sharing_data para cada conta de anúncios transmitida na solicitação. Por exemplo:

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

As opções e os parâmetros para essa solicitação incluem:

Exemplos

Se você não tiver permissões de administrador para o Gerenciador de Negócios e tentar compartilhar um público, um erro semelhante a este será exibido:

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

Depois que você fizer a solicitação, a empresa proprietária da conta de anúncios destinatária poderá receber uma solicitação de relacionamento de público compartilhado pendente se ela ainda não tiver um relacionamento com você. Ela pode ver esse status no Gerenciador de Negócios. Nesse momento, a empresa pode aprovar ou recusar a solicitação de relacionamento:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

Quando a solicitação é bem-sucedida, sua empresa obtém esta resposta:

{  
    success: bool
}

As opções incluem:

Depois que a empresa que recebeu uma solicitação de relacionamento a aprovar, você poderá compartilhar públicos com ela. Quando você faz uma solicitação, o sharing_data é semelhante a este:

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

Se você for um administrador do Gerenciador de Negócios e compartilhar um público com uma solicitação de relacionamento pendente, o Facebook anexará o ID do público ao relacionamento existente:

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

Já que é possível especificar várias contas de anúncios na solicitação para compartilhar um público, os resultados de cada conta serão exibidos na resposta:

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

Para ver solicitações de compartilhamento de um público recebidas pela sua empresa:

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

A resposta será semelhante a esta:

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

Para ver solicitações enviadas pela sua empresa para compartilhar um público com outros:

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

A resposta será semelhante a esta:

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