Shopify Markets

Este artigo aborda a integração do Shopify Markets, incluindo o que está no escopo, como funciona e como usar os dados de mercados no seu envio de mensagens.

Como a integração funciona

O Shopify Markets estende sua integração existente com o Shopify. Conecte sua loja padrão por meio da integração padrão ou personalizada (SDK) e, em seguida, selecione os mercados dos quais você deseja que a Braze faça a sincronização a partir dos mercados configurados na sua loja. Integrações existentes podem adicionar mercados sem interromper catálogos, grupos de inscrições ou eventos. Para instruções passo a passo, consulte Configuração do Shopify Markets.

O Shopify Markets oferece os seguintes recursos:

• Perfis baseados em mercado: A integração captura o locale do Shopify de cada usuário, juntamente com os atributos padrão de país e idioma da Braze, para que você possa segmentar e disparar por mercado sem nenhuma configuração personalizada.
• Catálogos localizados: Os dados de produtos específicos de cada mercado são sincronizados diariamente, incluindo preços e moeda, além de títulos, descrições e URLs de produtos traduzidos.
• Personalização baseada em mercado: Use a Liquid tag {% shopify_market %} para personalizar com produtos do catálogo do mercado de cada usuário, incluindo o conteúdo traduzido do Shopify. Você também pode consultar detalhes do mercado, como a moeda de apresentação, a partir de eventos do Shopify compatíveis, como ecommerce.order_placed.
• Fallback para a loja padrão: Quando um usuário não pertence a nenhum dos seus mercados conectados, a Braze usa as configurações e os produtos da sua loja padrão, para que cada usuário receba uma mensagem completa e precisa.

Para exemplos, consulte Usar dados de usuário do Markets e Tutorial: Exibir produtos e preços por mercado.

Tipos de mercado Shopify compatíveis

Você pode selecionar até 25 mercados ativos de país único ou de vários países. Cada país pode pertencer a apenas um mercado selecionado.

Mercados de sub-região, mercados de varejo, mercados B2B e mercados de canal não são compatíveis.

O que cada mercado precisa

Cada mercado selecionado precisa de um catálogo de mercado com produtos ativos. A Braze lê as seguintes informações desse catálogo:

Considerações

Geral

• Uma loja conectada: Você pode conectar apenas uma loja Shopify habilitada para Markets a um espaço de trabalho da Braze por vez.
• Escopo de localidade: As localidades trazem títulos e descrições de produtos traduzidos com base no que você configurou usando o app Shopify Translate & Adapt, além de URLs específicas de localidade. Preço, moeda e outros campos compartilhados do catálogo permanecem os mesmos entre localidades dentro de um mercado. Por padrão, a Braze usa o idioma padrão de cada mercado, a localidade primária que a Shopify atribui a esse mercado. Se você ativar o suporte expandido de localidades, a Braze sincroniza localidades adicionais configuradas para esse mercado.

Catálogo de mercado

• Novas visualizações de mercado no seu catálogo Shopify original: Markets não cria catálogos separados. Em vez disso, a Braze os mostra como parte do seu catálogo Shopify original. Os dados de Markets são adicionados como novas linhas de catálogo ao seu catálogo Shopify.
• Seleções de catálogo: Até 30 seleções de catálogo.
• Tempo de atualização: Os dados de produto do catálogo de mercado são atualizados uma vez por dia.
• Preços de mercado e conteúdo localizado: As linhas de mercado incluem o preço do mercado e o compare_at_price, incluindo títulos de produto e variante localizados e URLs de produto quando as traduções são configuradas por meio do app Shopify Translate & Adapt.
• Queda de preço: Compatível com catálogos de mercado. Uma alteração de preço em um catálogo de mercado é disparada com base no preço desse mercado, e não no preço padrão da sua loja. Como os dados de produto do catálogo de mercado são atualizados uma vez por dia, quedas de preço são detectadas diariamente, e não quando o preço muda na Shopify.
• De volta ao estoque: De volta ao estoque é compatível com produtos no catálogo padrão da sua loja. As linhas de mercado não disparam notificações de volta ao estoque. O recurso de volta ao estoque analisa o estoque total disponível para uma variante de produto em todos os locais da Shopify, então estoque adicionado em um local de varejo pode disparar uma notificação.

