Configuração da integração padrão do Shopify

Esta página o orienta sobre como integrar o Braze ao Shopify usando nossa integração padrão para usuários com uma loja on-line do Shopify. Se você usa um site headless da Shopify ou está procurando implementar soluções mais personalizadas, consulte a configuração de integração personalizada da Shopify.

Etapa 1: Conecte sua loja da Shopify

1. Na Braze, acesse Integrações de parceiros > Parceiros de tecnologia e depois procure “Shopify”.

2. Na página do parceiro do Shopify, selecione Iniciar configuração para iniciar o processo de integração.



3. Na loja de aplicativos da Shopify, instale o aplicativo Braze.

4. Depois de instalar o app Braze, você será redirecionado ao Braze para confirmar o espaço de trabalho que deseja conectar ao Shopify. Uma loja da Shopify pode se conectar a apenas um espaço de trabalho. Se precisar mudar, selecione o espaço de trabalho correto.

5. Selecione Iniciar configuração.

Etapa 2: Ativar os SDKs do Braze Web

Para lojas on-line do Shopify, você pode selecionar a configuração padrão para implementar automaticamente o Braze Web SDK e o JavaScript SDK.

Depois de selecionar a jornada de integração da configuração padrão, você precisará escolher quando o Braze deve inicializar e carregar os SDKs em uma das seguintes opções:

• Na visita ao local, como no início da sessão
  • Rastreamento de usuários identificados e anônimos
• Após o registro da conta, como o login da conta
  • Rastreia apenas usuários identificados
  • Começa o rastreamento de dados quando os visitantes do site inscrevem-se ou fazem login em suas contas

Etapa 3: Configure seus dados da Shopify

Configuração de dados padrão

Agora você selecionará os dados do Shopify que deseja rastrear.

Os seguintes eventos serão ativados por padrão na integração padrão.

Para saber mais sobre os dados rastreados por meio da integração, consulte Recursos de dados do Shopify.

Configuração histórica de aterro

Por meio da configuração padrão, você tem a opção de realizar um carregamento inicial de seus clientes e pedidos do Shopify dos últimos 90 dias antes da conexão de integração com o Shopify. Para isso, marque a caixa de seleção para incluir o carregamento inicial de dados como parte de sua integração.

Essa tabela contém os dados que serão inicialmente carregados por meio do backfill.

À medida que seus registros de clientes do Shopify são carregados no Braze, o ID do cliente do Shopify será usado como o ID externo do Braze.

(Avançado) Configuração de rastreamento de dados personalizados

Com os SDKs do Braze, você pode rastrear eventos personalizados ou atributos personalizados que vão além dos eventos padrão para essa integração. Os eventos personalizados capturam interações exclusivas em sua loja, como:

O rastreamento de dados personalizados ajuda a obter insights mais profundos sobre o comportamento do usuário e a personalizar ainda mais a experiência dele. Para implementar eventos personalizados, é necessário editar o código do tema de sua loja no arquivo theme.liquid. Talvez você precise da ajuda de seus desenvolvedores.

Por exemplo, o snippet JavaScript a seguir rastreia se o usuário atual está inscrito em uma newsletter e registra essa informação como um evento personalizado no perfil de usuário na Braze:

1
2
3
4
5
6
7
8
9
braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

O SDK deve ser inicializado (ouvindo a atividade) no dispositivo de um usuário para registrar eventos ou atributos personalizados. Para saber mais sobre o registro de dados personalizados, consulte o objeto User e o objeto logCustomEvent.

Etapa 4: Configurar como gerenciar usuários

Selecione seu tipo de external_id no menu suspenso.

Se você selecionou um tipo de ID externo personalizado, prossiga para as etapas 4.1 e 4.2. Caso contrário, continue na etapa 4.3.

Etapa 4.1: Criar um external_id

Primeiro, acesse o Shopify e crie o metacampo braze.external_id. Recomendamos seguir as etapas em Criação de descrições de metacampo personalizadas. Em Namespace e key, digite braze.external_id. Para Tipo, recomendamos que você escolha um tipo de ID.

Depois de criar o metacampo, ouça customer/create webhooks para que você possa escrever o metacampo quando um novo cliente for criado. Em seguida, use a API do administrador ou a API do cliente para preencher novamente todos os clientes criados anteriormente com esse metacampo.

Etapa 4.2: Criar um ponto de extremidade

Você precisa de um ponto de extremidade GET público para recuperar sua ID externa. Se o Shopify não puder fornecer o metacampo, o Braze chamará esse ponto de extremidade para recuperar o ID externo.

Um exemplo de endpoint é: https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

Resposta

O Braze espera um código de status 200. Qualquer outro código é considerado uma falha no endpoint. A resposta deve ser:

1
{ "external_id": "my_external_id" }

Valide o endereço shopify_customer_id e o endereço de e-mail usando a API de administração ou a API do cliente para confirmar que os valores dos parâmetros correspondem aos valores do cliente no Shopify. Após a validação, você também pode usar as APIs para recuperar o metacampo braze.external_id e retornar o valor do ID externo.

Etapa 4.3: Colete suas aceitações de e-mail ou SMS do Shopify (opcional)

Você tem a opção de coletar suas aceitações de marketing por e-mail ou SMS no Shopify.

Se você usar os canais de e-mail ou SMS, poderá sincronizar seus estados de aceitação de marketing por e-mail e SMS no Braze. Se você sincronizar as aceitações de e-mail marketing do Shopify, o Braze criará automaticamente um grupo de inscrições para e-mail para todos os usuários associados a essa loja específica. Você precisa criar um nome exclusivo para esse grupo de inscrições.

Etapa 5: Sincronizar produtos (opcional)

Você pode sincronizar todos os produtos de sua loja Shopify com um catálogo Braze para uma personalização mais profunda do envio de mensagens. As atualizações automáticas ocorrem quase em tempo real para que seu catálogo sempre reflita os detalhes mais recentes dos produtos. Para saber mais, confira a sincronização de produtos da Shopify.

Etapa 6: Ativar canais (opcional)

É possível ativar as mensagens no app sem usar um desenvolvedor, configurando-as em sua instalação.

Suporte a canais SDK adicionais

Os SDKs da Braze ativam vários canais de envio de mensagens, incluindo cartões de conteúdo.

Cartões de conteúdo e Feature Flags

Para adicionar cartões de conteúdo ou sinalizadores de recursos, você precisará colaborar com seus desenvolvedores para inserir o código SDK necessário diretamente em seu arquivo theme.liquid. Para obter instruções detalhadas, consulte Integração do SDK do Braze.

Notificações por push na Web

Atualmente, não há suporte para web push na integração com o Shopify. Se você quiser ver esse suporte no futuro, envie uma solicitação de produto por meio do portal do produto Braze.

Se você deseja ver esse suporte no futuro, envie uma solicitação de produto por meio do portal do produto Braze.

Etapa 7: Concluir configuração

1. Depois de fazer as configurações, selecione Finish Setup (Concluir configuração).
2. Ative a incorporação do app Braze nas configurações do tema do Shopify. Selecione Open Shopify para ser redirecionado à sua conta do Shopify e ativar a incorporação do app nas configurações de tema da sua loja.

3. Depois de ativar a incorporação do app, sua configuração estará concluída! Confirme que você pode visualizar suas configurações de integração, o status da sincronização inicial de dados e seus eventos ativos do Shopify.