Guia de migração: Instagram (IX) para Extensão da Meta para Empresas v2

Como um dos nossos parceiros nos botões de ação do Instagram, com tecnologia da integração de experiências instantâneas (IX, pelas iniciais em inglês), você deve atender aos seguintes requisitos da Extensão da Meta para Empresas v2 a fim de manter os botões de chamada para ação Pedir refeição e a funcionalidade de figurinha dos Stories Pedidos de refeição:

1. URL de autenticação: para permitir que suas empresas integrem a Extensão da Meta para Empresas (MBE, pelas iniciais em inglês) a partir do Facebook ou do Instagram.
2. Webhook: para receber notificações imediatas sempre que uma das suas empresas instalar ou desinstalar a MBE.
3. Disparo de eventos de pixel: para ajudar suas empresas a melhorar o direcionamento de novos clientes, aumentar o número de transações nos seus sites e mensurar como a integração da MBE está ajudando a impulsionar os resultados.

Depois de concluir o desenvolvimento e os testes relacionados à MBE, a Meta analisará e verificará sua integração. Assim que for aprovada, seu app ficará disponível para usuários públicos.

Antes de começar

• Inscreva-se como desenvolvedor da Meta para acessar nossas ferramentas para desenvolvedores e criar apps na plataforma.
• Caso ainda não tenha feito isso, crie um app da Meta.
• Crie uma versão de teste do seu app publicado/em produção e use-a para executar todos os novos desenvolvimentos e testes.
• Os apps (publicados/em produção) devem ser do tipo Empresa e pertencer a um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa e adicionar seus apps a ela.
• Entre em contato com seu parceiro da Meta e compartilhe os IDs dos apps para que ele possa conceder a você acesso ao recurso manage_business_extension da MBE. Depois de receber aprovação, será possível iniciar a implementação.

Configurar sua integração por meio do Painel do Desenvolvedor

O Painel do Desenvolvedor da Extensão da Meta para Empresas é um produto que você encontra no Painel de Apps. Depois que seus apps receberem acesso ao recurso da MBE, use o Painel do Desenvolvedor para configurar e validar sua integração (incluindo a URL de autenticação e o ponto de extremidade de webhook).

Etapa 1: adicione o Painel do Desenvolvedor da MBE aos seus apps de desenvolvedor do Facebook.

Etapa 2: na aba Configuração, selecione Food and Drink como seu único setor, escolha Instagram Call to Action Button e Page Surface Call To Action Button como recursos e inclua todos os domínios do app no cartão de domínios curinga.

Etapa 3: depois de criar a URL de autenticação, use a superfície Apps de Negócios na aba Configuração para validar sua URL (se algum erro estiver listado). Quando obtiver a marca verde, acesse Apps de Negócios da Meta para fazer testes de ponta a ponta.

Etapa 4: depois de criar um webhook, configure-o no produto Webhooks. Se a configuração for concluída conforme o esperado, você verá uma marca verde no item de webhook validado exibido na aba Visão geral.

Etapa 5: depois de disparar os eventos de pixel obrigatórios, preencha o questionário sobre pixel (incluindo um vídeo para validar a implementação do pixel).

Etapa 6: ajude nossa equipe a verificar e aprovar sua integração fornecendo detalhes no cartão exibido na aba Análise de integração. Isso deve incluir as credenciais de acesso da sua plataforma para fazer login na URL de autenticação. Adicione um link de screencast mostrando a experiência de integração completa e os recursos que você habilitou.

Etapa 7: quando você finalizar a implementação da MBE, complete a lista de verificação na aba Visão geral no Painel do Desenvolvedor. Preencha os formulários referentes aos detalhes do app e à análise de integração na aba Análise de integração. Clicar no botão de envio iniciará o processo de análise. Assim que a integração for aprovada, será possível lançar seu app para usuários públicos na aba de lançamento. Entenda o processo de análise de integração e saiba como receber feedback e informações da nossa equipe sobre o status atual da sua solicitação.

Criar uma URL de autenticação