Configuração do Shopify Markets

Se você já tem uma integração ativa com a Shopify

O Markets adiciona funcionalidades à sua integração atual. Você não precisa desconectá-la ou reconstruir sua configuração.

• Seus grupos de inscrições se tornam seus grupos da loja inteira e continuam recebendo todas as aceitações, incluindo quaisquer grupos adicionais que você tenha atribuído.
• Seus inscritos existentes permanecem nos grupos em que já estão. Se você adicionar grupos de país depois, a Braze não adiciona os inscritos existentes a eles.
• Seu catálogo continua sincronizando. As linhas de mercado são adicionadas a ele em vez de a um novo catálogo, e suas seleções existentes continuam funcionando com suas linhas padrão.
• Sua loja padrão aparece ao lado dos mercados selecionados, permitindo que você atribua grupos de inscrições e crie seleções de catálogo da mesma forma.

Se sua loja já está conectada, comece pela Etapa 2 para saber mais sobre cada configuração e como ela funciona.

Etapa 1: Conectar sua loja com o Shopify Markets ativado

1. Conecte sua loja usando o caminho de integração padrão da Shopify ou integração personalizada da Shopify. Depois que sua loja estiver conectada, configure o Shopify Markets no criador de configuração.
2. Complete o fluxo OAuth e confirme se a Braze solicita os escopos de mercados no OAuth:
   • read_markets
   • read_publications
   • read_locales
3. Após a autorização ser concluída com sucesso e o criador de configuração ser aberto, selecione Begin Setup.
4. Ative os SDKs da Braze.

Etapa 2: Selecionar os dados de usuários do seu mercado

1. Em Track Shopify Data, selecione Sync Shopify Markets data.
2. Selecione Select Markets para escolher seu mercado, e verifique se você selecionou o rastreamento de eventos comportamentais e atributos de usuários.
   • (Opcional) Ative o preenchimento de dados históricos

Dados de usuários de mercados

Para dar suporte ao Shopify Markets, a Braze sincroniza dados adicionais além dos eventos e atributos padrão da integração.

Atributos do perfil de usuário

Propriedades de eventos de pedido

Essas propriedades são adicionadas a:

• Eventos recomendados de eCommerce: ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
• Eventos personalizados: shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order

Como essas propriedades de eventos de mercado funcionam

Moeda

Quando os relatórios do Shopify Markets estão ativados, eventos de webhook nativos de checkout, pedido e reembolso da Shopify trazem dois conjuntos de valores:

• A moeda da sua loja nos campos existentes de preço e total, sem alteração
• O objeto presentment_currency contendo os valores que o cliente viu e pagou

Esses eventos também podem incluir propriedades de mercado relacionadas, como country e market_handle.

Use presentment_currency quando estiver mostrando ao cliente o que ele pagou, como em uma confirmação de pedido ou um lembrete de checkout. Use os valores na moeda da loja quando estiver comparando receita entre mercados, já que eles já estão em uma única moeda.

Eventos de carrinho do pixel da Shopify não incluem presentment_currency. Eventos personalizados de checkout e compra que você envia por meio de uma CDP como o Segment também o omitem. Para manter a moeda do mercado nas suas mensagens e relatórios, inclua um objeto equivalente na carga útil do seu evento personalizado ou mantenha os eventos nativos da Shopify ativados para os tipos de evento de que você precisa.

Informações localizadas de produtos

Eventos da Shopify suportados trazem títulos de produtos e variantes no idioma padrão da sua loja. A Braze não traduz as cargas úteis dos eventos.

Títulos traduzidos, descrições e URLs de produtos ficam nas linhas de mercado do seu catálogo. Para exibir informações localizadas de produtos em uma mensagem, pesquise o produto no seu catálogo usando o ID do produto ou da variante do evento.

Etapa 3: Gerenciar usuários

