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 fazer a integração
A Braze oferece duas opções de integração para comerciantes da Shopify, criadas para atender às diversas necessidades das empresas de e-commerce: 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 retroativo de histórico nas suas configurações, a sincronização inicial de dados começa 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.
Depois da sincronização inicial de dados, a Braze rastreia continuamente novos dados e atualizações diretamente da Shopify e dos SDKs da Braze.

Se você já é cliente da Braze e tem Campaigns ou Canvas ativos, consulte Preenchimento retroativo de histórico da Shopify para ver informações importantes. Para ver quais dados específicos de clientes estão sendo preenchidos retroativamente, consulte Recursos da Shopify.
Sincronização de usuários e dados
Depois que a integração estiver ativa, a Braze coleta dados de usuários de duas fontes principais por meio da integração com a Shopify:
- Shopify Web Pixel API e incorporações de app: Viabiliza o Braze Web SDK e o JavaScript SDK para oferecer suporte a rastreamento no site, gerenciamento de identidade, dados comportamentais de eCommerce e canais de envio de mensagens como mensagens no app.
- Webhooks da Shopify: Dados comportamentais de eCommerce, sincronização de produtos e coleta de inscritos
Durante a integração, você precisa escolher quando os SDKs da Braze são inicializados e carregados no seu site da Shopify:
- Ao visitar o site (como no início da sessão)
- O que faz: Rastreia usuários anônimos, como compradores convidados, para acessar mais dados e oferecer uma personalização mais profunda
- Ao criar uma conta (como no login da conta)
- O que faz: Impede o rastreamento de usuários anônimos para uma abordagem mais conservadora e voltada à privacidade. Assim, a atividade do usuário é rastreada depois que ele faz login na conta

- As visitas ao site (sessões) contam para suas cotas de usuários ativos mensais (MAU).
- As versões do Braze Web SDK e do JavaScript SDK são definidas automaticamente como v6.8.0. Você pode fazer upgrade da versão do SDK a qualquer momento nas configurações da integração.
A Braze usa a integração com a Shopify para oferecer suporte a vários identificadores que rastreiam seus usuários desde a experiência de compra como convidado até se tornarem usuários identificados:
| Identificador da 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 do carrinho da 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 da Shopify. Se um cliente usar o Shop Pay como opção de checkout acelerado, a Shopify pode ignorar alguns 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 de cliente da Shopify | O ID de cliente da Shopify é atribuído como alias quando o ID externo é atribuído durante o login na conta ou quando um pedido é feito. |
external_id da Braze |
Um identificador exclusivo 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, evitando vários perfis quando os usuários trocam de dispositivo ou reinstalam o app. A integração com a Shopify oferece suporte aos 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 posteriores vindos dos webhooks da Shopify. |
A integração exige que os SDKs da Braze e os serviços da Shopify funcionem juntos para rastrear e atribuir corretamente os dados da Shopify aos usuários certos quase em tempo real. Para ver mais detalhes sobre os dados rastreados pela integração, consulte Dados da Shopify.

- Se estiver testando a integração, recomendamos usar o modo anônimo ou limpar os cookies para redefinir o
device_idda Braze e simular o comportamento de um usuário anônimo. - Embora um ID de cliente da Shopify seja gerado quando um e-mail é inserido no rodapé de newsletter da Shopify ou durante o processo de checkout antes de um pedido ser feito, esse ID de cliente não fica acessível pelos Shopify Web Pixels. Por isso, a Braze não pode usar o método
changeUsernessas duas situações.
Sincronização das aceitações de marketing por e-mail e SMS da Shopify
Se você ativar a coleta de inscritos nas suas configurações, precisará atribuir um grupo de inscrições para cada loja conectada à Braze. Isso significa que seus clientes são classificados como “subscribed” (inscritos) ou “unsubscribed” (com inscrição cancelada) no grupo de inscrições da sua loja. Isso vale para aceitações de e-mail, SMS e WhatsApp.
O status de aceitação de marketing da Shopify para e-mail, SMS e WhatsApp pode ser atualizado das seguintes formas:
- Atualização manual: Você pode alterar manualmente o status de aceitação de marketing por e-mail, SMS ou WhatsApp de um usuário na página de administração da Shopify.
- Rodapé de newsletter da Shopify: Se um usuário inserir o e-mail no rodapé de newsletter padrão da Shopify, o status de aceitação dele é atualizado.
- Checkout: O consentimento do usuário é capturado no checkout quando ele marca a caixa de seleção de marketing e continua o checkout selecionando Pagar agora no checkout de uma página ou Continuar para o frete no checkout de três páginas.

