Como compartilhar o Pixel da Meta entre empresas
Há vários casos de uso possíveis para que uma empresa acesse um conjunto de dados de pixel de outra empresa (normalmente uma agência), como gerenciar anúncios, analisar o desempenho ou carregar eventos.
Confira a seguir as integrações de API necessárias para estabelecer um relacionamento entre o pixel e a agência. Se a empresa destinatária (agência) também gerenciar anúncios para o cliente e precisar usar o pixel para contas de anúncios, consulte a etapa 3.
Pré-requisitos: exigências para apps
Os apps devem ter o recurso Acesso Padrão ao Gerenciamento de Anúncios (acesso avançado). Eles também devem ter as seguintes permissões:
business_managementads_managementouads_reademanage_pages
Etapa 1: iniciar o compartilhamento do pixel com a agência
Esse processo requer um token de acesso do usuário com as permissões de app anteriores de um administrador da empresa proprietária do pixel.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Veja as opções e os parâmetros para essa solicitação:
| Nome | Descrição |
|---|---|
Tipo: numérico | Obrigatório. A identificação da agência que recebe acesso ao pixel. |
Tipo: list:string | Obrigatório. Exemplo: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Tarefas que a agência pode executar com o pixel. Valores possíveis: ANALYZE: visualize, analise e anuncie usando o pixel. UPLOAD: carregue dados de conversão do site neste conjunto de dados. ADVERTISE: conecte contas de anúncios a este conjunto de dados do Facebook. Use o conjunto de dados para fins de publicidade. EDIT: gerencie conjunto de dados, edite configurações, analise e anuncie. No momento, o acesso a EDIT está restrito. Entre em contato com seu representante da Meta para colocar seu app na lista de permissão. |
Gerenciamos uma solicitação com base no status de relacionamento com a outra empresa:
- Empresas que possuem um relacionamento atual aprovado. Compartilhamos o pixel diretamente com essas organizações.
- Empresas que possuem um relacionamento em andamento. Adicionamos o pixel à solicitação para que possamos compartilhá-lo assim que a empresa destinatária fornecer aprovação.
- Empresas que não possuem nenhum relacionamento. Criamos um acordo de compartilhamento com o pixel anexado para que ele possa ser compartilhado assim que a empresa destinatária aprovar a solicitação.
Se o pixel for compartilhado com sucesso, a seguinte resposta será retornada:
{
success: true,
}
Se o acordo de compartilhamento ainda estiver pendente de aceitação, a solicitação da API retornará a seguinte resposta com pending_request_id. Quando a empresa destinatária aceitar a solicitação, o pixel será compartilhado com ela de forma automática. Consulte a etapa 2 para aceitar/recusar a solicitação.
{
"success": true,
"pending_request_id": "{request_id}"
}
Há um limite em relação ao número de empresas com as quais um pixel pode ser compartilhado.
Etapa 2: aceitar uma solicitação pendente (se necessário)
Depois de iniciar a solicitação de compartilhamento de pixel, a agência poderá receber uma solicitação de acordo compartilhado pendente caso ainda não tenha um relacionamento com a empresa proprietária do pixel. Os administradores da empresa destinatária poderão ver e aceitar a solicitação no respectivo Gerenciador de Negócios.
Para aprovar ou recusar a solicitação de relacionamento usando a API, obtenha o request_id da resposta de erro na etapa 1.
A API requer um token de acesso do usuário do administrador da empresa destinatária com business_mangement ou ads_management permission para o app.
POST <request_id>?request_status="approve"
Em caso de sucesso, a API retornará esta resposta:
{
success: bool
}
Veja as opções e os parâmetros para essa solicitação:
| Nome | Descrição |
|---|---|
Tipo: string | Obrigatório. Indica se a empresa que recebeu um pedido de compartilhamento de pixel aprovou ou rejeitou a solicitação. Valores possíveis: |
Etapa 3: compartilhar o pixel com contas de anúncios da agência
Se uma agência estiver gerenciando anúncios para um cliente e precisar permitir que contas de anúncios específicas usem o conjunto de dados do pixel, utilize esta API.
Depois que o pixel for compartilhado em uma empresa com permissões "advertise" ou "analyze", ela poderá permitir que contas de anúncios dentro da organização usem o conjunto de dados do pixel para fins de publicidade.
A API requer um token de acesso do usuário com as permissões business_management, ads_management ou ads_read do administrador da empresa.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Nome | Descrição |
|---|---|
Tipo: numérico | Obrigatório. A empresa que gerencia anúncios e tem acesso ao pixel e às contas de anúncios. O usuário cujo token de acesso foi usado deve ter permissões de administrador na empresa. |
Tipo: numérico | Obrigatório. A conta de anúncios que receberá permissão em relação ao pixel. |
Etapa 4: excluir uma conexão de compartilhamento de pixel
Se a conexão entre o pixel e a agência não for mais necessária, use a API a seguir para excluí-la.
Delete <adspixel>/agencies?business=<agency_business_id>
A API requer um token de acesso do usuário do administrador da empresa proprietária do pixel.
Em caso de sucesso, a API retornará esta resposta:
{
success: true
}