Os Apps de Negócios, disponíveis nas superfícies da Meta, são o destino de empresas que querem descobrir e se conectar a apps de negócios de terceiros para configurar facilmente ferramentas corporativas por um custo baixo de tecnologia a fim de crescer e atingir as metas de negócios.

A MBE v2 usa uma URL de autenticação como um canal confiável para compartilhar a configuração comercial do usuário (nome, URL para o CTA e assim por diante) entre sua plataforma e o Instagram/Facebook.

Sua URL de autenticação precisa aceitar um parâmetro de consulta GET redirect_uri. Além disso, recomendamos o seguinte:

1. Permita que os usuários façam login na sua plataforma e forneça também a opção de registrar uma nova conta (ou seja, "inscrever-se").
2. Caso você aceite várias empresas por conta na sua plataforma, exiba uma interface para o usuário selecionar qual delas ele quer associar à presença no Facebook.
3. Obtenha o parâmetro de consulta redirect_uri recebido e anexe a ele o objeto extras codificado como um parâmetro de consulta.
4. Redirecione os usuários à URL resultante (somente se o redirect_uri recebido corresponder à nossa expressão regular).

Exemplo: use o objeto extras para configurar uma empresa e habilitar as CTAs do perfil do Instagram e da Página do Facebook.

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

Para saber mais sobre a implementação completa e os testes, consulte Autenticação de Apps de Negócios.

Criar um webhook

Depois que um usuário instala, atualiza ou desinstala seu app via Apps de Negócios, você recebe os detalhes dessa ação por meio de um webhook.

Para configurar o webhook, é necessário fazer o seguinte:

1. Crie um ponto de extremidade em um servidor seguro que possa processar solicitações POST do Facebook.
2. Configure o produto Webhooks no Painel de Apps do seu app para assinar o campo User do objeto fbe_install.

Para saber mais sobre a implementação completa e a configuração, consulte Obter IDs e tokens de acesso de ativos: Webhooks.

Disparar eventos de pixel

O Pixel da Meta é parte integrante da Extensão da Meta para Empresas v2. Exigimos que você dispare com precisão os seguintes eventos padrão para cada empresa integrada à MBE na sua plataforma.

Eventos obrigatórios

• Para todas as páginas envolvidas no processo de pedido de refeição, dispare PageView.
• Depois que o pedido for efetuado, dispare Purchase.

Eventos opcionais

• Dispare AddToCart quando um item for adicionado ao pedido.

Todos os eventos padrão podem ser disparados por meio da chamada à função fbq('track') do pixel, com o nome do evento e, opcionalmente, um objeto JSON como parâmetros. Por exemplo, o evento de compra requer que a moeda e o valor sejam incluídos como um parâmetro:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Para saber mais sobre a implementação completa, consulte Acionar eventos de pixel.

Ferramenta para Pixel

Recomendamos que você instale nossa extensão do Chrome Ferramenta para Pixel da Meta. A Ferramenta para Pixel fornece feedback valioso para ajudar a verificar se o pixel está funcionando conforme o esperado. Isso é especialmente útil quando você começa a rastrear conversões e encontra erros de formatação.

Análise de integração e lançamento

Quando você finalizar a implementação da MBE, complete a lista de verificação na aba Visão geral no Painel do Desenvolvedor. Preencha os formulários referentes aos detalhes do app e à análise de integração na aba Análise de integração. Clicar no botão de envio iniciará o processo de análise.

A análise de integração é o processo que usamos para verificar sua integração da Extensão da Meta para Empresas. Assim que for aprovada, será possível lançar seu app para usuários públicos na aba de lançamentos. Saiba mais sobre esse processo.

Depois de enviar sua integração na aba Análise de integração no Painel do Desenvolvedor, será possível visualizar o status, as atualizações e os comentários dos nossos analistas na seção de histórico de envio do cartão Análise de integração.

Nossos analistas fornecerão feedback detalhado. Caso seu app seja rejeitado, conclua todas as etapas necessárias antes de iniciar um novo processo de análise. Para fazer isso, clique no botão de reenvio na aba Análise de integração.