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 amplia sua integração atual com a Shopify. Conecte sua loja padrão pela jornada de integração padrão ou personalizada (SDK). Depois, selecione, entre os mercados configurados na sua loja, quais você quer que a Braze sincronize. Integrações já existentes podem adicionar mercados sem afetar catálogos, grupos de inscrições ou eventos. Para ver as instruções passo a passo, consulte Configuração do Shopify Markets.

O Shopify Markets oferece estes recursos:

• Perfis com reconhecimento de mercado: A integração captura a localidade da Shopify de cada usuário, junto com os atributos padrão de país e idioma da Braze. Assim, você pode segmentar e disparar mensagens 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 com reconhecimento de mercado: Use a Liquid tag {% shopify_market %} para personalizar mensagens com produtos do catálogo do mercado de cada usuário, incluindo o conteúdo traduzido da Shopify. Você também pode referenciar detalhes do mercado, como a moeda de apresentação, a partir de eventos da Shopify compatíveis, como ecommerce.order_placed.
• Fallback para a loja padrão: Quando um usuário não pertence a nenhum dos mercados conectados, a Braze usa as configurações e os produtos da sua loja padrão. Dessa forma, todos os usuários recebem uma mensagem completa e precisa.

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

Tipos de mercado da Shopify compatíveis

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

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

Do que cada mercado precisa

Cada mercado selecionado precisa de um catálogo de mercado com produtos ativos. A Braze lê os seguintes dados desse catálogo:

Considerações

Geral

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

Catálogo de mercado

• Novas visualizações de mercado no seu catálogo original da Shopify: O Markets não cria catálogos separados. Em vez disso, a Braze mostra os mercados como parte do seu catálogo original da Shopify. Os dados do Markets são adicionados como novas linhas ao seu catálogo da Shopify.
• Seleções de catálogo: Até 30 seleções de catálogo.
• Frequência de atualização: Os dados de produtos 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, além dos títulos localizados de produtos e variantes e dos URLs dos produtos, quando as traduções são configuradas pelo app Translate & Adapt da Shopify.
• Queda de preço: Compatível com catálogos de mercado. Uma mudança de preço em um catálogo de mercado dispara com base no preço desse mercado, e não no preço padrão da sua loja. Como os dados de produtos do catálogo de mercado são atualizados uma vez por dia, as quedas de preço são detectadas diariamente, e não no momento em que o preço muda na Shopify.
• De volta ao estoque: A notificação de de volta ao estoque é compatível com produtos do catálogo padrão da sua loja. As linhas de mercado não disparam notificações de volta ao estoque. Esse recurso considera o estoque total disponível de uma variante de produto em todos os locais da Shopify. Portanto, um 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 o Shopify

O Markets complementa sua integração atual. Não é preciso desconectá-la nem refazer sua configuração.

• Seus grupos de inscrições passam a ser os grupos de toda a loja e continuam recebendo todas as aceitações, incluindo quaisquer grupos adicionais que você tenha atribuído.
• Seus inscritos atuais permanecem nos grupos em que já estão. Se você adicionar grupos de país depois, a Braze não adiciona os inscritos atuais a eles.
• Seu catálogo continua sincronizando. As linhas de mercado são adicionadas a ele, e não a um novo catálogo. Suas seleções atuais continuam funcionando com as linhas padrão.
• Sua loja padrão aparece junto com os mercados selecionados. Assim, você pode atribuir grupos de inscrições e criar seleções de catálogo para ela da mesma forma.

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

Etapa 1: Conecte sua loja com o Shopify Markets ativado

1. Conecte sua loja usando a integração padrão do Shopify ou a integração personalizada do Shopify. Depois que a loja estiver conectada, configure o Shopify Markets no criador de configuração.
2. Conclua o fluxo OAuth e confirme que a Braze solicita os escopos de mercados no OAuth:
   • read_markets
   • read_publications
   • read_locales
3. Depois que a autorização for concluída e o criador de configuração abrir, selecione Iniciar configuração.
4. Ative os SDKs da Braze.

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

