Sincronizar os membros de um público

Use seu data warehouse, CRM ou aplicativo para decidir quem faz parte de uma coorte e aplique essa seleção a um público da Bird. A API publicada de públicos armazena participação estática. Esse padrão de integração mantém a participação alinhada com a origem que avalia suas condições, sem inventar um segundo conjunto de regras no fluxo de envio.

Antes de começar

Você precisa de um público da Bird com um nome, dos registros de contato correspondentes e de acesso às operações de públicos documentadas. Defina qual sistema de origem controla a seleção e quem pode alterar suas condições. Use uma pequena coorte de teste antes de executar a integração em um público de campanha.

Anote as condições de inclusão, as exclusões e o horário da avaliação. Para uma coorte de clientes que renovam na próxima semana, especifique o fuso horário e o que acontece quando a origem registra uma renovação concluída. A seleção deve ser reproduzível o suficiente para investigar um membro inesperado.

Resolver os registros selecionados

Obtenha o resultado da origem e registre na integração o horário da avaliação ou a revisão.
Crie ou atualize os contatos correspondentes na Bird com a operação de contatos em lote. Escolha deliberadamente como usar o identificador de origem para encontrar a correspondência.
Inspecione o resultado de cada entrada. Mantenha o ID de origem e o ID de contato resultante da Bird no registro de reconciliação da integração.
Resolva conflitos de identificadores antes de considerar a pessoa sincronizada. Uma solicitação com entradas bem-sucedidas também pode conter entradas com falha.

O lote de contatos aceita audience_ids ao adicionar registros a públicos conhecidos. Use esse campo nas adições quando for adequado; as remoções ainda exigem uma decisão separada sobre a participação. Uma importação que omite uma pessoa não é uma instrução para removê-la de um público nem para excluí-la.

Reconciliar adições e remoções

Consulte os membros existentes com Listar os contatos de um público e percorra todas as páginas. Compare os IDs de contato da Bird com a seleção de origem resolvida.

Diferença	Ação
Selecionado na origem, ausente no público	Adicione o contato ao público
Presente no público, ausente na origem	Remova a participação se a origem controla esse público
Presente em ambos	Mantenha a participação
Não foi possível resolver o registro de origem	Investigue antes de concluir a atualização

Aplique as alterações por meio de Adicionar contatos a um público e Remover contatos de um público. Respeite os limites de lote atuais dessas referências.

Não remova alguém apenas porque uma exportação da origem estava incompleta. Confirme que você tem a seleção de origem completa, incluindo a última página, antes de calcular as remoções. Evite também combinar um público gerenciado pela integração com edições manuais independentes de membros, a menos que exista uma política explícita para preservá-las.

Concluir a atualização

Depois de aplicar as diferenças, inspecione as operações com falha e consulte novamente os membros afetados. Marque a atualização como concluída quando a participação corresponder à seleção de origem pretendida. Armazene o resultado na integração para que a próxima execução diferencie uma atualização concluída de uma interrompida.

Se o processo parar no meio, retome a partir do trabalho registrado ou recalcule a diferença em relação ao público atual. Adicionar um membro existente mantém a participação intacta; remover um membro altera a participação naquele público, não o registro do contato nem o consentimento.

Verifique novamente a idempotência e a especificação de resposta atuais da operação antes de repetir automaticamente uma solicitação cujo resultado é incerto. Trate a aceitação da solicitação, os resultados de cada entrada e a reconciliação final como observações distintas.

Conectar o público ao envio

Use a seleção concluída no fluxo de campanha pertinente. Registre quando o público foi atualizado pela última vez e inspecione a estimativa atual da transmissão antes do envio. Dados de contato, preferências e supressões podem mudar após a atualização dos membros.

Em uma transmissão de Email, a estimativa parte do total de membros e se restringe aos membros com endereço e aos que podem receber envios. O resultado final da entrega é uma observação separada. Ao analisar os resultados, mantenha juntos a coorte de origem, o contexto do envio e a definição do resultado de negócio.

Solução de problemas

Remoções inesperadas: verifique se a exportação da origem está incompleta ou se outro processo ou usuário está alterando o mesmo público.
O mesmo contato com falha reaparece a cada execução: resolva o conflito do identificador de origem ou a propriedade inválida em vez de ignorar o contato indefinidamente sem avisar.
As pessoas permanecem depois de sair do segmento: verifique se sua integração aplica remoções além de adições.
A contagem de membros que podem receber envios é menor: inspecione endereços, preferências e supressões em vez de adicionar as pessoas novamente.

Próximos passos

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaGetting started with email Explore a funcionalidadeEmail Siga o percurso de aprendizagemBuild your first integration Guia de implementaçãoSend your first email

Experimente na prática e obtenha um resumo de implementação