O status de aceitação de marketing por e-mail da Shopify não altera o estado global de inscrição de e-mail do 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 do seu Canvas.
Esta tabela mostra como os estados de aceitação de marketing da Shopify correspondem aos status do seu grupo de inscrições da Braze.
| Estado de aceitação de marketing da Shopify | Estado do grupo de inscrições da 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 |
| WhatsApp inscrito | Subscribed |
| WhatsApp com inscrição cancelada | Unsubscribed |
| WhatsApp pendente ou sem consentimento registrado | Não alterado |
Aceitação dupla por SMS
Use a aceitação dupla por SMS para enviar sua mensagem de confirmação personalizada pela Braze em vez do e-mail de confirmação da Shopify. Para ativar a aceitação dupla por SMS, faça o seguinte:
- Na página de administração da Shopify, acesse Configurações > Notificações > Notificações de clientes.
- Desative a aceitação dupla de marketing para SMS.
- Se a aceitação dupla da Shopify continuar ativada, a Shopify envia o próprio status pendente ou um e-mail de confirmação, e os compradores não recebem a confirmação por SMS da Braze.
- Defina o SMS do checkout como aceitação simples.
- 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:
- A Shopify envia a inscrição para a Braze.
- A Braze define o comprador como pendente e envia sua mensagem de confirmação.
- O comprador responde com a palavra-chave de confirmação e passa a estar inscrito.
- Se ele não responder antes do fim da janela de confirmação, continua pendente.
Para saber mais sobre a aceitação dupla por SMS da Braze, consulte Aceitação dupla por SMS.
Aceitações de marketing por WhatsApp
A Shopify armazena o consentimento de marketing por WhatsApp no número de telefone padrão do cliente. Os lojistas coletam o consentimento de marketing por WhatsApp das mesmas formas que o consentimento por SMS:
- No checkout
- No perfil do cliente na página de administração da Shopify
- Por meio de uma importação de clientes
- Por meio da API da Shopify
No checkout, a Shopify mostra a caixa de seleção de SMS ou a de WhatsApp para cada região, de acordo com suas configurações de checkout.
Para sincronizar as aceitações do WhatsApp, selecione Coletar inscritos no WhatsApp na etapa Gerenciar usuários e selecione os grupos de inscrições do WhatsApp que serão sincronizados. Seu espaço de trabalho precisa ter uma conta do WhatsApp Business conectada para ter grupos de inscrições do WhatsApp. Para conectar uma, acesse Parceiros de tecnologia > WhatsApp.
Lembre-se do seguinte:
- A Braze sincroniza apenas o consentimento do WhatsApp registrado pela Shopify. Uma aceitação por SMS ou e-mail não inscreve o cliente no WhatsApp.
- Você é responsável pelo consentimento que coleta. O consentimento definido na página de administração da Shopify ou por meio de uma importação de clientes é sincronizado exatamente como foi definido, então confira se ele atende aos requisitos de aceitação da Meta.
- Um cliente que dá aceitação no checkout não enviou mensagem para o seu número do WhatsApp, então não há uma janela de conversa aberta. Se você enviar uma mensagem de confirmação ou de boas-vindas, use um modelo aprovado pela Meta. Para saber mais, consulte Fluxos de aceitação do WhatsApp.
- Atualmente, o WhatsApp não entrega mensagens de modelo de marketing para números de telefone dos Estados Unidos. Clientes com número dos EUA continuam sendo sincronizados, mas suas mensagens de marketing para eles não são entregues. Para saber mais, consulte Limites de mensagens de modelo de marketing por usuário.
- Clientes cujo número de telefone não está no formato internacional, como
+14155551234, não são sincronizados, porque não conseguiriam receber mensagens do WhatsApp. - Não existe aceitação dupla para o WhatsApp. A configuração Use Braze SMS double opt-in não se aplica às aceitações do WhatsApp.
Formulários de inscrição
Rodapé de newsletter da Shopify
Os usuários que inserem o endereço de e-mail no rodapé de newsletter da Shopify passam por um destes fluxos:
Usuários que não fizeram login na conta
- A Braze recebe um webhook de entrada da Shopify sempre que um cliente é criado ou atualizado.
- A Braze cria um perfil de usuário com o endereço de e-mail e o alias do ID de cliente da Shopify associados a esse usuário.
- O SDK da Braze atualiza o perfil anônimo com o endereço de e-mail.

Isso pode gerar um perfil duplicado até que o usuário se identifique criando uma conta, fazendo login na 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 ver mais detalhes.
Usuários que já fizeram login na conta
A Braze cria um perfil de usuário com o endereço de e-mail e o alias do ID de cliente da Shopify associados a esse usuário. A Braze não atualiza o endereço de e-mail do usuário conectado, porque presumimos que a 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 simples 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 de usuário. Para ver 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.

- Inclua critérios de entrada na sua Campaign ou no seu Canvas que abranjam tanto o status global de inscrição de e-mail quanto o grupo de inscrições conectado à sua loja da Shopify. Isso ajuda a garantir que você esteja 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 Shopify Visitor API, mas não criam um perfil de cliente na Shopify. Para ver mais detalhes, consulte Visitor API.
Formulários de inscrição de terceiros
Se você usa uma plataforma de terceiros ou um plugin da Shopify para seus formulários de inscrição, precisa trabalhar com seus desenvolvedores para integrar o código do SDK da Braze e capturar o endereço de e-mail e o status global de inscrição de e-mail a partir dos envios de formulário. Para saber mais, consulte Configuração da integração padrão da Shopify e Configuração da integração personalizada da Shopify.
Sincronização de produtos
A Braze permite sincronizar os produtos da sua loja da Shopify com um catálogo da Braze. Para ver mais detalhes, consulte Sincronizações de produtos da Shopify.
Solicitações de titulares de dados
Como parte da integração da plataforma 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, cabe a eles 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. Isso inclui os dados de usuários finais recebidos pela integração com a Shopify. Para saber mais, consulte nossa documentação de Assistência técnica de proteção de dados.