Integração do Marketplace da FBE

A Extensão do Facebook para Empresas (FBE, pelas iniciais em inglês) permite que os vendedores veiculem anúncios facilmente em toda a família de apps do Facebook conectando ativos existentes da plataforma, como uma Página do Facebook ou um Gerenciador de Negócios, ou criando ativos totalmente novos. A FBE pode ser usada para ajudar a integrar os vendedores do Marketplace às soluções da Meta.

Abaixo, estão as principais etapas específicas para o fluxo do Marketplace. Recomendamos que você siga esses passos e a documentação para desenvolvedores.

Fluxo do Marketplace da FBE

Parceiro = Marketplace

FBE = Extensão do Facebook para Empresas (interface do usuário de propriedade do Facebook)

Antes de começar

Seu aplicativo deve pertencer a um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar a sua empresa.
É necessário um aplicativo do Facebook com as seguintes permissões aprovadas por meio da análise do aplicativo:

Permissão privada
1. manage_business_extension — Esta é uma permissão privada que exige que o seu representante da Meta adicione o seu app à lista de permissão.
Permissões públicas (o Marketplace precisa solicitar essas permissões por meio da análise do app).
1. business_management — necessário para obter o ID do Gerenciador de Negócios criado por meio da FBE e usar a API do Gerenciador de Negócios para gerenciar ativos de negócios.
2. ads_management — necessário para gerenciar os anúncios dos vendedores em nome do cliente.

Principais etapas para a FBE e a API de Anúncios Colaborativos

O vendedor (marca) abre a tela pop-up de configuração da FBE por meio do site do marketplace
O vendedor passa pelo fluxo de integração da FBE e conclui a configuração dos ativos principais (Gerenciador de Negócios, Página e assim por diante).
A FBE informa que o vendedor configurou com sucesso as identificações de ativos (via API ou Webhook). Depois que o Marketplace recebe as identificações, o segmento de catálogo pode ser criado/compartilhado via API ou interface do usuário (usando a ferramenta Central de Colaboração no Gerenciador de Negócios).
O vendedor inicia a visualização de gerenciamento da FBE, onde é possível ver o status do segmento de catálogo criado e aceitar os Termos de Serviço (caso seja a primeira vez que ele esteja recebendo uma solicitação de segmento de catálogo do Marketplace).
O Marketplace redireciona o vendedor para o fluxo de criação de anúncios (fluxo de produtor existente – Gerenciador de Anúncios e assim por diante).

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

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 o 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. O vertical associado à empresa para o Marketplace é `ECOMMERCE`
`merchant_settings_id` Tipo: string	Opcional. Usado ao atualizar a partir da versão 1 da Extensão do Facebook para Empresas. Entre em contato com o seu representante do Facebook se estiver migrando da versão 1 para a 2.
`channel` Tipo: enumeração	Obrigatório. Permite que o parceiro expresse a intenção do usuário em relação aos recursos que exigem etapas ou restrições adicionais: Observação: o `channel` para o fluxo da FBE específico do Marketplace é `MARKETPLACE`. Não deixe de passar esse parâmetro no campo `channel`.
`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.
`page_id` Tipo: string	Opcional Identificação da Página do Facebook existente do usuário que o parceiro pode inserir para fazer a pré-seleção 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 o Messenger e muito mais. Cada campo inclui um "tipo" vinculado às respectivas tabelas abaixo.

Campo	Descrição
`business` FBEBusinessPropertiesConfigData	Obrigatório. Informações para a empresa do usuário final
`messenger_chat` FBEMessengerChatConfigData	Opcional. Recursos de bate-papo do Messenger na Página do Facebook do usuário final, como `enabled` e `domains`
`catalog_feed_scheduled` FBECatalogFeedConfigData	Opcional. Determina se a Extensão do Facebook para Empresas deve usar uma abordagem de feed, que obtém itens do catálogo de uma `feed_url`
`page_cta` FBEPageCtaConfigData	Opcional. Botão de chamada para ação (CTA) na página do usuário final, como `cta_button_text`, `cta_button_url` e assim por diante.
`ig_cta` FBEIGCtaConfigData	Opcional. Características do recurso de chamada para ação do Instagram, como `enabled`, `cta_button_text`, `cta_button_url` e assim por diante.
`messenger_menu` FBEMessengerMenuConfigData	Opcional. Características do recurso de menu persistente do Messenger, como `cta_button-text` e `cta_button_url`

Após a instalação

Obtenha identificações de ativos e verifique notificações de webhooks e eventos de pixel.
Assim que as identificações de ativos forem recebidas, crie/compartilhe o segmento de catálogo via API ou interface do usuário (usando a ferramenta Central de Colaboração no Gerenciador de Negócios).
Depois que a chamada de API para criação do segmento de catálogo for bem-sucedida, confira este link para obter detalhes sobre como iniciar o pop-up da visualização de gerenciamento da FBE para que o vendedor aceite os segmentos de catálogo compartilhados e conclua a integração.

Inicie a visualização de gerenciamento da FBE após a configuração ser concluída e as identificações de ativos serem retornadas com sucesso por meio de Webhooks/APIs.