Integração de Público Personalizado da FBE

O Público Personalizado na Extensão do Facebook para Empresas (FBE) permite que as empresas otimizem seu direcionamento de anúncios criando um público dos seus clientes, visitantes do site, visitantes do app para celular ou pessoas semelhantes a eles. O fluxo de integração do Público Personalizado da FBE permite que as empresas configurem ou integrem o seguinte:

Gerenciador de Negócios
Página do Facebook
Conta de anúncios

Este documento descreve os principais pré-requisitos para o fluxo de Público Personalizado da FBE, juntamente com uma visão geral de alto nível das etapas necessárias para concluir o processo. Consulte o guia da Extensão do Facebook para Empresas para obter detalhes específicos sobre integrações gerais.

Exemplo - Fluxo de integração da superfície do parceiro (Login de Empresa)

Antes de começar

Seu app deve pertencer a um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa.
Um app do Facebook é obrigatório com o seguinte nível de acesso, recurso e permissões:
- Nível de acesso: acesso avançado
- Recurso: Acesso Padrão ao Gerenciamento de Anúncios
- Permissões públicas: ads_management
- Permissões privadas: manage_business_extension — Esta é uma permissão privada que exige que o representante do Facebook adicione seu app à lista de permissões.
Configure a autenticação por meio do Login de Empresa (na plataforma do parceiro) ou dos Apps de negócios (no Facebook) com as configurações obrigatórias e inicialize o fluxo de integração da FBE.

Configurações obrigatórias

Extras

Campo Tipo Descrição

Campo	Tipo	Descrição
`setup`	setup	Obrigatório A configuração do Facebook do vendedor, como o identificador único (`external_business_id`) ou a moeda do catálogo (`currency`). Consulte detalhes de objetos de configuração.
`business_config`	business_config	Obrigatório Objeto de configuração que a Extensão do Facebook para Empresas usa para configurar o fluxo de trabalho da Extensão do Facebook para Empresas. Consulte detalhes do objeto `business_config`.
`repeat`	booliano	Obrigatório Defina esse valor como `false`.

setup

setup

Obrigatório

A configuração do Facebook do vendedor, como o identificador único (external_business_id) ou a moeda do catálogo (currency). Consulte detalhes de objetos de configuração.

business_config

business_config

Obrigatório

Objeto de configuração que a Extensão do Facebook para Empresas usa para configurar o fluxo de trabalho da Extensão do Facebook para Empresas. Consulte detalhes do objeto business_config.

repeat

booliano

Obrigatório

Defina esse valor como false.

Configuração

Use este objeto para definir as configurações para a presença do usuário final no Facebook

Campo	Descrição
`external_business_id` Tipo: string	Obrigatório. identificação da empresa única para representar a empresa do seu cliente. Usamos isso como um identificador único. Por exemplo, se a empresa do vendedor se chama "Fubar", "fubar-123" poderá ser seu `external_business_id`.
`timezone` Tipo: string	Obrigatório. O fuso horário em que a empresa está localizada. Consulte possíveis valores de fuso horário.
`currency` Tipo: string	Obrigatório. Código de moeda ISO de três letras da moeda-padrão usada para os itens do catálogo da empresa. Consulte os códigos de moeda compatíveis.
`business_vertical` Tipo: enumeração	Obrigatório. Vertical associado à empresa Valores:`CUSTOM_AUDIENCE`
`channel` Tipo: enumeração	Obrigatório. Fornece uma forma para o parceiro configurar o fluxo da FBE. Para o fluxo de público personalizado, esse valor deve ser `CUSTOM_AUDIENCE`. `CUSTOM_AUDIENCE` — Fluxo que permite que os usuários finais criem ou selecionem Gerenciador de Negócios, Conta de Anúncios e Página do Facebook. A configuração com esses ativos permite que o usuário final crie um público personalizado no Facebook por meio de uma plataforma de terceiros.
`business_manager_id` Tipo: string	Opcional. Identificação do Gerenciador de Negócios existente do usuário que um parceiro pode inserir para fazer a pré-seleção no fluxo de configuração.
`ad_account_id` Tipo: string	Opcional. Identificação para a conta de anúncios existente do usuário que um parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`page_id` Tipo: string	Opcional. Identificação para a Página do Facebook existente do usuário que o parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.

Configuração da empresa

Use este objeto para definir as configurações da empresa para um usuário final. Isso inclui CTAs, cartão de serviços e muito mais. Cada campo inclui um "tipo" vinculado às respectivas tabelas abaixo.

Campo	Descrição
`business` Tipo: FBEBusinessPropertiesConfigData	Obrigatório. Informações para a empresa do usuário final.

Próximas etapas

Receba notificações de Webhooks sobre empresas instalando e desinstalando a FBE.
Dispare eventos do pixel para cada empresa integrada à FBE na sua plataforma.
Adicione um ponto de entrada à nossa Visualização de gerenciamento de recursos a partir da sua superfície.
Permita que as empresas desinstalem a FBE.
Faça um envio para a análise de integração com a FBE. Assim que a integração for aprovada, seu app estará disponível para usuários públicos.