Sincronização de público com o Facebook
Usando o Braze Audience Sync to Facebook, você pode optar por adicionar os dados de seus próprios usuários da integração da Braze aos públicos personalizados do Facebook para veicular anúncios com base em disparadores comportamentais, segmentação e muito mais.
Qualquer critério que você normalmente usaria para disparar uma mensagem (push, e-mail, SMS ou webhook) em um Braze Canvas com base nos dados do seu usuário agora pode ser usado para disparar um anúncio para esse usuário no Facebook usando públicos personalizados. Por exemplo, ao configurar uma sincronização de público com o Facebook, é possível usar uma ampla variedade de campos primários, como e-mail, telefone, nome e sobrenome.
Os casos de uso comuns para a sincronização de públicos personalizados incluem:
- Direcionamento de usuários de alto valor com vários canais para impulsionar compras ou engajamento.
- Redirecionamento de usuários que são menos responsivos a outros canais de marketing.
- Criação de públicos de supressão para evitar que os usuários recebam anúncios quando já são consumidores fiéis da sua marca.
- Criação de públicos semelhantes para adquirir novos usuários com mais eficiência.
Esse recurso permite que as marcas controlem quais dados primários específicos são compartilhados com o Facebook. Na Braze, as integrações com as quais você pode e não pode compartilhar seus dados primários recebem a máxima consideração. Para saber mais, consulte nossa política de privacidade.
Considerações sobre sincronização de usuários e limite de taxa
À medida que os usuários atingem a etapa de sincronização de público, a Braze os sincroniza quase em tempo real, respeitando os limites de taxa da API de marketing do Facebook. A Braze agrupa e processa o maior número possível de usuários a cada 5 segundos antes de enviá-los ao Facebook.
O limite de taxa da API de marketing do Facebook não permite mais do que ~190.000 solicitações de API por conta de anúncio em um período de uma hora. Se um cliente atingir esse limite, a Braze tentará novamente a sincronização por até ~13 horas. Se a sincronização ainda não for possível, a Braze listará esses usuários na métrica Usuários com erro.
Pré-requisitos
Você precisará confirmar que os itens a seguir foram criados e concluídos antes de configurar a etapa do Facebook Audience no Canvas.
| Requisito | Origin | Descrição |
|---|---|---|
| Facebook Business Manager | Uma ferramenta centralizada para gerenciar os ativos do Facebook da sua marca (por exemplo, contas de anúncios, páginas e apps). | |
| Conta de anúncio do Facebook | Uma conta de anúncio ativa do Facebook vinculada ao gerente de negócios da sua marca. Certifique-se de que o administrador do Facebook Business Manager tenha concedido permissões de “Manage Campaigns” ou “Manage ad accounts” para as contas de anúncios do Facebook que você planeja usar com a Braze. Além disso, verifique se você aceitou os termos e condições da sua conta de anúncios. |
|
| Termos de públicos personalizados do Facebook | Aceite os Termos de Públicos Personalizados do Facebook para as contas de anúncios do Facebook que você planeja usar com a Braze. |
Integração
Etapa 1: Conecte-se ao Facebook
Você deve ter a permissão “Admin” para conectar o Facebook à sua conta da Braze.
No dashboard da Braze, acesse Integrações de parceiros > Parceiros de tecnologia e selecione Facebook. Em Facebook Audience Export, selecione Connect Facebook.
Uma janela de diálogo do Facebook oAuth é exibida para autorizar a Braze a criar públicos personalizados em suas contas de anúncios do Facebook.
Depois de vincular a Braze à sua conta do Facebook, selecione as contas de anúncios que deseja sincronizar no seu espaço de trabalho da Braze. Quando estiver conectado, você será levado de volta à página do parceiro, onde poderá ver quais contas estão conectadas e desconectar contas existentes.
Sua conexão com o Facebook é aplicada no nível do espaço de trabalho da Braze. Se o administrador do Facebook remover você do seu Facebook Business Manager ou o acesso às contas do Facebook conectadas, a Braze detectará um token inválido. Como resultado, seus Canvas ativos usando componentes do público do Facebook mostrarão erros, e a Braze não poderá sincronizar usuários.
Para clientes que já passaram pelo processo de Revisão de App do Facebook para Ads Management e Ads Management Standard Access, seu Token de Usuário do Sistema ainda será válido para o componente de público do Facebook. Não será possível editar ou revogar o Token de Usuário do Sistema do Facebook por meio da página de parceiro do Facebook. Em vez disso, você pode conectar sua conta do Facebook para substituir seu Token de Usuário do Sistema do Facebook dentro do seu espaço de trabalho da Braze.
A configuração do Facebook oAuth também se aplicará às exportações do Facebook usando Segments.
Etapa 2: Aceitar os termos de serviço de públicos personalizados
Antes de criar seu Canvas, você deve aceitar os seguintes termos de serviço do Facebook nos links a seguir:
- Termos de públicos personalizados de lista de clientes para sua conta pessoal:
https://www.facebook.com/ads/manage/customaudiences/tos.php?act=<ACCOUNT_ID>. - Termos das ferramentas comerciais do Facebook para sua conta comercial:
https://business.facebook.com/customaudiences/value_based/tos.php?act=<ACCOUNT_ID>&business_id=<BUSINESS_ID>.
Consulte a seção de perguntas frequentes para obter mais detalhes sobre a auditoria da sua conta do Facebook durante a integração.
Etapa 3: Adicionar um componente do público do Facebook no Canvas
Adicione um componente no seu Canvas e selecione Facebook Audience.
Etapa 4: Configuração de sincronização
Selecione o botão Custom Audience para abrir o editor de componentes. Em seguida, selecione Facebook como parceiro do Audience Sync.
Selecione a conta de anúncio do Facebook desejada. No menu suspenso Choose a New or Existing Audience, digite o nome de um público novo ou existente.
- Digite um nome para o novo público personalizado.
- Selecione Add Users to Audience e escolha os campos que deseja sincronizar com o Facebook.
- Em seguida, selecione Create Audience para salvar seu público.
Você será notificado na parte superior do editor de etapas se o público for criado com êxito ou se ocorrer um erro durante esse processo. Também é possível fazer referência a esse público para remoção de usuários posteriormente na jornada do Canvas, pois o público foi criado no modo de rascunho.
Ao lançar um Canvas com um novo público, a Braze criará o novo público personalizado ao lançar o Canvas e, posteriormente, sincronizará os usuários quase em tempo real quando eles entrarem na etapa do Audience Sync.
A Braze oferece a capacidade de adicionar ou remover usuários de públicos personalizados existentes do Facebook para confirmar que esses públicos estão atualizados. Para sincronizar com um público existente, faça o seguinte:
- Digite o nome do público existente no menu suspenso.
- Escolha se você deseja Add to the Audience ou Remove from the Audience.
- A Braze adicionará ou removerá usuários quase em tempo real quando eles entrarem na etapa de público do Facebook.
O Facebook proíbe a remoção de usuários de públicos personalizados quando o tamanho do público é muito baixo (normalmente, menos de 1.000 usuários). Como resultado, a Braze não consegue sincronizar usuários para uma remoção da etapa de sincronização de público até que o público atinja o tamanho apropriado.
Etapa 5: Lançar Canvas
Depois de configurar seu componente do público do Facebook, é hora de lançar o Canvas! O novo público personalizado é criado, e os usuários que passam pela etapa do Facebook Audience são transferidos para esse público personalizado no Facebook. Se o seu Canvas contiver etapas subsequentes, seus usuários avançarão para a próxima etapa da jornada do usuário.
A guia History do público personalizado no Facebook Audience Manager refletirá o número de usuários enviados para o público pela Braze. Se um usuário entrar novamente na etapa, ele será enviado ao Facebook novamente.
Compreensão da análise de dados
A tabela a seguir inclui métricas e descrições para ajudá-lo a entender melhor a análise de dados do seu componente Audience Sync.
| Métrica | Descrição |
|---|---|
| Entraram | Número de usuários que entraram neste componente para serem sincronizados com o Facebook. |
| Avançaram para a etapa seguinte | Quantos usuários avançaram para o próximo componente, se houver um. Todos os usuários avançarão automaticamente se essa for a última etapa da ramificação do Canvas. |
| Usuários sincronizados | Número de usuários que foram sincronizados com sucesso com o Facebook. |
| Usuários não sincronizados | Número de usuários que não foram sincronizados devido à falta de campos para correspondência. Os campos são correspondidos usando um operador “OR”, o que significa que, desde que um usuário tenha um dos campos no Facebook, o Facebook corresponderá o usuário mesmo que não haja correspondência em todos os outros campos. |
| Usuários pendentes | Número de usuários atualmente sendo processados pela Braze para sincronizar com o Facebook. |
| Usuários com erro | Número de usuários que não foram sincronizados com o Facebook devido a um erro de API após cerca de 13 horas de tentativas. As possíveis causas de erros podem incluir um token inválido do Facebook ou a exclusão do público personalizado no Facebook. |
| Saíram do Canvas | Número de usuários que saíram do Canvas. Isso ocorre quando a última etapa de um Canvas é uma etapa do Facebook. |
Há um atraso nos relatórios de métricas de usuários sincronizados e usuários com erro devido ao processamento interno.
Perguntas frequentes
Quanto tempo leva para que meus públicos sejam preenchidos no dashboard de parceiro do Audience Sync?
O tempo necessário para preencher um público depende do parceiro específico. Todas as redes processarão as solicitações da Braze e tentarão combinar os usuários. Pode levar até 24 horas para que os públicos personalizados sejam atualizados.
O que devo fazer em seguida se receber um erro de token inválido?
Você pode simplesmente desconectar e reconectar sua conta do Facebook na página de parceiros do Facebook. Confirme com seu administrador do Facebook Business Manager que você tem as permissões apropriadas para a conta de anúncios com a qual deseja sincronizar.
Por que meu Canvas não pode ser iniciado?
- Certifique-se de que o token de usuário do sistema esteja autenticado e tenha acesso às contas de anúncios desejadas no Facebook Business Manager.
- Certifique-se de ter selecionado uma conta de anúncios, inserido um nome para o novo público personalizado e selecionado os campos correspondentes.
- Você pode ter atingido o limite de 500 públicos personalizados no Facebook. Acesse o Facebook Audience Manager para excluir alguns públicos desnecessários antes de criar novos públicos personalizados usando o Canvas.
Como posso saber se os usuários foram correspondidos depois de passá-los para o Facebook?
O Facebook não fornece essas informações por motivos de privacidade.
A Braze oferece suporte a públicos personalizados baseados em valor?
No momento, os públicos personalizados baseados em valor não são suportados pela Braze. Se você estiver interessado em sincronizar esses tipos de públicos personalizados, envie feedback de produto.
A Braze faz hash dos dados antes de enviá-los aos parceiros do Audience Sync?
Depois que os dados de e-mail são normalizados, a Braze faz o hash com SHA256.
IDFA/AAID/telefone: A Braze faz o hash com SHA256. Os tipos de público com os quais sincronizamos são sempre um dos seguintes:
- IDFA_SHA256
- AAID_SHA256
- EMAIL_SHA256
- PHONE_SHA256.
Em termos de frequência, a Braze só fará o hash das informações de identificação pessoal (IPI) do usuário quando os usuários entrarem na etapa de sincronização de público na jornada do usuário em preparação para a sincronização.
Como faço para resolver um problema com a sincronização de um público personalizado semelhante baseado em valor?
No momento, os públicos personalizados semelhantes baseados em valor não são suportados pela Braze. Se você tentar sincronizar com esse público, isso pode causar erros na sua etapa de Audience Sync. Para resolver isso, siga estas etapas:
- Acesse seu dashboard do Facebook Ad Manager e selecione Audiences.
- Selecione Create audience > Custom audience.
- Selecione Customer list.
- Faça upload do seu CSV ou lista sem a coluna Value. Selecione No, continue with a customer list that doesn’t include customer value.
- Conclua a criação do seu público personalizado.
- Na Braze, atualize a etapa Facebook Audience Sync com o público personalizado que você criou.
Recebi um e-mail relacionado aos termos de serviço do público personalizado do Facebook. O que devo fazer para resolver isso?
Para usar o Audience Sync com o Facebook, você deve aceitar estes termos do contrato de serviço.
- Se a sua conta de anúncios estiver diretamente associada à sua conta pessoal do Facebook, você poderá aceitar os termos de serviço da sua conta pessoal aqui:
https://www.facebook.com/ads/manage/customaudiences/tos.php?act=<ACCOUNT_ID>. - Se a sua conta de anúncios estiver vinculada à conta do Business Manager da sua empresa, você deverá aceitar os termos de serviço na sua conta do Facebook Business Manager aqui:
https://business.facebook.com/customaudiences/value_based/tos.php?act=<ACCOUNT_ID>&business_id=<BUSINESS_ID>.
Depois de aceitar os termos de serviço do público personalizado do Facebook, faça o seguinte:
- Atualize seu token de acesso do Facebook com a Braze desconectando e reconectando sua conta do Facebook.
- Reative sua etapa de sincronização do público do Facebook editando e atualizando seu Canvas.
A partir daí, a Braze poderá sincronizar os usuários assim que eles chegarem à etapa de sincronização de público do Facebook.
Solução de problemas
| Erro | Descrição | Etapas para resolver |
|---|---|---|
| Token inválido | As causas típicas incluem o usuário que conectou a integração alterar sua senha, as credenciais expirarem e outros. | Acesse Integrações de parceiros > Facebook e desconecte e reconecte sua conta. Consulte esta seção de solução de problemas para obter etapas adicionais para auditar sua conta do Facebook. |
| Tamanho do público muito baixo | Esse erro pode ocorrer se você tiver criado uma etapa de Audience Sync que remove usuários de seus públicos. Se o tamanho do seu público se aproximar de zero, a rede poderá sinalizar que o tamanho do público é muito pequeno para ser atendido. | Use uma estratégia de sincronização de público que adicione e remova usuários regularmente, de modo a não esgotar totalmente o tamanho do público. |
| O público não existe | A etapa Audience Sync usa um público que não existe ou foi excluído. Isso também pode ser disparado se você não tiver mais a permissão necessária para acessar o público. | Peça a um administrador para verificar na plataforma do parceiro se o público ainda existe. Se existir, confirme se o usuário que conectou a integração tem permissão para o público. Caso contrário, o usuário deve receber acesso a esse público. Se o público tiver sido removido intencionalmente, adicione um público ativo e crie um novo público na etapa. |
| Tentativa de acesso à conta de anúncios | Você não tem permissões para a conta de anúncios ou o público selecionado. | Trabalhe com os administradores da sua conta de anúncios para obter acesso e permissões adequados. |
| Termos de serviço não aceitos | Para alguns destinos do Audience Sync, como o Facebook, a rede de anúncios exige que você aceite termos de serviço específicos para usar o recurso Audience Sync. Esse erro será disparado se você não tiver aceitado os termos apropriados. Como resultado, você também pode ter recebido um e-mail da Braze com o assunto: "Suas credenciais de autorização para o Facebook são inválidas." | Verifique se você aceitou os termos exigidos pelo Facebook. |
| Todos os usuários estão apresentando erros | Se todos os usuários apresentarem erros em uma etapa, apesar de confirmar que esses usuários têm valores para os campos selecionados na etapa, isso pode indicar um problema com a sua conta do Facebook. | Siga as etapas desta seção de solução de problemas para verificar se há algum problema na sua conta. |
| Falha ao criar público | Na página Parceiro de tecnologia do Facebook, você está vendo "Conectado", mas há um erro na etapa Sincronização de público do Facebook ao sincronizar um público: "Falha ao criar o público 'nome do público'". A autorização da sua conta do Facebook falhou. Visite a página Parceiros de tecnologia para reconectar sua conta. | Siga as etapas desta seção de solução de problemas para verificar se há algum problema na sua conta. |
Audite sua conta do Facebook
Se tiver problemas adicionais com a integração, consulte as seções e etapas a seguir para auditar sua conta do Facebook.
Revisar as permissões da conta
- Consulte a documentação do Facebook sobre como gerenciar essas permissões na plataforma. Para o Facebook Business Manager, você precisa, no mínimo, de uma função de Admin ou Employee no Business Manager com acesso às contas de anúncios necessárias.
- Como Employee, confirme se o administrador concede a você permissões completas de Manage Ad Account para cada conta de anúncios para criar um público ou sincronizar usuários com o público.
- Depois que isso for concedido, você deverá desconectar e reconectar sua conta.
Aceitar os termos de serviço
Aceite quaisquer Termos de Serviço (TOS) pendentes do Facebook. O Facebook solicitará periodicamente que você (o usuário) e o gerente de negócios aprovem novamente os termos de serviço.
- O usuário conectado precisa aceitar todos os termos de serviço de cada uma de suas contas de anúncios:
- Termos de serviço do público personalizado para sua conta pessoal do Facebook:
https://business.facebook.com/ads/manage/customaudiences/tos/?act=<AD_ACCOUNT_ID>
- Termos de serviço do público personalizado para sua conta pessoal do Facebook:
Para encontrar sua conta e ID comercial, siga estas etapas:
- Acesse sua conta do Facebook Ads Manager.
- Confirme que está usando a conta de anúncios correta verificando-a no menu suspenso.
- No URL, localize o ID da conta após
act=e o ID da empresa apósbusiness_id=
- Leia e selecione Accept para os Termos do público personalizado. Recomendamos confirmar para qual conta os termos de serviço estão sendo assinados usando o menu suspenso na parte superior dos termos.
- Você deve selecionar Accept para os termos de serviço. Depois, você verá esta mensagem: “You have accepted these terms of service on behalf of Braze”.
- Atualize seu token de acesso do Facebook com a Braze desconectando e reconectando sua conta do Facebook.
- Reative sua etapa de sincronização do público do Facebook editando e atualizando seu Canvas. A partir daí, a Braze poderá sincronizar os usuários assim que eles chegarem à etapa de público do Facebook.
- Se o problema persistir, tente usar um usuário separado com permissões de administrador para aceitar manualmente os termos por meio do Ads Manager.
Concluir todas as tarefas pendentes
Verifique se você tem alguma tarefa pendente com o Facebook que possa estar bloqueando o uso dos serviços do Facebook Ads:
- Faça login no Facebook Ads Manager.
- Selecione a conta de anúncios com a qual você está tendo problemas.
- Na navegação, selecione Account Overview.
- Verifique se há algum alerta que precise ser resolvido.
- Verifique se há alguma tarefa de configuração que precise ser concluída.
Conecte-se com um usuário diferente
Como outra etapa de solução de problemas, recomendamos que um usuário administrador diferente tente conectar sua conta fazendo o seguinte:
- Desconecte a integração atual.
- Um usuário separado com permissões de administrador conecta sua conta de usuário do Facebook.