1. Selecione o tipo de external_id no menu suspenso.
2. Ative as aceitações de e-mail e SMS da Shopify, o que permite que a Braze sincronize os status de inscrição de e-mail e SMS da Shopify. Você tem duas opções:
   • Usar a integração: A Braze sincroniza os status de e-mail e SMS. Selecione os grupos de inscrições para os quais eles sincronizam.
   • Criar sua própria: Para mais controle sobre o gerenciamento de status, crie uma integração personalizada usando os endpoints de grupo de inscrições da Braze.
3. Selecione os grupos de inscrições para os quais o consentimento da Shopify sincroniza:
   • Grupos da loja inteira (obrigatório): Selecione pelo menos um grupo de e-mail e um grupo de SMS. Toda aceitação que a Braze recebe da Shopify é registrada aqui.
   • Grupos de país (opcional): Atribua um ou mais grupos a qualquer país nos seus mercados sincronizados. As aceitações também são registradas aqui quando a Braze consegue determinar o país do cliente.

Como as aceitações e recusas funcionam

Na Shopify, cada cliente tem um status de consentimento de e-mail e um status de consentimento de SMS. Quando os clientes aceitam, eles se inscrevem na sua marca, não em um país ou uma lista.

A Braze registra cada aceitação nos seus grupos da loja inteira. Se você configurar grupos de país e a Braze conseguir identificar em qual país o cliente está, a aceitação também é registrada nos grupos desse país.

Se você não configurar grupos de país, as aceitações vão apenas para os seus grupos da loja inteira, o que corresponde à forma como a Shopify lida com o consentimento hoje.

Como a Braze determina o país

Um locale identifica um país apenas quando inclui uma região, como fr-FR. Um locale apenas fr sozinho não identifica.

Para SMS, o país vem do número de telefone. O comprador precisa ser adicionado a um grupo de inscrições que possa enviar mensagens para esse número.

O que acontece quando alguém aceita

A associação ao grupo de inscrições é baseada nos eventos de consentimento da Shopify. Se o país ou locale de um comprador mudar, sua associação ao grupo não muda. A Braze só atualiza quando a Shopify envia um novo evento de consentimento, como quando o consentimento é coletado novamente do comprador na Shopify após a mudança de país ou locale.

Nota

Os grupos de país controlam o consentimento, não o idioma. Um país pode ter mais de um idioma. Clientes que falam inglês e francês no Canadá, en-CA e fr-CA, pertencem ao mesmo grupo de país. Use shopify_locale dentro das suas mensagens para especificar o idioma.

O que acontece quando alguém recusa

Uma recusa na Shopify remove o usuário de todos os grupos de inscrições atribuídos à sua integração com a Shopify. Isso funciona da mesma forma, seja a recusa feita por meio de um site de mercado ou pela página de conta da Shopify.

Grupos de inscrições no seu espaço de trabalho que não estão atribuídos à integração não são afetados.

Aceitações de países que você não configurou

Se um cliente aceitar de um país que não faz parte dos seus mercados configurados, seja porque você nunca o adicionou ou porque removeu esse mercado, ele é inscrito nos seus grupos da loja inteira. Ele não é adicionado a nenhum grupo de país.

Configurar mercados não restringe quem pode receber mensagens. Se você não puder enviar mensagens para um país por razões legais ou regulatórias, exclua esses usuários com um filtro de Segment ou direcione-os para um grupo de inscrições separado.

Dica

Crie esse Segment como uma lista de permissões dos países que você atende, não como uma lista de bloqueio dos que você não atende. Usuários cujo país não pôde ser determinado não têm valor de país, então uma lista de bloqueio não os captura.

Para SMS, as permissões de país de cada grupo de inscrições ainda controlam a entrega. Um usuário cujo país não é permitido no grupo não receberá mensagens dele.

Usuários não são adicionados a grupos de país posteriormente

Se a Braze não conseguir determinar o país de um cliente quando ele aceita, ele é adicionado apenas aos seus grupos da loja inteira. Se o país dele se tornar conhecido depois, ele não é adicionado automaticamente aos grupos desse país.

