Sincronização de público com o Facebook
Com o Braze Audience Sync para o Facebook, você pode adicionar os dados dos seus próprios usuários da sua integração com a Braze aos públicos personalizados do Facebook. Assim, você veicula 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 dos seus usuários 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, você pode 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:
- Direcionar usuários de alto valor em vários canais para impulsionar compras ou engajamento.
- Redirecionar usuários que respondem menos a outros canais de marketing.
- Criar públicos de supressão para evitar que usuários recebam anúncios quando já são consumidores fiéis da sua marca.
- Criar 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 Facebook. Na Braze, avaliamos com o máximo cuidado as integrações com as quais você pode ou não compartilhar seus dados primários. 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 chegam à etapa Audience Sync, a Braze os coloca em uma fila para envio em lotes antes de enviá-los ao Facebook. Consulte Envio em lotes e latência para saber como a Braze despacha os lotes.
A Braze envia até 2.000 usuários por solicitação 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úncios em um período de uma hora. Se um cliente atingir esse limite, a Braze tenta sincronizar novamente por até ~13 horas. Se ainda assim a sincronização não for possível, a Braze lista esses usuários na métrica Usuários com erro.
Pré-requisitos
Antes de configurar sua etapa de público do Facebook no Canvas, confirme que você criou e concluiu os itens a seguir.
| Requisito | Origin | Descrição |
|---|---|---|
| Gerenciador de Negócios do 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úncios do Facebook | Uma conta de anúncios ativa do Facebook vinculada ao gerenciador de negócios da sua marca. Confirme que o administrador do seu Gerenciador de Negócios do Facebook concedeu a você a permissão “Gerenciar campanhas” ou “Gerenciar contas de anúncios” para as contas de anúncios do Facebook que você pretende usar com a Braze. Confirme também 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ê pretende usar com a Braze. |
Integração
Etapa 1: Conectar ao Facebook
No dashboard da Braze, acesse Integrações de parceiros > Parceiros de tecnologia e selecione Facebook. Em Exportação de público do Facebook, selecione Conectar Facebook.
Uma janela de diálogo OAuth do Facebook aparece para autorizar a Braze a criar públicos personalizados nas 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. Após a conexão, você volta para a página do parceiro, onde pode 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 Facebook Business Manager ou do acesso às contas do Facebook conectadas, a Braze vai detectar um token inválido. Como resultado, seus Canvas ativos que usam componentes de público do Facebook vão mostrar erros, e a Braze não conseguirá 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, o token de usuário do sistema continuará 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 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 no seu espaço de trabalho da Braze.
A configuração OAuth do Facebook também se aplica às exportações para o Facebook usando Segments.
Etapa 2: Aceitar os termos de serviço de públicos personalizados
Antes de montar seu Canvas, você precisa aceitar os seguintes termos de serviço do Facebook nos links abaixo:
- 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 de negócios 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 saber mais 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 ao seu Canvas e selecione Público do Facebook.
Etapa 4: Configurar a sincronização
Selecione o botão Público personalizado 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 Escolha um público novo ou existente, digite o nome de um público novo ou existente.
- Insira um nome para o novo público personalizado.
- Selecione Adicionar usuários ao público e escolha os campos que deseja sincronizar com o Facebook.
- Depois, selecione Criar público para salvar seu público.
Você recebe uma notificação na parte superior do editor da etapa informando se o público foi criado com sucesso ou se ocorreu algum erro nesse processo. Você também pode referenciar esse público para remover usuários mais adiante na jornada do Canvas, pois o público foi criado no modo de rascunho.
Quando você lança um Canvas com um novo público, a Braze cria o novo público personalizado no lançamento do Canvas e, depois disso, sincroniza os usuários quase em tempo real à medida que eles entram na etapa de sincronização de público.
Cada etapa de sincronização de público corresponde ao público do Facebook configurado nessa etapa. Quando o Canvas é executado novamente (por exemplo, em um cronograma recorrente), a Braze sincroniza os usuários elegíveis com esse mesmo público. Ela não cria um novo público do Facebook a cada execução do Canvas.
A Braze permite adicionar ou remover usuários de públicos personalizados existentes do Facebook para manter esses públicos 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 Adicionar ao público ou Remover do público.
- A Braze vai adicionar ou remover usuários quase em tempo real à medida que eles entram 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 (normalmente menos de 1.000 usuários). Por isso, a Braze não consegue sincronizar usuários para remoção na etapa de sincronização de público até que o público atinja o tamanho adequado.
Etapa 5: Lançar o Canvas
Depois de 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 passam pela etapa de público do Facebook são enviados para esse público personalizado no Facebook. Se o seu Canvas tiver etapas seguintes, os usuários avançam para a próxima etapa da jornada.
A guia Histórico do público personalizado no Gerenciador de Públicos do Facebook mostra o número de usuários enviados da Braze para o público. Se um usuário entrar novamente na etapa, ele será enviado ao Facebook outra vez.
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 sincronização de público.
| Métrica | Descrição |
|---|---|
| Entrou | Número de usuários que entraram neste componente para serem sincronizados com o Facebook. |
| Prosseguiu para a próxima etapa | Quantos usuários avançaram para o próximo componente, se houver. Se esta for a última etapa na ramificação do Canvas, todos os usuários avançarão automaticamente. |
| 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 por falta de campos para correspondência. Os campos são correspondidos usando um operador “OR”. Ou seja, se um usuário tiver pelo menos um dos campos no Facebook, o Facebook fará a correspondência desse usuário, mesmo que os outros campos não correspondam. |
| Usuários pendentes | Número de usuários que estão sendo processados pela Braze no momento para sincronização 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 novas tentativas. Entre as possíveis causas de erros estão um token do Facebook inválido ou a exclusão do público personalizado no Facebook. |
| Saiu do Canvas | Número de usuários que saíram do Canvas. Isso acontece quando a última etapa de um Canvas é uma etapa do Facebook. |
Há um atraso nos relatórios 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 aparecerem no dashboard do meu parceiro de Audience Sync?
O tempo para preencher um público depende do parceiro específico. Todas as redes processam as solicitações da Braze e tentam 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?
Basta 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 adequadas para a conta de anúncios que deseja sincronizar.
Por que meu Canvas não pode ser lançado?
- Confira se o token de usuário do sistema está autenticado e tem acesso às contas de anúncios desejadas no Facebook Business Manager.
- Confira se você selecionou uma conta de anúncios, inseriu um nome para o novo público personalizado e selecionou os campos para correspondência.
- Talvez você tenha atingido o limite de 500 públicos personalizados no Facebook. Acesse o Facebook Audience Manager e exclua alguns públicos desnecessários antes de criar novos públicos personalizados usando o Canvas.
Como sei se houve correspondência dos usuários depois de 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, a Braze não oferece suporte a públicos personalizados baseados em valor. 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 faz o hash deles com SHA256.
IDFA/AAID/telefone: A Braze faz o hash com SHA256. Os tipos de público que sincronizamos são sempre um dos seguintes:
- IDFA_SHA256
- AAID_SHA256
- EMAIL_SHA256
- PHONE_SHA256.
Quanto à frequência, a Braze só faz o hash das informações de identificação pessoal (IPI) dos usuários quando eles entram na etapa de Audience Sync na jornada do usuário, como preparação para a sincronização.
Como resolvo um problema de sincronização de um público semelhante (lookalike) personalizado baseado em valor?
No momento, a Braze não oferece suporte a públicos semelhantes (lookalike) personalizados baseados em valor. Se você tentar sincronizar com esse público, isso pode causar erros na sua etapa de Audience Sync. Para resolver, siga estas etapas:
- Acesse o dashboard do seu 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 o valor do cliente.
- Conclua a criação do seu público personalizado.
- Na Braze, atualize a etapa de Audience Sync do Facebook com o público personalizado que você criou.
Recebi um e-mail sobre os termos de serviço de públicos personalizados do Facebook. O que devo fazer para resolver isso?
Para usar o Audience Sync com o Facebook, você precisa 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ê precisa 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úblicos personalizados 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 Audience Sync do Facebook editando e atualizando seu Canvas.
Assim, a Braze poderá sincronizar os usuários assim que eles chegarem à etapa de Audience Sync do Facebook.
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 em que esses filtros se baseavam.
Substitua os filtros descontinuados por atributos personalizados, eventos personalizados ou segmentos baseados em engajamento. Por exemplo, use login com Facebook ou vinculação social no lugar de Connected Facebook, ou indicações, convites e compartilhamentos no lugar de Number of Facebook Friends Using App.
Para redirecionamento com o Canvas, faça a correspondência dos usuários por e-mail, telefone, nome e sobrenome, conforme mostrado em Etapa 4: Configuração da sincronização. Para ampliar o alcance, sincronize um segmento de alto valor com o Facebook e crie um público semelhante (lookalike) no Meta Ads Manager.
Solução de problemas
| Erro | Descrição | Etapas para resolver |
|---|---|---|
| Token inválido | Esse erro costuma acontecer quando o usuário que conectou a integração altera a senha, quando as credenciais expiram, entre outros motivos. | Acesse Integrações de parceiros > Facebook, desconecte e reconecte sua conta. Consulte esta seção de solução de problemas para ver outras etapas de auditoria da sua conta do Facebook. |
| Tamanho do público muito baixo | Esse erro pode ocorrer se você criou uma etapa do 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 é pequeno demais para veicular anúncios. | Use uma estratégia de Audience Sync que adicione e remova usuários regularmente, sem esgotar totalmente o tamanho do público. |
| O público não existe | A etapa do Audience Sync usa um público que não existe ou foi excluído. Esse erro 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 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. Caso não tenha, é preciso conceder a esse usuário acesso ao público. Se o público foi removido de propósito, 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 para o público que selecionou. | Fale 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 | Em 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 é disparado se você não aceitou os termos adequados. Por isso, você também pode ter recebido um e-mail da Braze com este assunto: “Your authorization credentials for Facebook are invalid.” | Confira se você aceitou os termos exigidos pelo Facebook. |
| Todos os usuários apresentam erro | Se todos os usuários apresentarem erro em uma etapa, mesmo depois de você confirmar que eles têm valores para os campos selecionados nessa etapa, isso pode indicar um problema com 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 o público | Na página de parceira de tecnologia do Facebook, aparece “Conectado”, mas a etapa do Facebook Audience Sync mostra um erro 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 desta seção de solução de problemas para verificar se há algum problema na sua conta. |
| Conta de anúncios ausente no menu suspenso | Ao configurar a etapa de público do Facebook, uma conta de anúncios esperada não aparece no seletor de contas de anúncios. | Confirme se o seu app do Facebook concluiu a Análise do app para ads_management com o nível de acesso que o Facebook exige para usar a API de Marketing. No Facebook Business Manager, confirme se o token do usuário do sistema tem as permissões corretas e 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 funcionar em um novo Canvas, mas não em um Canvas que você já editou, tente atualizar o navegador forçando o recarregamento (ou limpe o cache) e confirme se você está conectado com um usuário que ainda tem acesso a essas contas de anúncios. |
| Erro ao validar o token de acesso | Aparece 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 Integrações de parceiros > Facebook, remova as credenciais salvas do Facebook e conecte o Facebook novamente. Na página de parceiros de tecnologia do Facebook referente à Braze, desconecte e reconecte a integração, se essa opção estiver disponível. Se os problemas continuarem, siga as instruções em Auditar sua conta do Facebook. |
| Erros de permissão na exportação ou sincronização do público | A exportação ou sincronização de um público do Facebook falha com erros de autorização, de administrador ou da conta de anúncios. | No Meta for Developers, abra seu app e confirme se o seu usuário tem a função de Administrador em Funções do app. Em Configurações do app > Avançado, confirme se Contas de anúncios inclui as contas que você usa com a Braze. Nas Configurações do negócio, confirme se o usuário que fez a conexão ou o usuário do sistema tem acesso à conta de anúncios correta. |
Auditar sua conta do Facebook
Se tiver outros problemas com sua integração, consulte as seções e etapas a seguir para auditar sua conta do Facebook.
Revisar as permissões da conta
- Leia a documentação do Facebook sobre como gerenciar essas permissões na plataforma deles. No Facebook Business Manager, você precisa ter pelo menos a função de Administrador ou Colaborador do Business Manager, com acesso às contas de anúncios necessárias.
- Se você for Colaborador, confirme se o administrador concedeu a você permissões completas de Gerenciar conta de anúncios para cada conta de anúncios, para que você possa criar um público ou sincronizar usuários com ele.
- Depois que essas permissões forem concedidas, desconecte e reconecte sua conta.
Aceitar os termos de serviço
Aceite todos os termos de serviço (TOS) pendentes do Facebook. Periodicamente, o Facebook exige que você (o usuário) e o gerente do negócio aprovem novamente os termos de serviço.
- O usuário conectado precisa aceitar todos os termos de serviço de cada uma das 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 do seu negócio, siga estas etapas:
- Acesse sua conta do Facebook Ads Manager.
- Confirme no menu suspenso que você está usando a conta de anúncios certa.
- Na URL, encontre o ID da conta depois de
act=e o ID do negócio depois debusiness_id=
- Leia os termos de público personalizado e selecione Aceitar. Recomendamos confirmar para qual conta os termos de serviço estão sendo assinados usando o menu suspenso no topo dos termos.
- Selecione Aceitar nos termos de serviço. Em seguida, você verá esta mensagem: “Você aceitou estes termos de serviço em nome da Braze”.
- Atualize seu token de acesso do Facebook na Braze desconectando e reconectando sua conta do Facebook.
- Reative sua etapa do Facebook Audience Sync editando e atualizando seu Canvas. Assim, a Braze poderá sincronizar os usuários assim que eles chegarem à etapa de público do Facebook.
- Se o problema persistir, tente usar outro usuário com permissões de administrador para aceitar os termos manualmente pelo Ads Manager.
Concluir tarefas pendentes
Verifique se há alguma tarefa pendente no Facebook que possa estar impedindo você de usar os serviços do Facebook Ads:
- Faça login no Facebook Ads Manager.
- Selecione a conta de anúncios com problemas.
- Na navegação, selecione Visão geral da conta.
- Verifique se há algum alerta que precise ser resolvido.
- Verifique se há alguma tarefa de configuração que precise ser concluída.
Conectar com outro usuário
Como outra etapa de solução de problemas, recomendamos que outro usuário administrador tente conectar a conta dele. Para isso:
- Desconecte a integração atual.
- Outro usuário com permissões de administrador conecta a conta de usuário dele no Facebook.