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 do Braze aos públicos personalizados do Facebook para fornecer 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 de 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 do 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.
• Criando 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 frequência

À medida que os usuários atingem a etapa de sincronização do público do Facebook, o Braze os sincroniza quase em tempo real, respeitando os limites de frequência da API de marketing do Facebook. O 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 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, o Braze tentará novamente a sincronização por até 13 horas. Se a sincronização ainda não for possível, o 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 Canva.

Requisito	Origin	Descrição
Facebook Business Manager	Facebook	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	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 “Gerenciar campanhas” ou “Gerenciar contas de anúncios” para as contas de anúncios do Facebook que você planeja usar com o Braze. Além disso, verifique se você aceitou os termos e condições de sua conta de anúncios.
Termos de públicos personalizados do Facebook	Facebook	Aceite os Termos de Públicos Personalizados do Facebook para suas contas de anúncios do Facebook que você planeja usar com o Braze.

Integração

Etapa 1: conecte-se ao Facebook

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 o Braze a criar públicos personalizados em suas contas de anúncios do Facebook.

Depois de vincular o Braze à sua conta do Facebook, selecione as contas de anúncios que deseja sincronizar em seu espaço de trabalho do 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 do 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 o Braze não poderá sincronizar usuários.

Etapa 2: Aceitar os termos de serviço de públicos personalizados

Antes de criar seu Canva, você deve aceitar os seguintes termos de serviço do Facebook nos links a seguir:

• Lista de clientes Termos de públicos personalizados 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 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 Canva

Adicione um componente na sua canva e selecione público do Facebook.

Etapa 4: Configuração de sincronização

Selecione o botão Público personalizado 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 (Escolher um público novo ou existente ), digite o nome de um público novo ou existente.

• create a new audience
• sync with an existing audience

Etapa 5: Lançar canva

Depois de configurar seu componente do público do Facebook, é hora de lançar o Canva! 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 Canva contiver etapas subsequentes, seus usuários avançarão para a próxima etapa da jornada do usuário.

A guia Histórico do público personalizado no Gerenciador de Público do Facebook refletirá o número de usuários enviados para o público do 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 de seu componente Audience Sync.

Métrico	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 Canva.
Usuários sincronizados	Número de usuários que foram sincronizados com sucesso ao 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 do Facebook.
Saíram do canva	Número de usuários que saíram da canva. Isso ocorre quando a última etapa de um canva é uma etapa do Facebook.

Perguntas frequentes

Quanto tempo leva para que meus públicos sejam preenchidos no meu 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 do 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 Canva 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 Canva.

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.

O 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 comentários sobre o produto.

O Braze faz hash dos dados antes de enviá-los aos parceiros do Audience Sync?

Depois que os dados de e-mail são normalizados, o Braze faz o hash com SHA256.

IDFA/AAID/telefone: Braze hashes 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, o 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 do 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 este público, isso pode causar erros para sua etapa de Sincronização de Público. Para resolver isso, siga estas etapas:

1. Acessar seu dashboard do Facebook Ad Manager e selecionar Audiences.
2. Selecione Criar público > Público personalizado.
3. Selecione Lista de clientes.
4. 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 (Não, continue com uma lista de clientes que não inclui o valor do cliente).
5. Conclua a criação do seu público personalizado.
6. 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 público do 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:

1. Atualize seu token de acesso do Facebook com a Braze desconectando e reconectando sua conta do Facebook.
2. Re-ativar sua etapa de sincronização do público do Facebook editando e atualizando seu canva.

Em seguida, o Braze poderá sincronizar os usuários assim que eles chegarem à etapa de sincronização do público do Facebook.

Solução de problemas

Erro	Descrição	Etapas para resolver
Token inválido	As causas típicas são se o usuário que conectou a integração alterar sua senha, se as credenciais expirarem e muito mais.	Acesse Partner Integrations > 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 de 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.	Faça uma verificação administrativa na plataforma do parceiro para ver 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 de 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ços 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 esse 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 confirmarem 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 de 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

1. Consulte a documentação do Facebook sobre como gerenciar essas permissões em sua plataforma. Para o Facebook Business Manager, você precisa, no mínimo, de uma função de administrador ou de colaborador Business Manager com acesso às contas de anúncios necessárias.
2. Como funcionário, confirme se o administrador concede a você permissões completas de Gerenciar conta de anúncios para cada conta de anúncios para criar um público ou sincronizar usuários com o público.
3. Depois que isso for concedido, você deverá desconectar e reconectar sua conta.

Aceitar os termos de serviço

Aceitar 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.

1. 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>

Para encontrar sua conta e ID comercial, siga estas etapas:

1. Acesse sua conta do Facebook Ads Manager.
2. Confirme que está usando a conta de anúncios correta, verificando-a no menu suspenso.
3. No URL, localize o ID da conta após act= e o ID da empresa após business_id=

4. Leia e selecione Aceitar para os Termos do público personalizado. Recomendamos confirmar para qual conta os termos de serviço estão sendo feitos login usando o menu suspenso na parte superior dos termos.

5. Você deve selecionar Aceitar para os termos de serviço. Depois, você verá esta mensagem: “Você aceitou estes termos de serviço em nome da Braze”. 6. Atualize seu token de acesso do Facebook com a Braze desconectando e reconectando sua conta do Facebook. 7. Re-ativar sua etapa de sincronização do público do Facebook editando e atualizando seu canva. A partir daí, a Braze conseguirá sincronizar os usuários assim que eles chegarem à etapa de público do Facebook. 8. Se o problema persistir, tente usar um usuário separado com permissões de administrador para aceitar manualmente os termos por meio do Gerenciador de Anúncios.

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:

1. Registre-se no Gerenciador de anúncios do Facebook.
2. Selecione a conta de anúncios com a qual você está tendo problemas.
3. Na navegação, selecione a Visão geral da conta.
   
4. Verifique se há algum alerta que precise ser resolvido.
   

5. 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:

1. Desconecte a integração atual.
2. Um usuário separado com permissões de administrador conecta sua conta de usuário do Facebook.