Visão geral do Shopify
A Shopify é uma empresa líder em comércio global que fornece ferramentas confiáveis para iniciar, crescer, comercializar e gerenciar negócios de qualquer tamanho. A Shopify torna o comércio melhor para todo mundo com uma plataforma e serviços projetados para confiabilidade, enquanto oferece uma melhor experiência de compra para consumidores em todos os lugares.
A integração da Braze com a Shopify fornece uma solução poderosa para empresas de eCommerce que buscam aprimorar o engajamento do cliente e impulsionar esforços de marketing personalizados. Essa integração conecta perfeitamente as robustas capacidades de eCommerce da Shopify com nossa avançada plataforma de engajamento com clientes, permitindo que você envie mensagens direcionadas, relevantes e oportunas aos seus usuários com base em comportamentos de compra em tempo real e dados transacionais.
Requisitos
| Requisito | Descrição |
|---|---|
| Loja Shopify | Você tem uma loja Shopify ativa. |
| Permissões de proprietário ou membro da equipe da loja Shopify |
|
Como integrar
A Braze oferece duas opções de integração para lojistas do Shopify, projetadas para atender às diversas necessidades de negócios de eCommerce: Integração padrão e Integração personalizada.
A integração padrão é feita sob medida para lojas online Shopify, proporcionando um processo de configuração simples e direto. Essa opção permite que você conecte rapidamente sua loja Shopify à Braze, possibilitando o uso de ferramentas poderosas de engajamento de clientes sem necessidade de ampla expertise técnica. Com essa opção de integração, você pode sincronizar dados de clientes, automatizar o envio de mensagens personalizadas e aprimorar seus esforços de marketing por meio de recursos abrangentes da Braze.
Para usar a integração padrão do Shopify, consulte Configuração da integração padrão do Shopify.
A integração personalizada oferece uma solução mais flexível e componível se você usar Shopify Hydrogen ou tiver uma loja headless. Essa opção permite que você implemente os SDKs da Braze diretamente no seu ambiente Shopify, possibilitando uma integração mais profunda e funcionalidades personalizadas. Se você deseja criar experiências únicas para os clientes ou otimizar fluxos de trabalho específicos, a integração personalizada fornece as ferramentas necessárias para aproveitar totalmente as capacidades da Braze em uma configuração headless.
Para usar a integração personalizada do Shopify, consulte Configuração da integração personalizada do Shopify.
Como a integração funciona
Se você já configurou e ativou o preenchimento histórico nas configurações, a sincronização inicial de dados começará imediatamente.
Se você planeja integrar com um ID externo personalizado (seja para a integração padrão ou para a integração personalizada), será necessário adicionar seu ID externo personalizado como um metacampo de cliente da Shopify a todos os perfis de clientes existentes da Shopify e, em seguida, realizar o backfill histórico.
Após a sincronização inicial de dados, a Braze rastreará continuamente novos dados e atualizações, diretamente do Shopify e dos SDKs da Braze.

Se você já é cliente da Braze com Campaigns ou Canvas ativos, consulte o preenchimento histórico do Shopify para informações importantes. Para ver quais dados de clientes estão sendo preenchidos, consulte os recursos do Shopify.
Sincronização de usuários e dados
Após a integração estar ativa, a Braze coletará dados de usuários de duas fontes principais por meio da integração com o Shopify:
- API Shopify Web Pixel e app embeds: Isso alimenta o Braze Web SDK e o Javascript SDK para suportar rastreamento no site, gerenciamento de identidade, dados comportamentais de eCommerce e canais de envio de mensagens como In-App Messages.
- Webhooks do Shopify: dados comportamentais de eCommerce, sincronização de produtos e coleta de inscritos
Durante a integração, será necessário selecionar quando os SDKs da Braze inicializam e carregam o seu site Shopify:
- Ao visitar o site (como início de sessão)
- O que faz: Rastreia usuários anônimos — como visitantes comprando sem conta — para acessar mais dados para uma personalização mais profunda
- Ao criar conta (como login na conta)
- O que faz: Impede o rastreamento de usuários anônimos para uma abordagem mais conservadora e orientada à privacidade, de modo que a atividade do usuário é rastreada após ele fazer login em sua conta