1. Em Rastrear dados do Shopify, selecione Sincronizar dados do Shopify Markets.
2. Selecione Selecionar mercados para escolher seu mercado e confira se você selecionou o rastreamento de eventos comportamentais e atributos de usuário.
   • (Opcional) Ative o preenchimento retroativo de histórico

Dados de usuários do Markets

Para oferecer 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 funcionam essas propriedades de eventos de mercado

Moeda

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

• A moeda da sua loja nos campos atuais de preço e total, sem alterações
• O objeto presentment_currency, com 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 quiser mostrar 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 para comparar a receita entre mercados, já que eles estão em uma única moeda.

Os eventos de carrinho do pixel do Shopify não incluem presentment_currency. Eventos personalizados de checkout e compra enviados por uma CDP, como a Segment, também não o incluem. 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 do Shopify ativados para os tipos de evento de que você precisa.

Informações de produtos localizadas

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

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

Etapa 3: Gerencie usuários

1. Selecione o tipo de external_id no menu suspenso.
2. Ative as aceitações de e-mail, SMS e WhatsApp do Shopify. Isso permite que a Braze sincronize os estados de inscrição de e-mail, SMS e WhatsApp do Shopify. Você tem duas opções:
   • Usar a integração: A Braze sincroniza os estados de e-mail, SMS e WhatsApp. Selecione os grupos de inscrições com os quais eles serão sincronizados. Os grupos de WhatsApp só ficam disponíveis quando seu espaço de trabalho tem uma conta do WhatsApp Business conectada.
   • Criar a sua própria: Para ter mais controle sobre o gerenciamento de estados, crie uma integração personalizada usando os endpoints de grupos de inscrições da Braze.
3. Selecione os grupos de inscrições com os quais o consentimento do Shopify será sincronizado:
   • Grupos de toda a loja (obrigatório): Selecione pelo menos um grupo para cada canal que você ativar. Todas as aceitações que a Braze recebe do Shopify são registradas aqui.
   • Grupos de país (opcional): Atribua um ou mais grupos a qualquer país dos seus mercados sincronizados. As aceitações também são registradas aqui quando a Braze consegue determinar o país do cliente.

Como funcionam aceitações e cancelamentos

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

A Braze registra cada aceitação nos seus grupos de toda a loja. Se você configurar grupos de país e a Braze conseguir identificar em que 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 grupos de toda a loja, que é como o Shopify lida com o consentimento hoje.

Como a Braze determina o país

Uma localidade só identifica um país quando inclui uma região, como fr-FR. Uma localidade fr sozinha não identifica.

No SMS e no WhatsApp, 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 participação em grupos de inscrições é baseada nos eventos de consentimento do Shopify. Se o país ou a localidade de um comprador mudar, a participação dele nos grupos não muda. A Braze só a atualiza quando o Shopify envia um novo evento de consentimento, por exemplo, se o consentimento for coletado novamente do comprador no Shopify depois da mudança de país ou localidade.

Nota

Os grupos de país controlam o consentimento, não o idioma. Um país pode ter mais de um idioma. Clientes de língua inglesa e francesa no Canadá, en-CA e fr-CA, pertencem ao mesmo grupo de país. Use shopify_locale nas suas mensagens para especificar o idioma.

O que acontece quando alguém cancela

Um cancelamento no Shopify remove o usuário de todos os grupos de inscrições atribuídos à sua integração com o Shopify. Isso vale tanto para cancelamentos feitos em um site de mercado quanto na página da conta do Shopify.

Grupos de inscrições do 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 a partir 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 de toda a loja. Ele não é adicionado a nenhum grupo de país.

Configurar mercados não restringe quem pode receber mensagens. Se você não pode enviar mensagens para um país por motivos legais ou regulatórios, 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, e 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 vai pegá-los.

No SMS, as permissões de país de cada grupo de inscrições continuam controlando 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 depois

Se a Braze não conseguir determinar o país de um cliente quando ele aceitar, ele é adicionado apenas aos seus grupos de toda a loja. Se o país dele for identificado depois, ele não é adicionado automaticamente aos grupos desse país.

Quando você ativa o Markets em uma loja que já tem integração, seus grupos de inscrições atuais passam a ser os grupos de toda a loja. Os inscritos atuais continuam inscritos nesses grupos e não são adicionados automaticamente aos novos grupos de país.

