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 existente com a Shopify. Conecte sua loja padrão pelo caminho de integração padrão ou personalizada (SDK). Depois, selecione, entre os mercados configurados na sua loja, quais você quer que a Braze sincronize. As integrações 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 compatíveis da Shopify, 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. 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 de um único país ou de vários países ativos. 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ê só pode conectar uma loja da Shopify com Markets ativado 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 no app Shopify Translate & Adapt, 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, incluindo títulos localizados de produtos e variantes e URLs de produtos quando as traduções são configuradas pelo 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 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: O recurso 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 a Shopify

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

• Seus grupos de inscrições passam a ser os grupos de toda a loja. Eles continuam recebendo todas as aceitações, incluindo os grupos adicionais que você atribuiu.
• Seus inscritos atuais continuam nos grupos em que já estão. Se você adicionar grupos por 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 ao catálogo existente em vez de 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á está 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 da Shopify ou a integração personalizada da Shopify. Depois que sua 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 da Shopify, selecione Sincronizar dados do Shopify Markets.
2. Selecione Selecionar mercados para escolher seu mercado e confirme que você selecionou o rastreamento de eventos comportamentais e atributos de usuário.
   • (Opcional) Ative o preenchimento retroativo do histórico

Dados de usuários do Markets

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 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 da Shopify trazem dois conjuntos de valores:

• A moeda da sua loja nos campos de preço e total existentes, 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 quanto ele pagou, como em uma confirmação de pedido ou um lembrete de checkout. Use os valores na moeda da loja quando for comparar a receita entre mercados, já que eles estão em uma única moeda.

Os eventos de carrinho do pixel da 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 ativados os eventos nativos da Shopify para os tipos de evento de que você precisa.

Informações de produtos localizadas

Os eventos da Shopify compatíveis 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.

Títulos, descrições e 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 seu catálogo usando o ID do produto ou da variante do evento.

Etapa 3: Gerencie usuários

1. Selecione seu 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 serão sincronizados.
   • Criar sua própria: Para ter mais controle sobre o gerenciamento de status, crie uma integração personalizada usando os endpoints de grupos de inscrições da Braze.
3. Selecione os grupos de inscrições para os quais o consentimento da Shopify será sincronizado:
   • Grupos de toda a loja (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 por 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 as aceitações e os cancelamentos de inscrição

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, e não em um país ou em uma lista.

A Braze registra cada aceitação nos seus grupos de toda a loja. Se você configurar grupos por 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 por país, as aceitações vão apenas para os grupos de toda a loja, o que corresponde à forma como a Shopify lida com o consentimento hoje.

Como a Braze determina o país

Um local só identifica um país quando inclui uma região, como fr-FR. Um local 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 participação em grupos de inscrições se baseia nos eventos de consentimento da Shopify. Se o país ou o local de um comprador mudar, a participação dele nos grupos não muda. A Braze só a atualiza quando a Shopify envia um novo evento de consentimento, por exemplo, quando o consentimento é coletado novamente do comprador na Shopify depois da mudança de país ou local.

Nota

Os grupos por 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 por país. Use shopify_locale nas suas mensagens para especificar o idioma.

O que acontece quando alguém cancela a inscrição

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

Os 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 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 por 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, e não como uma lista de bloqueio dos países 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 continuam controlando a entrega. Um usuário cujo país não é permitido no grupo não recebe mensagens dele.

Os usuários não são adicionados a grupos por país depois

Se a Braze não conseguir determinar o país de um cliente no momento da aceitação, 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 por 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 em 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 SMS de confirmação.
4. O cliente responde com sua palavra-chave de confirmação e passa a ser inscrito.
5. Se ele não responder antes do fim da janela 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 da 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 existente, além dos campos padrão do catálogo da Shopify já compatíveis. 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 está 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 da Shopify.

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 gera 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ário do Markets

Depois que esses atributos e propriedades estiverem nos perfis de usuário, você pode 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 em 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 do 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, 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 for default para linhas de produtos padrão), consulte Tutorial: Mostrar produtos e preços por mercado.

Dispare e personalize com Liquid

Use estas variáveis Liquid para fazer referência aos dados de mercado nas suas mensagens.

Do perfil de usuário

De 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 configuração extra.

Verifique 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 de comparação é encontrado 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 igual a zero.

Mostre informações de produtos localizadas

Os nomes de produtos nos eventos estão no idioma padrão da sua loja. Para mostrar títulos, descrições ou URLs de produtos traduzidos, procure 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 do 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 trazem presentment_currency, country nem market_handle. Para saber mais, consulte Moeda.

Relatórios de mercados

Importante

Clientes existentes da Shopify precisam usar a receita de ecommerce.order_placed para visualizar os relatórios de mercados. Para novos clientes, esse recurso já 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 o desempenho das mensagens por país.

Receita por país

Seu relatório de receita inclui um detalhamento por país junto ao 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 é identificado primeiro a partir do pedido e, depois, a partir do perfil do comprador. Pedidos sem nenhuma dessas informações aparecem em Desconhecido.

A receita é exibida em USD, assim como no 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

A análise de dados de Campaign e Canvas inclui uma tabela de Desempenho por país que mostra o desempenho de uma mensagem em cada país, com 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 campanhas e Canvas por país no Criador de relatórios usando Países (Shopify Markets) como linha ou detalhamento.

Remover um mercado

Quando você remove 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 sua configuração de Markets. Essa ação 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 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 dos países continuam no seu espaço de trabalho e disponíveis para direcionamento, mas a Shopify deixa de sincronizar cancelamentos de inscrição com eles. Usuários que cancelam a inscrição na 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, 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 seus grupos de toda a loja, assim como acontece com 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 dos países removidos.
• Os grupos de inscrições de toda a loja 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 nos novos eventos de pedido deixa de estar disponível.
• Os filtros de Segment de 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 de mercado 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.
• Suas linhas padrão, e todas 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 for 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 do Shopify com mercados sincronizados, a seção Configurações de filtro inclui uma área Escopo de mercado. Ela limita os dados de produtos a um mercado ou os personaliza para cada usuário.

1. Acesse seu catálogo do Shopify e abra a guia Seleções.
2. Selecione Criar seleção. Em seguida, 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 de 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 dele.
   • 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 uma 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. Só é possível ver a prévia de seleções que usam Personalizado depois de selecionar 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 todos os usuários 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 todos. 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 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 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 de comparação exibe um preço igual a zero ou gera um desconto incorreto.

Veja a 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.