- As visitas ao website (sessões) contam para suas cotas de MAU (usuários ativos mensais).
- As versões do Braze Web SDK e do JavaScript SDK são definidas automaticamente como v6.8.0. Você pode atualizar a versão do SDK a qualquer momento nas configurações de integração.
A Braze usa a integração com o Shopify para suportar múltiplos identificadores que rastreiam seus usuários desde a experiência de compra como visitante até se tornarem usuários identificados:
| Identificador Braze | Descrição |
|---|---|
device_id da Braze |
Um ID gerado aleatoriamente e armazenado no navegador que rastreia a atividade de usuários anônimos por meio dos SDKs da Braze. |
| Alias de usuário do token do carrinho | Um alias que a Braze cria para rastrear eventos de atualização do carrinho. Esse token é criado usando o token de carrinho do Shopify. |
| Alias de usuário do token de checkout | Um alias que a Braze cria quando o usuário inicia o processo de checkout. Esse token é criado usando o token de checkout do Shopify. Se um cliente usar o Shop Pay como opção de checkout acelerado, o Shopify pode ignorar certos eventos padrão de checkout e impedir que a Braze receba os dados necessários para adicionar o alias do token de checkout. |
| Alias do ID do cliente Shopify | O ID do cliente Shopify é atribuído como alias quando o ID externo é atribuído durante o login da conta ou quando um pedido é feito. |
external_id da Braze |
Um identificador único que ajuda a rastrear clientes em diferentes dispositivos e plataformas. Isso mantém uma experiência de usuário consistente e melhora a análise de dados, prevenindo múltiplos perfis quando os usuários trocam de dispositivo ou reinstalam o app. A integração com o Shopify suporta os seguintes tipos de external_id:
external_id aos seus usuários chamando o método changeUser nos SDKs quando:
Para saber mais sobre o que acontece quando você atribui um external_id a um perfil anônimo, consulte Ciclo de vida do perfil de usuário.A Braze também usará o external_id para atribuir dados comportamentais de eCommerce downstream dos webhooks do Shopify. |
A integração requer que os SDKs da Braze e os serviços do Shopify trabalhem juntos para rastrear e atribuir adequadamente os dados do Shopify aos usuários corretos em tempo quase real. Para mais detalhes sobre os dados rastreados pela integração, consulte Dados do Shopify.

- Se você estiver testando a integração, recomendamos usar o modo anônimo ou limpar seus cookies para redefinir o
device_idda Braze e simular o comportamento de um usuário anônimo. - Embora um ID do cliente Shopify seja gerado quando um e-mail é inserido no rodapé de newsletter do Shopify ou durante o processo de checkout antes de um pedido ser feito, esse ID do cliente não está acessível por meio dos Shopify Web Pixels. Por causa disso, a Braze não pode usar o método
changeUsernessas duas situações.
Sincronizando aceitações de marketing por e-mail e SMS do Shopify
Se você ativar a coleta de inscritos nas configurações, será necessário atribuir um grupo de inscrições para cada loja que você conectar à Braze. Isso significa que seus clientes serão categorizados como “inscrito” ou “cancelou inscrição” no grupo de inscrições da sua loja.
O status de aceitação de marketing do Shopify para e-mail e SMS pode ser atualizado das seguintes formas:
- Atualização manual: Você pode alterar manualmente o status de aceitação de marketing por e-mail ou SMS de um usuário no painel de administração do Shopify.
- Rodapé de newsletter do Shopify: Se um usuário inserir seu e-mail no rodapé padrão de newsletter do Shopify, o status de aceitação será atualizado.
- Checkout: O consentimento do usuário é capturado no checkout quando os usuários selecionam a caixa de marketing e prosseguem com o checkout selecionando Pay now no checkout de uma página ou Continue to shipping no checkout de três páginas.

O status de aceitação de marketing por e-mail do Shopify não alterará o estado global de inscrição de e-mail de um usuário na Braze. O estado de inscrição padrão quando um perfil de usuário é criado é “Subscribed”. Lembre-se de usar o grupo de inscrições como parte dos critérios de entrada da sua Campaign ou Canvas.
Esta tabela mostra quais estados de aceitação de marketing do Shopify correspondem aos status dentro do seu grupo de inscrições na Braze.
| Estado de aceitação de marketing do Shopify | Estado do grupo de inscrições na Braze |
|---|---|
| E-mail inscrito | Subscribed |
| E-mail com inscrição cancelada | Unsubscribed |
| E-mail com confirmação pendente | Unsubscribed |
| E-mail inválido | Unsubscribed |
| SMS inscrito | Subscribed |
| SMS com inscrição cancelada | Unsubscribed |
Double opt-in de SMS
Use o double opt-in de SMS para enviar seu texto de confirmação personalizado pela Braze em vez do e-mail de confirmação do Shopify. Para ativar o double opt-in de SMS, faça o seguinte:
- No painel de administração do Shopify, acesse Settings > Notifications > Customer notifications.
- Desative o double opt-in de marketing para SMS.
- Se o double opt-in do Shopify permanecer ativo, o Shopify enviará seu próprio status pendente ou um e-mail de confirmação, e os compradores não receberão a confirmação por SMS da Braze.
- Defina o SMS de checkout como single opt-in.
- Nas configurações de SMS da Braze, selecione Use Braze SMS double opt-in.