Para adicioná-los manualmente, crie um Segment com esses usuários e inscreva-os usando uma etapa de Atualização de usuário do Canvas.

Contagem de inscritos entre grupos

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

Como funciona

1. Um cliente se inscreve no SMS durante o checkout ou por meio de um formulário.
2. O 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 passa a ficar inscrito.
5. Se ele não responder antes do fim do período de confirmação, continua pendente.

Para saber mais, consulte Aceitação dupla.

Etapa 4: Sincronize produtos

1. Para sincronizar produtos no seu mercado, selecione Sincronizar produtos e variantes do Shopify com a Braze.
2. Atribua o ID do catálogo da Braze e defina as configurações adicionais.

Seu catálogo inclui uma visualização por mercado dos produtos padrão da sua loja. Para cada produto publicado no seu mercado, a Braze adiciona uma linha de mercado ao seu catálogo atual, além dos campos padrão do catálogo do Shopify já suportados. Se você ativar o Shopify Markets em uma integração existente, a sincronização dessas linhas pode levar alguns minutos.

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

Importante

inventory_quantity não é incluído nas linhas de mercado. Ele aparece apenas nas linhas padrão, onde reflete o estoque total disponível de uma variante de produto em todos os locais do Shopify.

Ao usar compare_at_price no Liquid, verifique se o valor é “0” antes de exibi-lo ou calcular um desconto. Um mercado sem preço comparativo exibe um preço zero ou um desconto incorreto.

Etapa 5: Ative os canais

1. (Opcional) Selecione se deseja ativar o envio de mensagens no navegador.
2. Selecione Concluir configuração.

Use os dados de usuários do Markets

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

Direcione por mercado na segmentação

Filtre por país, idioma do navegador ou shopify_locale nos Segments e nos critérios de entrada de Campaigns ou Canvas. Por exemplo, você pode direcionar usuários na França ou criar uma jornada de Canvas por shopify_locale.

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

Para seleções de produtos do catálogo por identificador de mercado (inclusive quando market_handle é default nas linhas de produto padrão), consulte Tutorial: Mostrar produtos e preços por mercado.

Dispare e personalize com Liquid

Faça referência aos dados de mercado nas suas mensagens com estas variáveis Liquid.

Do perfil de usuário

Dos eventos de pedido

Mostre os preços na moeda do cliente

Sempre combine um valor com o código da moeda. Mostrar um valor sozinho é o erro mais comum no envio de mensagens para vários mercados, porque “129,95” significa algo diferente em cada mercado.

Use o total do pedido em mensagens sobre o pedido, como uma confirmação. Use o preço do produto em conteúdos sobre produtos, 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 continua precisa para o mercado de cada cliente sem nenhuma configuração extra.

Verifique se há valores vazios

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

market_handle fica vazio quando o país do cliente não corresponde a um mercado configurado. Faça essa verificação antes de criar ramificações com base nele:

1
2
3

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

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

Mostre informações de produtos localizadas

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

Dispare mensagens a partir da atividade de pedidos

As propriedades de mercado são incluídas nos eventos compatíveis da Shopify. Assim, uma Campaign ou um Canvas disparado 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. Assim, um lembrete de checkout ou uma confirmação de pedido pode mostrar o valor que o cliente viu. Os eventos de carrinho não incluem presentment_currency, country nem market_handle. Para saber mais, consulte Moeda.

Relatórios de Markets

Importante

Clientes existentes da Shopify precisam usar a receita de ecommerce.order_placed para visualizar os relatórios de Markets. Para novos clientes, esse recurso vem ativado por padrão. Em caso de dúvidas, entre em contato com a equipe da sua conta.

Quando o Markets está ativado, a Braze detalha a receita e a performance 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 único país, e toda a receita dele vai para esse país. O país é definido primeiro a partir do pedido e, depois, a partir do perfil do comprador. Pedidos sem nenhuma dessas informações aparecem em Unknown.

A receita é exibida em USD, assim como no restante do relatório de receita. Para ver quanto um comprador realmente pagou, use presentment_currency no evento do pedido.

Performance por país