Quando você ativa o Markets em uma loja já integrada, seus grupos de inscrições existentes se tornam seus grupos da loja inteira. Os inscritos existentes permanecem inscritos nesses grupos e não são adicionados automaticamente a novos grupos de país.

Para adicioná-los manualmente, crie um Segment para esses usuários e inscreva-os usando uma etapa User Update no Canvas.

Contando inscritos entre grupos

Uma aceitação pode adicionar um usuário a mais de um grupo de inscrições, então somar os totais dos grupos conta a mesma pessoa várias vezes. Use um Segment quando precisar de uma contagem de inscritos únicos.

Como funciona

1. Um cliente se inscreve para SMS no checkout ou por meio de um formulário.
2. A Shopify envia a inscrição para a Braze.
3. A Braze define o usuário como pendente e envia seu texto de confirmação.
4. O cliente responde com sua palavra-chave de confirmação e se torna inscrito.
5. Se ele não responder antes do período de confirmação terminar, ele permanece como pendente.

Para saber mais, consulte Dupla aceitação.

Etapa 4: Sincronizar produtos

1. Para sincronizar produtos dentro do seu mercado, selecione Sync Shopify products and variants to Braze.
2. Atribua o ID do catálogo da Braze e configure quaisquer configurações adicionais.

Seu catálogo inclui uma visualização por mercado para os produtos padrão da sua loja. Para cada produto publicado no seu mercado, a Braze adiciona uma linha de mercado ao seu catálogo existente, além dos campos padrão do catálogo da Shopify já suportados. Pode levar alguns minutos para que esses dados sincronizem se você ativar o Shopify Markets em uma integração existente.

Nas linhas de mercado, esses campos têm valores específicos do mercado:

Importante

inventory_quantity não está incluído nas linhas de mercado. Aparece apenas nas linhas padrão, onde reflete o estoque total disponível para uma variante de produto em todos os locais da Shopify.

Quando você usar compare_at_price em Liquid, verifique se o valor é “0” antes de exibi-lo ou calcular um desconto. Um mercado sem preço de comparação renderiza um preço zero ou um desconto incorreto.

Etapa 5: Ativar canais

1. (Opcional) Selecione se deseja ativar o envio de mensagens no navegador.
2. Selecione Finish Setup.

Usar dados de usuário de Markets

Depois que esses atributos e propriedades estiverem nos perfis de usuário, você pode usá-los para direcionar usuários por mercado e para personalizar mensagens.

Direcionar por mercado na segmentação

Filtre por país, idioma do navegador ou shopify_locale em Segments e nos critérios de entrada de Campaign ou Canvas — por exemplo, usuários na França, ou uma jornada de Canvas por shopify_locale.

Você também pode usar filtros de Segment do Shopify Markets, que direcionam pelo mercado associado à atividade de pedidos de um comprador. Para alcançar compradores associados apenas ao seu mercado padrão, crie um Segment que exclua usuários de cada mercado não padrão que você sincroniza — por exemplo, todos que fizeram um pedido, exceto onde o mercado é igual a México.

Para seleções de produtos de catálogo por identificador de mercado (incluindo quando market_handle é default para linhas de produtos padrão), consulte Tutorial: Exibir produtos e preços por mercado.

Disparar e personalizar com Liquid

Referencie dados de mercado nas suas mensagens com essas variáveis Liquid.

Do perfil de usuário

De eventos de pedido

Exibir preços na moeda do cliente

Sempre associe um valor à sua moeda. Um valor exibido sozinho é o erro mais comum no envio de mensagens multimercado, porque “129,95” significa algo diferente em cada mercado.

Use o total do pedido para mensagens no nível do pedido, como uma confirmação, e o preço do produto para conteúdo no nível do produto, como um carrinho ou uma recomendação.

1
2

Thanks for your order! Your total: {{event_properties.${metadata}.presentment_currency.code}}
{{event_properties.${metadata}.presentment_currency.<total field>}}

Como essas propriedades acompanham o evento, a mensagem permanece precisa para o mercado de cada cliente sem configuração extra.

Verificar valores vazios

