Sincronização de segmentos do Shopify
A sincronização de segmentos do Shopify estende sua loja Shopify para a Braze, dando à sua equipe de marketing acesso direto a dados de usuários mais ricos que residem no Shopify, incluindo sinais que não são capturados pela integração padrão da Braze com o Shopify. Ao sincronizar segmentos do Shopify como coortes, você alinha as definições de público em ambas as plataformas e entrega experiências de usuário consistentes e coordenadas, seja direcionando-os no Shopify ou alcançando-os por meio de uma Campaign na Braze.
A sincronização de segmentos do Shopify está atualmente em beta. Para solicitar acesso, entre em contato com seu gerente de sucesso do cliente.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Integração Braze com Shopify | O app Braze Shopify deve estar instalado na sua loja Shopify e conectado a um espaço de trabalho da Braze. Para instruções de configuração, consulte Configuração da integração padrão com Shopify ou Configuração da integração personalizada com Shopify. |
| Permissão de usuário no Shopify | O usuário do Shopify que iniciar a sincronização de segmentos deve ter a permissão Export para exportar dados de usuários. Para saber mais sobre permissões no Shopify, consulte a documentação de permissões de loja do Shopify. |
Como funciona
A sincronização de segmentos da Shopify funciona em duas fases.
- Preenchimento inicial: Quando você sincroniza um segmento pela primeira vez, a Braze preenche todos os membros atuais e cria uma coorte correspondente na Braze. O preenchimento é executado de forma assíncrona e pode levar alguns instantes para ser concluído.
- Sincronização contínua: Após o preenchimento inicial, a Braze também se inscreve nos webhooks da Shopify para que a associação permaneça sincronizada em tempo quase real.
| Tópico do webhook | Efeito na Braze |
|---|---|
customer.joined_segment |
O usuário é adicionado à coorte correspondente na Braze. |
customer.left_segment |
O usuário é removido da coorte correspondente na Braze. |
Se uma sincronização falhar, o modal da extensão de ação exibe um banner de erro explicando o que aconteceu e como proceder. Alguns erros oferecem a ação Retry sync. Outros exigem uma alteração de administrador ou de configuração.
Integração de importação de dados
Etapa 1: Selecione um segmento do Shopify para sincronizar
No Shopify, acesse Customers > Segments e selecione o segmento que deseja sincronizar com a Braze. Você pode sincronizar qualquer segmento criado usando a segmentação nativa do Shopify, incluindo segmentos baseados em histórico de pedidos, compras de produtos, tags de clientes, gasto vitalício e metafields.
Etapa 2: Inicie a sincronização
- Na página de detalhes do segmento no Shopify, abra o menu suspenso Use segment e selecione Braze Segment Sync.
- O modal da extensão de ação da Braze é aberto, exibindo o nome do segmento e o tamanho do público. Selecione Sync with Braze para iniciar a importação.
- O modal transiciona para um estado de sincronização e exibe um banner de progresso enquanto a Braze importa os membros.
- Selecione Close. A sincronização continua em segundo plano. Fechar o modal não a interrompe.
Para verificar se a sincronização foi concluída, feche e reabra o modal. Quando a sincronização terminar, o modal será aberto com um banner de sucesso.
Etapa 3: Crie um Segment na Braze com o filtro de participação em coorte
Na Braze, acesse Audience > Segments e crie um novo segmento. Em Add Filter, selecione o filtro Cohort Membership e escolha o segmento sincronizado do Shopify no menu suspenso. Após salvar, você pode referenciar esse Segment da Braze ao direcionar usuários em uma Campaign ou Canvas.
Ressincronização de um segmento
Depois que um segmento é sincronizado, você pode atualizar a associação de coorte a qualquer momento usando a mesma extensão de ação.
- No Shopify, abra o segmento sincronizado e selecione Use segment > Braze Segment Sync.
- No modal, selecione Sync now.
- Na caixa de diálogo de confirmação, selecione Sync now para iniciar a ressincronização.
A ressincronização é aditiva: usuários que correspondem ao segmento atual do Shopify são adicionados à coorte, mas os usuários que não correspondem mais permanecem na coorte.
Gerenciando segmentos sincronizados na Braze
Você pode gerenciar todos os segmentos sincronizados a partir do dashboard da Braze. Acesse Integrações com parceiros > Parceiros de tecnologia, selecione sua integração com a Shopify e abra a guia Gerenciar usuários.
Status de sincronização
Cada segmento sincronizado tem um status de sincronização.
| Status | Descrição |
|---|---|
| Sincronizando | A Braze está importando os membros do segmento. |
| Na fila | O segmento está aguardando um slot de sincronização disponível. |
| Ativo | O segmento está sincronizado e as atualizações de membros ocorrem quase em tempo real. |
| Pausado | As atualizações de membros para este segmento estão pausadas. |
| Erro | A última tentativa de sincronização falhou. Selecione Tentar sincronização novamente para tentar de novo. |
Sincronizando segmentos em massa
Para sincronizar segmentos adicionais, edite a integração, acesse a etapa Gerenciar usuários e selecione Editar segmentos na seção Sincronizar segmentos. No modal de seleção:
- Selecione qualquer quantidade de segmentos. 25 segmentos são sincronizados por vez; o restante entra na fila automaticamente.
- Segmentos que já estão sendo sincronizados ficam bloqueados. Para remover um segmento, exclua-o na Shopify.
Salve suas alterações para iniciar as sincronizações.
Pausando um único segmento
Para pausar a sincronização de um segmento, selecione Pausar sincronização na linha correspondente na tabela de segmentos e confirme. Quando a sincronização de um segmento é pausada:
- A coorte e seus membros permanecem na Braze e continuam disponíveis para direcionamento. Campaigns e Canvas que utilizam a coorte continuam enviando para os membros atuais da coorte.
- As atualizações de membros são interrompidas.
- Renomear o segmento na Shopify ainda atualiza o nome de exibição da coorte.
- Excluir o segmento na Shopify ainda encerra o rastreamento.
- Solicitações de Sincronizar agora da extensão de ação da Shopify são rejeitadas.
Para retomar, selecione Retomar sincronização na linha correspondente. A Braze retoma as atualizações de membros e executa uma sincronização de recuperação. Usuários que saíram do segmento na Shopify enquanto a sincronização estava pausada permanecem na coorte da Braze.
Pausando a sincronização de todos os segmentos
Para pausar a sincronização de todos os segmentos de uma vez, edite a integração, selecione Pausar sincronização na seção Sincronizar segmentos da etapa Gerenciar usuários e salve suas configurações. Enquanto toda a sincronização de segmentos estiver pausada:
- A tabela de segmentos exibe apenas os nomes dos segmentos, com o status Pausado ao lado do título.
- As ações no nível da linha ficam indisponíveis até que você retome.
- A Braze não atualiza os nomes das coortes para renomeações na Shopify. Os nomes das coortes são atualizados quando você retomar.
- Solicitações de Sincronizar agora da extensão de ação são rejeitadas. A extensão continua exibindo o último status conhecido de cada segmento, e selecionar Sincronizar agora não inicia uma sincronização.
Para retomar, selecione Retomar sincronização na mesma seção e salve. A Braze sincroniza novamente de forma automática todos os segmentos previamente selecionados com uma sincronização de recuperação. Você não precisa selecioná-los novamente. Segmentos que você pausou individualmente permanecem pausados até que você os retome a partir da linha correspondente na tabela de segmentos.
Atualizações de Segment no Shopify
Renomear um segment
Quando você renomeia um segment do Shopify, a Braze atualiza automaticamente o nome de exibição da coorte correspondente. Nenhuma ressincronização é necessária. A Braze também atualiza o nome da coorte enquanto a sincronização de um segment está pausada individualmente. Enquanto toda a sincronização de segments está pausada, a Braze atualiza os nomes das coortes quando você retoma.
Alterar os critérios de um segment
A Braze não atualiza automaticamente os membros da coorte quando você altera os critérios de um segment do Shopify. Para incluir usuários que passaram a atender aos critérios, faça a ressincronização do segment a partir da extensão de ação. Os usuários que não atendem mais aos critérios permanecem na coorte porque a ressincronização não remove membros. Para saber mais, consulte Ressincronizar um segment.
Correspondência de usuários
Os usuários sincronizados a partir de Segments da Shopify são correspondidos a perfis de usuário da Braze usando o alias shopify_customer_id, que é definido como parte da integração Braze com Shopify. Usuários sem um perfil de usuário correspondente na Braze são ignorados durante a sincronização.
Para saber mais sobre como a integração com a Shopify identifica e cria aliases de usuários, consulte Recursos de dados da Shopify.
A Braze faz a correspondência dos usuários sincronizados com os perfis de usuário existentes na Braze, independentemente de como esses perfis foram criados, incluindo por meio do preenchimento histórico da Shopify, da sua própria plataforma de dados (como Snowflake ou outro data warehouse) ou de importações diretas pela API. Se a sua coorte for menor do que o seu Segment da Shopify, isso significa que alguns membros do segmento ainda não possuem um perfil correspondente na Braze. Para aumentar a cobertura de correspondência, preencha os perfis de usuário na Braze pelo método de sua preferência antes de realizar a sincronização.
Limitações
- Sincronização unidirecional. A associação ao Segment flui apenas do Shopify para a Braze. Alterações na associação à coorte feitas diretamente na Braze não são enviadas de volta ao Shopify.
- Sem criação de perfil. Apenas clientes do Shopify que já possuem um perfil de usuário na Braze são adicionados à coorte.
- Não é possível interromper a sincronização a partir da Braze. Para interromper a sincronização de um Segment, exclua-o no Shopify. A coorte e seus membros permanecem na Braze e param de ser atualizados.
- A ressincronização apenas adiciona membros. Ressincronizar um Segment adiciona novos usuários correspondentes à coorte, mas não remove usuários que não fazem mais parte do Segment no Shopify.