A análise de dados de Campaign e Canvas inclui uma tabela Performance by country, que mostra a performance de uma mensagem em cada país. Cada linha é uma combinação de país e moeda. A moeda e a receita total vêm do campo presentment_currency do pedido.

A linha Total soma apenas a coluna Total Purchases. A coluna Total Revenue fica em branco na linha de total, porque as linhas podem usar moedas diferentes e não são somadas.

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

Remover um mercado

Ao remover um mercado, a Braze para de sincronizar novos dados dos países desse mercado. Os dados que você já tem não são excluídos.

Grupos de inscrições

Remover um mercado atualiza a sua configuração de Markets. Os grupos de inscrições não são excluídos do seu espaço de trabalho, e os usuários que já estão inscritos nos grupos de países não são removidos.

O que muda na sua configuração

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

O que continua 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 com eles. Usuários que cancelarem a inscrição no Shopify ainda podem aparecer como inscritos nesses grupos de países, a menos que você atualize o status de inscrição deles de outra forma. Por exemplo, você pode usar os endpoints de grupos de inscrições ou um fluxo de cancelamento de inscrição na Braze.
• Usuários que já estão inscritos nos grupos de países de um mercado removido continuam inscritos.

Sincronização futura de consentimento

• Novas aceitações de clientes dos países removidos são sincronizadas apenas com os grupos da loja inteira, assim como as aceitações de países que você não configurou.
• A Braze deixa de sincronizar novas aceitações ou cancelamentos de inscrição com os grupos de países removidos.
• Os grupos de inscrições da loja inteira continuam recebendo atualizações de consentimento.

Dados de usuários

• Os atributos que já estão no perfil do usuário, incluindo shopify_locale e country, não mudam.
• O market_handle deixa de estar disponível nos novos eventos de pedido.
• Os filtros de Segment do Shopify Market para mercados removidos deixam de estar disponíveis.
• O Liquid que faz referência a um mercado removido deixa de estar disponível.

Catálogos

• As linhas desse mercado param de ser atualizadas e são removidas do seu catálogo.
• As seleções de catálogo criadas com base nessas linhas de mercado deixam de retornar produtos. Atualize ou remova essas seleções antes do próximo envio.
• As linhas padrão e as seleções criadas com base 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 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

As seleções são conjuntos de produtos curados que você referencia nas mensagens. Para catálogos da Shopify com mercados sincronizados, a seção Configurações de filtro inclui uma área Escopo do mercado. Essa área limita os dados de produtos a um mercado ou os personaliza para cada usuário.

1. Acesse seu catálogo da Shopify e abra a guia Seleções.
2. Selecione Criar seleção. Depois, dê um nome à seleção, adicione uma descrição opcional e defina um limite de resultados.
3. Em Configurações de filtro, na área Escopo do mercado, selecione no menu suspenso Mercado como a seleção resolve os produtos específicos de cada mercado:
   • Personalizado: Cada destinatário vê os produtos e preços do mercado que corresponde ao atributo country do perfil.
   • Um mercado sincronizado: Selecione um mercado pelo nome para fixar a seleção nos produtos e preços desse mercado. Use essa opção quando a mensagem for direcionada a um único mercado.
4. Conclua os 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 esse perfil. Seleções que usam Personalizado só podem ser visualizadas depois que você seleciona um usuário.

Nota

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

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

Para mostrar a cada usuário os produtos do 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. Assim, market_products mostra os produtos certos para todo mundo. default_products é o fallback para usuários sem um mercado correspondente.

Faça referência à 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 de a seleção ser executada.
• Substitua <your_catalog_name> pelo seu catálogo e use os nomes das suas seleções, se forem diferentes.
• A verificação de {{shopify_market.handle}} direciona usuários sem um mercado correspondente para default_products. Assim, eles ainda recebem produtos em vez de uma mensagem vazia.
• Ao usar compare_at_price no Liquid, verifique se o valor é “0” antes de exibi-lo ou calcular um desconto. Um mercado sem preço comparativo exibe um preço zero ou gera um desconto incorreto.

Faça uma prévia como um usuário do seu mercado para confirmar que a mensagem mostra os produtos, os preços e os títulos traduzidos desse mercado.