Dois valores nem sempre estarão presentes, e ambos são exibidos incorretamente quando estão ausentes.

market_handle fica vazio quando o país do cliente não corresponde a um mercado configurado. Verifique antes de criar uma ramificação com base nele:

1
2
3

{% if event_properties.${market_handle} != blank %}
  ...
{% endif %}

compare_at_price retorna 0 quando nenhum preço comparativo é resolvido para aquele mercado. Verifique se é 0 antes de exibi-lo ou calcular um desconto, ou o cliente verá um preço riscado de zero.

Exibir informações localizadas do produto

Os nomes de produtos em eventos estão no idioma padrão da sua loja. Para exibir títulos, descrições ou URLs de produtos traduzidos, consulte o produto no seu catálogo usando o ID do produto ou da variante do evento. Para ver um exemplo, consulte Tutorial: Exibir produtos e preços por mercado.

Disparar mensagens a partir de atividade de pedidos

As propriedades de mercado são incluídas nos eventos do Shopify compatíveis, então uma Campaign ou Canvas disparada por um pedido pode usá-las sem configuração extra. Esses eventos incluem country, presentment_currency e market_handle.

presentment_currency é incluído nos eventos compatíveis de checkout, pedido e reembolso, então um lembrete de checkout ou confirmação de pedido pode exibir o valor que o cliente viu. Eventos de carrinho não incluem presentment_currency, country ou market_handle. Para saber mais, consulte Moeda.

Relatórios de Markets

Importante

Clientes Shopify existentes devem usar a receita de ecommerce.order_placed para visualizar os relatórios de Markets. Para novos clientes, isso é ativado por padrão. Se você tiver dúvidas, entre em contato com sua equipe de conta.

Quando o Markets está ativado, a Braze detalha a receita e o desempenho das mensagens por país.

Receita por país

Seu relatório de receita inclui um detalhamento por país junto com o detalhamento por app, tanto para o período total quanto para um intervalo de tempo selecionado.

Cada pedido é atribuído a um país, e toda a sua receita é direcionada a esse país. O país é selecionado primeiro a partir do pedido e, em seguida, do perfil do comprador. Pedidos em que nenhum dos dois está disponível aparecem em Unknown.

A receita é exibida em USD, da mesma forma que o restante do relatório de receita. Para ver o valor que o comprador realmente pagou, use presentment_currency no evento do pedido.

Desempenho por país

As análises de Campaign e Canvas incluem uma tabela Performance by country que mostra como uma mensagem se saiu em cada país, além de uma linha de total para cada país. A moeda e a receita total são agregadas a partir do presentment_currency do pedido.

Você também pode detalhar o desempenho de Campaign e Canvas por país no Report Builder usando Countries (Shopify Markets) como linha ou detalhamento.

Remover um mercado

Remover um mercado impede a Braze de sincronizar novos dados para os países dele. Isso não exclui os dados que você já possui.

Grupos de inscrições

Remover um mercado atualiza a configuração de Mercados. Isso não exclui grupos de inscrições do seu espaço de trabalho nem remove usuários que já estão inscritos em grupos de países.

O que muda na sua configuração

• Os países do mercado removido deixam de aparecer na interface de Mercados.
• A Braze remove as atribuições de grupo de inscrições desses países da configuração da sua integração.

O que permanece igual

• Os grupos de inscrições de países continuam no seu espaço de trabalho e disponíveis para direcionamento, mas o Shopify deixa de sincronizar cancelamentos de inscrição para eles. Usuários que cancelarem a inscrição no Shopify podem continuar aparecendo como inscritos nesses grupos de países, a menos que você atualize o status de inscrição deles de outra forma — por exemplo, por meio dos endpoints de grupo de inscrições ou de um fluxo de cancelamento de inscrição na Braze.
• Usuários já inscritos nos grupos de países de um mercado removido permanecem inscritos.

Sincronização futura de consentimento

• Novas aceitações de compradores em países removidos são sincronizadas apenas para seus grupos gerais da loja, da mesma forma que aceitações de países que você não configurou.
• A Braze deixa de sincronizar novas aceitações ou cancelamentos de inscrição para os grupos de países dos países removidos.
• Os grupos de inscrições gerais da loja continuam recebendo atualizações de consentimento.