Quando um comprador se inscreve para SMS no checkout ou por meio de um formulário, acontece o seguinte:
- O Shopify envia a inscrição para a Braze.
- A Braze define o comprador como pendente e envia seu texto de confirmação.
- O comprador responde com sua palavra-chave de confirmação e se torna inscrito.
- Se ele não responder antes que a janela de confirmação termine, permanece como pendente.
Para saber mais sobre o double opt-in de SMS da Braze, consulte Double opt-in de SMS.
Formulários de inscrição
Rodapé de newsletter do Shopify
Os usuários que inserirem seu endereço de e-mail no rodapé de newsletter do Shopify passarão por um destes fluxos:
Usuários que não fizeram login em sua conta
- A Braze recebe um webhook de entrada do Shopify sempre que um cliente é criado ou atualizado.
- A Braze cria um perfil de usuário contendo o endereço de e-mail e o alias do ID do cliente Shopify associados a esse usuário.
- O SDK da Braze atualiza o perfil anônimo com o endereço de e-mail.

Isso pode resultar em um perfil duplicado até que o usuário se identifique criando sua conta, fazendo login em sua conta ou fazendo um pedido. A Braze oferece ferramentas de mesclagem em massa para ajudar a automatizar a reconciliação de perfis duplicados. Consulte Usuários duplicados para mais detalhes.
Usuários que já fizeram login em sua conta
A Braze criará um perfil de usuário contendo o endereço de e-mail e o alias do ID do cliente Shopify associados a esse usuário. A Braze não atualizará o endereço de e-mail do usuário logado, pois assumimos que o Shopify já forneceu essa informação.
Formulários de inscrição da Braze
A Braze oferece dois tipos de modelos de formulário de inscrição:
- Formulários de inscrição por e-mail: Crie esses formulários usando o editor de arrastar e soltar.
- Formulário de captura de e-mail do editor tradicional: Um formulário mais direto para capturar endereços de e-mail.
Quando você usa esses modelos de formulário de inscrição, a Braze atualiza automaticamente o status global de inscrição de e-mail no perfil do usuário. Para mais detalhes sobre como o estado global de inscrição de e-mail é tratado, incluindo informações sobre validação de e-mail, consulte a documentação de cada tipo de modelo de formulário.

- Certifique-se de incluir critérios de entrada na sua Campaign ou Canvas que incluam tanto o status global de inscrição de e-mail quanto o grupo de inscrições conectados à sua loja Shopify. Isso ajudará a garantir que você está direcionando o público certo.
- A Braze coleta informações dos visitantes, como endereços de e-mail e números de telefone, por meio de mensagens no navegador. Essas informações são então enviadas para a API Shopify Visitor, mas não criam um perfil de cliente no Shopify. Para mais detalhes, consulte Visitor API.
Formulários de inscrição de terceiros
Se você estiver usando uma plataforma de terceiros ou um plugin do Shopify para seus formulários de inscrição, será necessário trabalhar com seus desenvolvedores para integrar o código do SDK da Braze para capturar o endereço de e-mail e o status global de inscrição de e-mail dos envios de formulário. Para saber mais, consulte Configuração da integração padrão do Shopify e Configuração da integração personalizada do Shopify.
Sincronização de produtos
A Braze suporta a capacidade de sincronizar os produtos da sua loja Shopify em um catálogo da Braze. Para mais detalhes, consulte Sincronizações de produtos do Shopify.
Solicitações de titulares de dados
Como parte da integração da Braze com a Shopify, a Braze recebe automaticamente os webhooks de conformidade da Shopify. No entanto, como os clientes são os controladores dos dados de seus usuários finais, eles devem realizar todas as ações necessárias para atender às solicitações de titulares de dados recebidas em relação aos dados de usuários finais na Braze (incluindo os dados de usuários finais recebidos por meio da integração com a Shopify). Consulte nossa documentação de Assistência Técnica para Proteção de Dados para saber mais.