Skip to content

Integração padrão do Shopify com ferramenta de tag de terceiros

Esta página orienta você no uso de ferramentas de terceiros, como o Google Tag Manager, com a integração padrão do Shopify para inicializar e carregar o Braze Web SDK.

Para lojas on-line do Shopify, recomendamos usar o método de integração padrão da Braze para oferecer suporte aos SDKs da Braze em seu site. No entanto, entendemos que você pode preferir usar uma ferramenta de terceiros, como o Google Tag Manager. Se você optar por usar uma ferramenta de terceiros com o conector Shopify da Braze, lembre-se de que a integração da Braze e a incorporação do app gerenciarão o SDK durante o processo de checkout.

Requisitos

  • Chave de API consistente entre sua ferramenta de terceiros e o conector do Shopify: A chave de API deve ser consistente tanto na Braze quanto em sua ferramenta de terceiros. Isso evita a criação de usuários duplicados e mantém a compatibilidade entre os SDKs.
    • Local da chave de API: Depois de concluir a integração padrão, a integração criará automaticamente um app da web da Braze chamado “Shopify”. Recupere a chave de API dentro da integração que é usada com a configuração da ferramenta de terceiros.
  • Versões consistentes do SDK entre sua ferramenta de terceiros e o conector do Shopify: A versão do SDK deve ser 5.4 em sua ferramenta de terceiros. O uso de um número de versão incorreto pode causar problemas de incompatibilidade, pois alguns métodos do SDK podem não existir em versões mais antigas.
  • Tempo de inicialização consistente do SDK: Nas configurações de integração padrão do Shopify, você pode selecionar os SDKs a serem inicializados no início da sessão ou quando ocorrer um login na conta. Essa configuração deve ser consistente entre sua ferramenta de terceiros e a Braze. Inconsistências podem levar a problemas posteriores para o usuário e para a sincronização de dados.

Configuração da integração com uma ferramenta de terceiros

Desviar-se das etapas fornecidas pode levar a problemas inesperados, portanto, certifique-se de segui-las à risca.

  1. Siga as etapas fornecidas na configuração da integração padrão do Shopify. Ao ativar os SDKs do Braze Web, marque a caixa que indica que você está usando uma ferramenta de terceiros para adicionar o Braze Web SDK ao seu site do Shopify.

"Braze SDK settings" com uma caixa de seleção para indicar que você usará uma ferramenta de terceiros para adicionar o Braze Web SDK.

  1. Acesse Settings > App Settings, selecione o app da web Shopify e copie a API key for Shopify on Web.
  2. Cole a chave de API na configuração do SDK da web de sua ferramenta de terceiros e defina a versão do SDK como 5.4.

Captura de dados do Shopify e sincronização de usuários

Desde que o Web SDK esteja acessível no front-end do seu site do Shopify por meio de uma ferramenta de terceiros, a integração padrão capturará os dados do Shopify e sincronizará os usuários conforme esperado.

Considerações e isenções de responsabilidade

  • Configurações de inicialização: Se você modificar as configurações de inicialização por meio da ferramenta de terceiros, a sincronização de usuários e dados poderá ser afetada. Por exemplo, se você optar por inicializar o SDK quando um formulário de consentimento de cookie for aceito, a Braze não receberá rastreamento de usuários anônimos ou dados até que o usuário consinta.
  • Não há suporte para a definição de atributos diretamente pelo dataLayer: Use window.braze em vez de dataLayer para definir atributos.
  • Usuários duplicados em potencial: Se a chave de API não corresponder entre a Braze e sua ferramenta de terceiros, poderão ser criados usuários duplicados.
  • Incompatibilidade de SDK: O uso de um número de versão incorreto pode causar problemas com os métodos do SDK.
New Stuff!