Dados de usuários

• Os atributos já presentes no perfil de um usuário, incluindo shopify_locale e country, não são alterados.
• O market_handle em novos eventos de pedido deixa de estar disponível.
• Os filtros de Segment do Shopify Market para mercados removidos deixam de estar disponíveis.
• Referências em Liquid a um mercado removido deixam de estar disponíveis.

Catálogos

• As linhas de mercado referentes a esse mercado param de ser atualizadas e são removidas do seu catálogo.
• As seleções de catálogo baseadas nessas linhas de mercado param de retornar produtos. Atualize ou remova essas seleções antes do próximo envio.
• Suas linhas padrão, e quaisquer seleções baseadas nelas, não são afetadas.

Tutorial: Mostrar produtos e preços por mercado

Use um catálogo com reconhecimento de mercados para criar uma única mensagem que mostre a cada usuário os produtos e preços do seu próprio mercado.

1. Crie uma seleção que use dados de mercados.
2. Faça referência à seleção em uma mensagem com Liquid.

Você pode usar um mercado fixo quando uma mensagem é direcionada a um mercado específico.

Etapa 1: Criar uma seleção usando dados de mercados

Seleções são conjuntos curados de produtos que você referencia em mensagens. Para catálogos Shopify com mercados sincronizados, a seção Configurações de filtro inclui uma área Escopo de mercado que limita os dados do produto a um mercado ou os personaliza por usuário.

1. Acesse seu catálogo Shopify e abra a guia Seleções.
2. Selecione Criar seleção, nomeie a seleção, adicione uma descrição opcional e defina um limite de resultados.
3. Em Configurações de filtro, em Escopo de mercado, selecione como a seleção resolve produtos específicos do mercado no dropdown Mercado:
   • Personalizado: Cada destinatário vê produtos e preços do mercado que corresponde ao atributo country do seu perfil.
   • Um mercado sincronizado: Selecione um mercado pelo nome para fixar a seleção nos produtos e preços desse mercado. Use isso quando uma mensagem é direcionada a um único mercado.
4. Conclua quaisquer critérios de filtro adicionais e salve a seleção.
5. Em Prévia para o usuário, selecione um usuário para ver o que a seleção retorna para aquele perfil. Seleções que usam Personalizado só podem ter prévia após você selecionar um usuário.

Nota

Se você não especificar um mercado, a Braze usa seus produtos padrão.

Etapa 2: Adicionar seleções de catálogo com reconhecimento de mercado às mensagens

Para exibir a cada usuário os produtos do seu próprio mercado em uma única mensagem, crie uma seleção com este filtro:

No momento do envio, a Braze substitui {{shopify_market.handle}} pelo mercado de cada usuário, de modo que market_products entrega a todos os produtos corretos. default_products é o fallback para usuários sem mercado correspondente.

Faça referência à sua seleção na mensagem com a tag {% shopify_market %}:

1
2
3
4
5
6
7
8
9
10
11
12

{% shopify_market %}
{% if shopify_market.handle %}
  {% catalog_selection_items <your_catalog_name> <your_market-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% else %}
  {% catalog_selection_items <your_catalog_name> <your_default-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% endif %}

• Coloque {% shopify_market %} antes de {% catalog_selection_items %} para que o mercado do usuário seja definido antes da execução da seleção.
• Substitua <your_catalog_name> pelo nome do seu catálogo e use seus próprios nomes de seleção, se forem diferentes.
• A verificação de {{shopify_market.handle}} direciona usuários sem mercado correspondente para default_products, garantindo que eles ainda recebam produtos em vez de uma mensagem vazia.
• Ao usar compare_at_price em Liquid, verifique se o valor é “0” antes de exibi-lo ou calcular um desconto. Um mercado sem preço de comparação renderiza um preço zero ou produz um desconto incorreto.

Visualize a prévia como um usuário do seu mercado para confirmar que a mensagem exibe os produtos, preços e títulos traduzidos daquele mercado.