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.
Sincronização de usuários e considerações sobre limite de frequência
À medida que os usuários chegam à etapa de Audience Sync, a Braze os sincroniza em tempo quase real, respeitando os limites de frequência 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 frequência da API de Marketing do Facebook permite no máximo ~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 Users Errored.
Pré-requisitos
Você precisará confirmar que os itens a seguir foram criados e concluídos antes de configurar sua etapa de público do Facebook 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úncios do Facebook | Uma conta de anúncios do Facebook ativa vinculada ao gerenciador de negócios da sua marca. Certifique-se de que o administrador do seu Facebook Business Manager concedeu a você as permissões “Manage Campaigns” ou “Manage ad accounts” para as contas de anúncios do Facebook que você planeja usar com a Braze. Além disso, certifique-se de que 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: Conectar ao Facebook
No dashboard da Braze, acesse Integrações com Parceiros > Parceiros de Tecnologia e selecione Facebook. Em Facebook Audience Export, selecione Connect Facebook.
Uma janela de diálogo oAuth do Facebook aparecerá para autorizar a Braze a criar públicos personalizados nas suas contas de anúncios do Facebook.
Após vincular a Braze à sua conta do Facebook, selecione as contas de anúncios que você deseja sincronizar dentro do seu espaço de trabalho da Braze. Quando estiver conectado, você será redirecionado para a página de parceiro, onde poderá visualizar 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 Facebook Business Manager ou do acesso às contas do Facebook conectadas, a Braze detectará um token inválido. Como resultado, seus Canvas ativos que usam componentes de público do Facebook mostrarão erros, e a Braze não conseguirá sincronizar usuários.
Para clientes que já passaram pelo processo de revisão de aplicativo 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. Você não poderá editar ou revogar o token de usuário do sistema do Facebook pela página de parceiro do Facebook. Em vez disso, você pode conectar sua conta do Facebook para substituir o token de usuário do sistema do Facebook dentro do seu espaço de trabalho da Braze.
A configuração oAuth do Facebook 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 de ferramentas de negócios do Facebook para sua conta empresarial:
https://business.facebook.com/customaudiences/value_based/tos.php?act=<ACCOUNT_ID>&business_id=<BUSINESS_ID>.
Consulte a seção de perguntas frequentes para mais detalhes sobre como auditar sua conta do Facebook durante a integração.
Etapa 3: Adicionar um componente de público do Facebook no Canvas
Adicione um componente no seu Canvas e selecione Facebook Audience.
Etapa 4: Configuração da sincronização
Selecione o botão Custom Audience para abrir o editor do componente. Em seguida, selecione Facebook como parceiro de sincronização de público.
Selecione a conta de anúncios do Facebook desejada. No menu suspenso Choose a New or Existing Audience, digite o nome de um público novo ou existente.
- Insira um nome para o novo público personalizado.
- Selecione Add Users to Audience e escolha os campos que você deseja sincronizar com o Facebook.
- Em seguida, selecione Create Audience para salvar seu público.
Você será notificado no topo do editor da etapa se o público for criado com sucesso ou se ocorrer um erro durante esse processo. Você também pode referenciar esse público para remoção de usuários posteriormente na jornada do Canvas, pois o público foi criado em modo de rascunho.
Quando você lança um Canvas com um novo público, a Braze cria o novo público personalizado ao lançar o Canvas e, em seguida, sincroniza os usuários em tempo quase real à medida que eles entram na etapa de sincronização de público.
Cada etapa de sincronização de público é mapeada para o público do Facebook configurado naquela etapa. Quando o Canvas é executado novamente (por exemplo, em um cronograma recorrente), a Braze sincroniza os usuários elegíveis para o mesmo público — ela não cria um novo público do Facebook para cada execução do Canvas.
A Braze oferece a capacidade de adicionar ou remover usuários de públicos personalizados existentes do Facebook para garantir que esses públicos estejam atualizados. Para sincronizar com um público existente, faça o seguinte:
- Digite o nome do público existente no menu suspenso.
- Escolha se deseja Add to the Audience ou Remove from the Audience.
- A Braze adicionará ou removerá usuários em tempo quase real à medida que 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 pequeno (geralmente menos de 1.000 usuários). Como resultado, a Braze não consegue sincronizar usuários para remoção da etapa de sincronização de público até que o público atinja o tamanho adequado.
Etapa 5: Lançar o Canvas
Após configurar seu componente de público do Facebook, é hora de lançar o Canvas! O novo público personalizado é criado, e os usuários que passarem pela etapa de público do Facebook serão adicionados a esse público personalizado no Facebook. Se o seu Canvas contiver etapas subsequentes, seus usuários avançarão para a próxima etapa na 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.
Entendendo a análise de dados
A tabela a seguir inclui métricas e descrições para ajudar você a entender melhor a análise de dados do seu componente de Audience Sync.
| Métrica | Descrição |
|---|---|
| Entered | Número de usuários que entraram neste componente para serem sincronizados com o Facebook. |
| Proceeded to Next Step | Quantos usuários avançaram para o próximo componente, se houver um. Todos os usuários avançarão automaticamente se esta for a última etapa na ramificação do Canvas. |
| Users Synced | Número de usuários que foram sincronizados com sucesso com o Facebook. |
| Users Not Synced | 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 fará a correspondência do usuário mesmo que não haja correspondência em todos os outros campos. |
| Users Pending | Número de usuários que estão sendo processados pela Braze para sincronização com o Facebook. |
| Users Errored | 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. Possíveis causas de erros podem incluir um token inválido do Facebook ou se o público personalizado foi excluído no Facebook. |
| Exited Canvas | Número de usuários que saíram do Canvas. Isso ocorre quando a última etapa em um Canvas é uma etapa do Facebook. |
Há um atraso no relatório das métricas de usuários sincronizados e usuários com erro devido ao processamento interno.
Perguntas frequentes
Quanto tempo leva para meus públicos serem preenchidos no dashboard do parceiro de 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 fazer a correspondência dos usuários. Pode levar até 24 horas para que os públicos personalizados sejam atualizados.
O que devo fazer se receber um erro de token inválido?
Você pode simplesmente desconectar e reconectar sua conta do Facebook na página de parceiro do Facebook. Confirme com o administrador do seu 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 lançado?
- Verifique se o token do usuário do sistema está autenticado e tem acesso às contas de anúncios desejadas no Facebook Business Manager.
- Verifique se você selecionou uma conta de anúncios, inseriu um nome para o novo público personalizado e selecionou campos para correspondência.
- Você pode ter atingido o limite de 500 públicos personalizados no Facebook. Acesse o Facebook Audience Manager para excluir alguns desnecessários antes de criar novos públicos personalizados usando o Canvas.
Como sei se houve correspondência de usuários após enviá-los ao Facebook?
O Facebook não fornece essa informação por motivos de privacidade.
A Braze oferece suporte a públicos personalizados baseados em valor?
No momento, públicos personalizados baseados em valor não são compatíveis com a Braze. Se você tem interesse em value-based custom audience sync, envie feedback de produto.
A Braze faz hash dos dados antes de enviá-los aos parceiros de Audience Sync?
Depois que os dados de e-mail são normalizados, a Braze aplica hash com SHA256.
IDFA/AAID/telefone: a Braze aplica hash com SHA256. Os tipos de público que sincronizamos são sempre um dos seguintes:
- IDFA_SHA256
- AAID_SHA256
- EMAIL_SHA256
- PHONE_SHA256.
Em termos de frequência, a Braze só aplica hash nas informações de identificação pessoal (IPI) dos usuários quando eles entram na etapa de Audience Sync na jornada do usuário, em preparação para a sincronização.
Como resolvo um problema de sincronização de um público personalizado semelhante baseado em valor?
No momento, públicos personalizados semelhantes baseados em valor não são compatíveis com a 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 o dashboard do Facebook Ad Manager e selecione Públicos.
- Selecione Criar público > Público personalizado.
- Selecione Lista de clientes.
- Faça upload do seu CSV ou lista sem a coluna Valor. Selecione Não, continuar com uma lista de clientes que não inclui valor do cliente.
- Conclua a criação do seu público personalizado.
- Na Braze, atualize a etapa de Facebook Audience Sync com o público personalizado que você criou.
Recebi um e-mail relacionado aos termos de serviço de público personalizado do Facebook. O que devo fazer para resolver isso?
Para usar o Audience Sync com o Facebook, você deve aceitar esses termos de serviço.
- Se sua conta de anúncios estiver diretamente associada à sua conta pessoal do Facebook, você pode aceitar os termos de serviço na sua conta pessoal aqui:
https://www.facebook.com/ads/manage/customaudiences/tos.php?act=<ACCOUNT_ID>. - Se sua conta de anúncios estiver vinculada à conta do Business Manager da sua empresa, você deve 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 de público personalizado do Facebook, faça o seguinte:
- Atualize seu token de acesso do Facebook na Braze desconectando e reconectando sua conta do Facebook.
- Reative sua etapa de Facebook Audience Sync editando e atualizando seu Canvas.
Em seguida, a Braze poderá sincronizar os usuários assim que eles atingirem a etapa de Facebook Audience Sync.
O que aconteceu com os filtros Connected Facebook e Number of Facebook Friends Using App?
Os filtros de segmentação da Braze Number of Facebook Friends Using App e Connected Facebook foram descontinuados. O Facebook e os SDKs da Braze não coletam mais os dados subjacentes nos quais esses filtros se baseavam.
Substitua os filtros descontinuados por atributos personalizados, eventos personalizados ou Segments baseados em engajamento — por exemplo, login do Facebook ou vinculação social em vez de Connected Facebook, ou indicações, convites e compartilhamentos em vez de Number of Facebook Friends Using App.
Para redirecionamento com Canvas, faça a correspondência de usuários com e-mail, telefone, nome e sobrenome, conforme demonstrado na Etapa 4: Configuração da sincronização. Para ampliar o alcance, sincronize um Segment de alto valor com o Facebook e crie um público semelhante no Meta Ads Manager.
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 ter alterado a senha, as credenciais terem expirado, entre outras. | Acesse Partner Integrations > Facebook e desconecte e reconecte sua conta. Consulte esta seção de solução de problemas para etapas adicionais de auditoria da sua conta do Facebook. |
| Tamanho do público muito baixo | Esse erro pode ocorrer se você criou uma etapa de Audience Sync que remove usuários dos seus públicos. Se o tamanho do público se aproximar de zero, a rede pode sinalizar que o público é muito pequeno para ser veiculado. | Use uma estratégia de Audience Sync que adicione e remova usuários regularmente, de modo que o tamanho do público não seja totalmente esgotado. |
| Público não existe | A etapa de Audience Sync usa um público que não existe ou foi excluído. Isso também pode ser acionado se você não tiver mais a permissão necessária para acessar o público. | Peça a um administrador que verifique 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 acessar o público. Se não tiver, o usuário deve receber acesso a esse público. Se o público foi 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 que selecionou. | Trabalhe com os administradores da sua conta de anúncios para obter o acesso e as permissões adequados. |
| Termos de serviço não aceitos | Para alguns destinos de Audience Sync, como o Facebook, a rede de anúncios exige a aceitação de termos de serviço específicos para usar o recurso de Audience Sync. Esse erro será acionado se você não tiver aceito os termos apropriados. Como resultado, você também pode ter recebido um e-mail da Braze com o assunto: "Your authorization credentials for Facebook are invalid." | Verifique se você aceitou os termos exigidos do Facebook. |
| Todos os usuários estão apresentando erro | Se todos os usuários estão apresentando erro em uma etapa, apesar de confirmar que esses usuários possuem valores para os campos selecionados na etapa, isso pode indicar um problema com sua conta do Facebook. | Siga as etapas em esta seção de solução de problemas para verificar se há problemas na sua conta. |
| Falha ao criar público | Na página da parceira de tecnologia do Facebook, você vê "Connected", mas há um erro na etapa de Facebook Audience Sync ao sincronizar um público: "Failed to create audience 'audience name'". A autorização da sua conta do Facebook falhou. Acesse a página de parceiros de tecnologia para reconectar sua conta. | Siga as etapas em esta seção de solução de problemas para verificar se há problemas na sua conta. |
| Conta de anúncios ausente no menu suspenso | Ao configurar a etapa de Facebook Audience, uma conta de anúncios esperada não está listada no seletor de contas de anúncios. | Confirme se seu app do Facebook concluiu a Revisão do App para ads_management com o nível de acesso que o Facebook exige para uso da Marketing API. No Facebook Business Manager, confirme se o token do usuário do sistema tem as permissões corretas, está associado às contas de anúncios que você usa na Braze e se os termos da conta de anúncios foram aceitos. Se o menu suspenso funciona em um novo Canvas, mas não em um Canvas que você já editou, tente atualizar a página do navegador (ou limpar o cache) e confirme se você está conectado como um usuário que ainda tem acesso a essas contas de anúncios. |
| Erro ao validar token de acesso | Você vê um erro sobre a validação do token de acesso do Facebook ao conectar a Braze ao Facebook ou ao sincronizar públicos. | Saia do Facebook no seu navegador. Na Braze, acesse Partner Integrations > Facebook, remova as credenciais salvas do Facebook e conecte o Facebook novamente. Na página de parceiros de tecnologia do Facebook para a Braze, desconecte e reconecte a integração, se a opção estiver disponível. Se os problemas continuarem, siga Auditar sua conta do Facebook. |
| Erros de permissão de exportação ou sincronização de público | A exportação ou sincronização de um público do Facebook falha com erros de autorização, administrador ou conta de anúncios. | No Meta for Developers, abra seu app e confirme se seu usuário tem a função de Admin em App roles. Em App settings > Advanced, confirme se Advertising accounts inclui as contas que você usa com a Braze. Em Business settings, confirme se o usuário que está conectando ou o usuário do sistema tem acesso à conta de anúncios correta. |
Auditar sua conta do Facebook
Se você tiver problemas adicionais com sua integração, consulte as seções e etapas a seguir para auditar sua conta do Facebook.
Revisar 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 de pelo menos uma função de Admin ou Employee no Business Manager com acesso às contas de anúncios necessárias.
- Como Employee, confirme se o Admin concede a você permissões completas de Manage Ad Account para cada conta de anúncios, a fim de criar um público ou sincronizar usuários com o público.
- Depois que isso for concedido, você deve desconectar e reconectar sua conta.
Aceitar os termos de serviço
Aceite quaisquer Termos de Serviço (TOS) pendentes do Facebook. O Facebook periodicamente exigirá que você (o usuário) e o gerente de negócios reaprovem seus termos de serviço.
- O usuário conectado precisa aceitar todos os termos de serviço para cada uma de suas contas de anúncios:
- TOS de público personalizado para sua conta pessoal do Facebook:
https://business.facebook.com/ads/manage/customaudiences/tos/?act=<AD_ACCOUNT_ID>
- TOS de público personalizado para sua conta pessoal do Facebook:
Para encontrar o ID da sua conta e o ID do negócio, siga estas etapas:
- Acesse sua conta do Facebook Ads Manager.
- Confirme se você está usando a conta de anúncios correta verificando no menu suspenso.
- Na URL, encontre o ID da conta após
act=e o ID do negócio apósbusiness_id=
- Leia e selecione Accept para os Termos de Público Personalizado. Recomendamos confirmar para qual conta os termos de serviço estão sendo assinados usando o menu suspenso no topo 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 na Braze desconectando e reconectando sua conta do Facebook.
- Reative sua etapa de Facebook Audience Sync editando e atualizando seu Canvas. A Braze poderá então sincronizar usuários assim que eles alcançarem a 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 pelo Ads Manager.
Concluir tarefas pendentes
Verifique se você tem tarefas pendentes com o Facebook que possam estar impedindo 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á alertas que precisam ser resolvidos.
- Verifique se há tarefas de configuração que precisam ser concluídas.
Conectar 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.