Passer au contenu

Shopify Markets

Cet article couvre l’intégration Shopify Markets, y compris ce qui est inclus, comment elle fonctionne et comment utiliser vos données de marchés dans vos communications.

Fonctionnement de l’intégration

Shopify Markets étend votre intégration Shopify existante. Connectez votre vitrine par défaut via le parcours d’intégration standard ou personnalisé (SDK), puis sélectionnez les marchés que vous souhaitez synchroniser avec Braze parmi les marchés configurés dans votre boutique. Les intégrations existantes peuvent ajouter des marchés sans perturber les catalogues, les groupes d’abonnement ou les événements. Pour des instructions détaillées, consultez Configuration de Shopify Markets.

Shopify Markets offre les fonctionnalités suivantes :

  • Profils contextualisés par marché : l’intégration capture la locale Shopify de chaque utilisateur ainsi que les attributs standard de pays et de langue de Braze, ce qui vous permet de segmenter et de déclencher des messages par marché sans configuration personnalisée.
  • Catalogues localisés : les données produits spécifiques à chaque marché sont synchronisées quotidiennement, y compris les prix et la devise, ainsi que les titres, descriptions et URL de produits traduits.
  • Personnalisation contextuelle par marché : utilisez l’étiquette Liquid {% shopify_market %} pour personnaliser vos messages avec les produits du catalogue correspondant au marché de chaque utilisateur, y compris le contenu traduit par Shopify. Vous pouvez également référencer les détails du marché, comme la devise de présentation, à partir des événements Shopify pris en charge tels que ecommerce.order_placed.
  • Repli sur la boutique par défaut : lorsqu’un utilisateur n’appartient à aucun de vos marchés connectés, Braze utilise les paramètres et les produits de votre boutique par défaut, afin que chaque utilisateur reçoive un message complet et exact.

Pour des exemples, consultez Utiliser les données utilisateur Markets et Tutoriel : afficher les produits et les prix par marché.

Types de marchés Shopify pris en charge

Vous pouvez sélectionner jusqu’à 25 marchés actifs mono-pays ou multi-pays. Chaque pays ne peut appartenir qu’à un seul marché sélectionné.

Les marchés de sous-régions, les marchés de détail, les marchés B2B et les marchés de canaux ne sont pas pris en charge.

Ce dont chaque marché a besoin

Chaque marché sélectionné nécessite un catalogue de marché avec des produits actifs. Braze lit les informations suivantes à partir de ce catalogue :

Données Description
Prix Définis dans le catalogue de marché, dans la devise spécifiée pour ce marché. Le paramètre « Utiliser les devises locales » de Shopify n’est pas pris en charge.
Traductions Traductions adaptées réalisées via l’application Shopify Translate & Adapt, comme le titre du produit et le titre de la variante. Braze ne prend actuellement pas en charge les paramètres linguistiques spécifiques aux marchés.

Profil de marché Shopify pour un marché Australie.

Considérations

Général

  • Un seul store connecté : vous ne pouvez connecter qu’un seul store Shopify avec Markets activé à un espace de travail Braze à la fois.
  • Portée des locales : les locales récupèrent les titres et descriptions de produits traduits en fonction de ce que vous avez configuré via l’application Shopify Translate & Adapt, ainsi que les URL spécifiques aux locales. Le prix, la devise et les autres champs partagés du catalogue restent identiques pour toutes les locales au sein d’un marché. Par défaut, Braze utilise la langue par défaut de chaque marché, c’est-à-dire la locale principale que Shopify attribue à ce marché. Si vous activez la prise en charge étendue des locales, Braze synchronise les locales supplémentaires configurées pour ce marché.

Catalogue de marché

  • Nouvelles vues de marché dans votre catalogue Shopify d’origine : Markets ne crée pas de catalogues distincts. Au lieu de cela, Braze les affiche comme faisant partie de votre catalogue Shopify d’origine. Les données de marchés sont ajoutées sous forme de nouvelles lignes de catalogue à votre catalogue Shopify.
  • Sélections de catalogue : jusqu’à 30 sélections de catalogue.
  • Fréquence d’actualisation : les données produits du catalogue de marché sont actualisées une fois par jour.
  • Prix de marché et contenu localisé : les lignes de marché incluent le prix du marché et le compare_at_price, y compris les titres de produits et de variantes localisés ainsi que les URL de produits lorsque les traductions sont configurées via l’application Shopify Translate & Adapt.
  • Quantité en stock : les lignes de marché incluent des valeurs de stock agrégées. Braze ne permet actuellement pas de différencier le stock entre les emplacements.
  • Baisse de prix : prise en charge pour les catalogues de marché. Un changement de prix dans un catalogue de marché se déclenche sur le prix de ce marché plutôt que sur le prix par défaut de votre store. Étant donné que les données produits du catalogue de marché sont actualisées une fois par jour, les baisses de prix sont détectées quotidiennement plutôt qu’au moment où le prix change dans Shopify.
  • Retour en stock : la fonctionnalité Retour en stock est prise en charge pour les produits de votre catalogue de store par défaut. Les lignes de marché ne déclenchent pas de notifications de retour en stock. Le retour en stock examine le stock total disponible pour une variante de produit dans tous les emplacements Shopify, de sorte que du stock ajouté dans un point de vente peut déclencher une notification.

Configuration de Shopify Markets

Si vous avez déjà une intégration Shopify active

Markets s’ajoute à votre intégration actuelle. Vous n’avez pas besoin de la déconnecter ni de reconstruire votre configuration.

  • Vos groupes d’abonnement deviennent vos groupes à l’échelle de la boutique et continuent de recevoir chaque abonnement, y compris les groupes supplémentaires que vous avez assignés.
  • Vos abonnés existants restent dans les groupes auxquels ils appartiennent déjà. Si vous ajoutez des groupes par pays ultérieurement, Braze n’y ajoute pas les abonnés existants.
  • Votre catalogue continue de se synchroniser. Les lignes de marché y sont ajoutées plutôt que dans un nouveau catalogue, et vos sélections existantes continuent de fonctionner avec vos lignes par défaut.
  • Votre boutique par défaut apparaît aux côtés de vos marchés sélectionnés, vous permettant d’assigner des groupes d’abonnement et de créer des sélections de catalogue de la même manière.

Si votre boutique est déjà connectée, commencez à l’étape 2 pour en savoir plus sur chaque configuration et son fonctionnement.

Étape 1 : Connecter votre boutique Shopify compatible Markets

  1. Connectez votre boutique en utilisant soit l’intégration standard Shopify, soit l’intégration personnalisée Shopify. Une fois votre boutique connectée, configurez Shopify Markets dans l’assistant de configuration.
  2. Complétez le flux OAuth et confirmez que Braze demande les scopes Markets dans l’OAuth :
    • read_markets
    • read_publications
    • read_locales
  3. Une fois l’autorisation réussie et l’assistant de configuration ouvert, sélectionnez Begin Setup.
  4. Activez les SDK Braze.

Étape 2 : Sélectionner les données utilisateur de votre marché

  1. Dans Track Shopify Data, sélectionnez Sync Shopify Markets data.
  2. Sélectionnez Select Markets pour choisir votre marché, et assurez-vous d’avoir sélectionné le suivi des événements comportementaux et des attributs utilisateur.
    • (Facultatif) Activez le remplissage historique

Données utilisateur des marchés

Pour prendre en charge Shopify Markets, Braze synchronise des données supplémentaires au-delà des événements et attributs standard de l’intégration.

Attributs du profil utilisateur
Attribut Type de données Description Source des données
shopify_locale Attribut personnalisé La langue dans laquelle le client navigue sur votre boutique, par exemple en ou fr-CA. Elle change lorsqu’il change de langue de vitrine. Locale du client Shopify
browser_language Attribut standard La langue définie dans le navigateur du client. SDK Braze
country Attribut standard Le pays du client. SDK Braze
Propriétés d’événement de commande
Propriété Description Source des données
country Code pays à deux lettres du client. L’adresse par défaut (default_address) du client dans Shopify, ou l’adresse de livraison (shipping_address) de la commande si aucune adresse par défaut n’est définie
presentment_currency La devise dans laquelle le client a payé, qui peut différer de la devise de votre boutique. Devise de présentation de la commande Shopify
market_handle Identifiant du marché correspondant au pays du client. Vide lorsqu’aucun marché configuré ne correspond. Braze, à partir de votre configuration de marché

Ces propriétés sont ajoutées aux :

  • Événements eCommerce recommandés : ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
  • Événements personnalisés : shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order
Fonctionnement des propriétés d’événement de marché
Propriété Fonctionnement
market_handle market_handle est l’identifiant que vous avez donné au marché dans Shopify, par exemple france. Le même identifiant préfixe les ID de lignes de marché dans votre catalogue, par exemple france_46714756268231. Il est vide lorsque vous n’avez pas configuré de marchés, ou lorsque le pays de la commande ne correspond à aucun marché configuré. Vérifiez donc qu’il n’est pas vide avant de l’utiliser dans du Liquid ou un filtre de Segment.
country country provient de l’adresse par défaut du client et utilise l’adresse de livraison (shipping_address) si l’adresse par défaut n’existe pas. Par exemple, un client en France qui envoie une commande au Japon conserve le marché France.
Propriétés d’événement Les propriétés d’événement sont un instantané du moment où l’événement s’est produit et ne changent pas par la suite. Si un client met à jour son adresse par défaut plus tard, les nouveaux événements utilisent son nouveau pays tandis que les événements passés conservent le pays avec lequel ils ont été enregistrés.
Devise

Les événements Shopify de panier, de passage en caisse et de commande pris en charge comportent deux ensembles de valeurs :

  • La devise de votre boutique dans les champs de prix et de total existants, inchangée
  • L’objet presentment_currency contenant les montants que le client a vus et payés

Utilisez presentment_currency lorsque vous montrez à un client ce qu’il a payé, par exemple dans une confirmation de commande ou un message de panier abandonné. Utilisez les valeurs de devise de la boutique lorsque vous comparez les revenus entre les marchés, puisqu’elles sont déjà dans une devise unique.

Informations produit localisées

Les événements Shopify pris en charge contiennent les titres de produit et de variante dans la langue par défaut de votre boutique. Braze ne traduit pas les payloads d’événements.

Les titres traduits, les descriptions et les URL de produit se trouvent sur les lignes de marché de votre catalogue. Pour afficher des informations produit localisées dans un message, recherchez le produit dans votre catalogue en utilisant l’ID de produit ou de variante provenant de l’événement.

Étape 3 : Gérer les utilisateurs

  1. Sélectionnez votre type d’external_id dans le menu déroulant.
  2. Activez les abonnements par e-mail et SMS depuis Shopify, ce qui permet à Braze de synchroniser les états d’abonnement par e-mail et SMS depuis Shopify. Vous avez deux options :
    • Utiliser l’intégration : Braze synchronise les états d’e-mail et de SMS. Sélectionnez les groupes d’abonnement vers lesquels ils se synchronisent.
    • Créer la vôtre : Pour un meilleur contrôle de la gestion des états, créez une intégration personnalisée en utilisant les endpoints de groupes d’abonnement de Braze.
  3. Sélectionnez les groupes d’abonnement vers lesquels le consentement Shopify se synchronise :
    • Groupes à l’échelle de la boutique (obligatoires) : Sélectionnez au moins un groupe e-mail et un groupe SMS. Chaque abonnement reçu par Braze depuis Shopify est enregistré ici.
    • Groupes par pays (facultatifs) : Assignez un ou plusieurs groupes à n’importe quel pays de vos marchés synchronisés. Les abonnements sont également enregistrés ici lorsque Braze peut déterminer le pays du client.

Fonctionnement des abonnements et désabonnements

Dans Shopify, chaque client a un état de consentement pour l’e-mail et un pour le SMS. Lorsque les clients s’abonnent, ils s’abonnent à votre marque, pas à un pays ni à une liste.

Braze enregistre chaque abonnement dans vos groupes à l’échelle de la boutique. Si vous configurez des groupes par pays et que Braze peut déterminer le pays du client, l’abonnement est également enregistré dans les groupes de ce pays.

Si vous ne configurez pas de groupes par pays, les abonnements vont uniquement dans vos groupes à l’échelle de la boutique, ce qui correspond à la façon dont Shopify gère le consentement aujourd’hui.

Comment Braze détermine le pays

Canal Détermination du pays
E-mail Utilise d’abord la locale Shopify du client ; si elle n’est pas disponible, utilise l’attribut pays de son profil Braze.
SMS Utilise le pays du numéro de téléphone, déterminé par les modèles de routage par pays E.164.

Une locale identifie un pays uniquement lorsqu’elle inclut une région, par exemple fr-FR. Une locale de type fr seule ne le permet pas.

Pour le SMS, le pays provient du numéro de téléphone. L’acheteur doit être ajouté à un groupe d’abonnement capable d’envoyer des messages à ce numéro.

Ce qui se passe lorsqu’une personne s’abonne

Statut du pays Groupes à l’échelle de la boutique Groupes par pays
Déterminé et configuré dans vos marchés Abonné Abonné aux groupes de ce pays
Ne peut pas être déterminé Abonné Non abonné
Déterminé, mais non configuré dans vos marchés Abonné Non abonné

L’appartenance au groupe d’abonnement est basée sur les événements de consentement provenant de Shopify. Si le pays ou la locale d’un acheteur change, son appartenance au groupe ne change pas. Braze ne la met à jour que lorsque Shopify envoie un nouvel événement de consentement, par exemple si le consentement est recueilli à nouveau auprès de l’acheteur sur Shopify après que le pays ou la locale a changé.

Ce qui se passe lorsqu’une personne se désabonne

Un désabonnement dans Shopify retire l’utilisateur de chaque groupe d’abonnement assigné à votre intégration Shopify. C’est le même résultat, que le désabonnement ait eu lieu via un site de marché ou via la page de compte Shopify.

Les groupes d’abonnement de votre espace de travail qui ne sont pas assignés à l’intégration ne sont pas affectés.

Abonnements depuis des pays que vous n’avez pas configurés

Si un client s’abonne depuis un pays qui ne fait pas partie de vos marchés configurés, que vous ne l’ayez jamais ajouté ou que vous ayez supprimé ce marché, il s’abonne à vos groupes à l’échelle de la boutique. Il n’est ajouté à aucun groupe par pays.

Configurer des marchés ne restreint pas les personnes auxquelles vous pouvez envoyer des messages. Si vous ne pouvez pas envoyer de messages à un pays pour des raisons juridiques ou réglementaires, excluez ces utilisateurs avec un filtre de Segment ou redirigez-les vers un groupe d’abonnement séparé.

Pour le SMS, les autorisations par pays de chaque groupe d’abonnement contrôlent toujours la distribution. Un utilisateur dont le pays n’est pas autorisé dans le groupe ne recevra pas de messages de celui-ci.

Les utilisateurs ne sont pas ajoutés aux groupes par pays ultérieurement

Si Braze ne peut pas déterminer le pays d’un client au moment de son abonnement, il est ajouté uniquement à vos groupes à l’échelle de la boutique. Si son pays devient connu ultérieurement, il n’est pas automatiquement ajouté aux groupes de ce pays.

Lorsque vous activez Markets sur une boutique déjà intégrée, vos groupes d’abonnement existants deviennent vos groupes à l’échelle de la boutique. Les abonnés existants restent abonnés à ces groupes et ne sont pas automatiquement ajoutés aux nouveaux groupes par pays.

Pour les ajouter vous-même, créez un Segment pour ces utilisateurs et abonnez-les en utilisant une étape Canvas User Update.

Compter les abonnés entre les groupes

Un seul abonnement peut ajouter un utilisateur à plus d’un groupe d’abonnement, donc additionner les totaux des groupes compte la même personne plusieurs fois. Utilisez un Segment lorsque vous avez besoin d’un décompte d’abonnés uniques.

Fonctionnement

  1. Un client s’abonne au SMS lors du passage en caisse ou via un formulaire.
  2. Shopify envoie l’abonnement à Braze.
  3. Braze définit l’utilisateur en attente et envoie votre texte de confirmation.
  4. Le client répond avec votre mot-clé de confirmation et devient abonné.
  5. S’il ne répond pas avant la fin de la fenêtre de confirmation, il reste en attente.

Pour plus d’informations, consultez Double abonnement.

Étape 4 : Synchroniser les produits

  1. Pour synchroniser les produits de votre marché, sélectionnez Sync Shopify products and variants to Braze.
  2. Assignez l’ID de catalogue Braze et configurez les paramètres supplémentaires.

Votre catalogue inclut une vue par marché pour les produits par défaut de votre boutique. Pour chaque produit publié sur votre marché, Braze ajoute une ligne de marché à votre catalogue existant, en plus des champs de catalogue Shopify standard déjà pris en charge. La synchronisation peut prendre quelques minutes si vous activez Shopify Markets sur une intégration existante.

Sur les lignes de marché, ces champs ont des valeurs spécifiques au marché :

Champ Description
id Un ID composite préfixé par l’identifiant du marché, par exemple france_46714756268231. Les lignes par défaut conservent leurs ID d’article originaux.
market_handle L’identifiant que vous avez donné au marché dans Shopify, par exemple france.
locale La locale du marché, qui détermine la langue du contenu traduit.
price Le prix spécifique au marché provenant de la tarification contextuelle du marché, après application des ajustements de liste de prix.
compare_at_price Le prix comparatif spécifique au marché après ajustements. Braze renvoie 0 lorsqu’aucun prix comparatif ne peut être résolu pour ce marché, y compris lorsque la liste de prix du marché est configurée pour annuler les prix comparatifs.
product_title et variant_title Les titres traduits, lorsque des traductions sont configurées via l’application Shopify Translate & Adapt.
product_url L’URL du produit pour ce marché.

Étape 5 : Activer les canaux

  1. (Facultatif) Sélectionnez si vous souhaitez activer la messagerie dans le navigateur.
  2. Sélectionnez Finish Setup.

Utiliser les données utilisateur Markets

Une fois ces attributs et propriétés présents sur les profils utilisateur, vous pouvez les utiliser pour cibler les utilisateurs par marché et personnaliser les messages.

Cibler par marché dans la segmentation

Filtrez par pays, langue du navigateur ou shopify_locale dans les Segments et dans les critères d’entrée de Campaign ou de Canvas. Par exemple, constituez une audience d’utilisateurs sur un marché spécifique, ou divisez un Canvas par langue/région.

Déclencher et personnaliser avec Liquid

Référencez les données de marché dans vos messages à l’aide de ces variables Liquid.

Depuis le profil utilisateur

Attribut Liquid
La langue du client {{custom_attribute.${shopify_locale}}}
Le pays du client {{${country}}}

Depuis les événements de commande

Propriété d’événement Liquid
Le pays de la commande {{event_properties.${country}}}
Le marché de la commande {{event_properties.${market_handle}}}
La devise dans laquelle le client a payé {{event_properties.${metadata}.presentment_currency.code}}
Le total de la commande dans cette devise {{event_properties.${metadata}.presentment_currency.<total_value>}}

Afficher les prix dans la devise du client

Associez toujours un montant à son code de devise. Un montant affiché seul est l’erreur la plus courante dans les communications multi-marchés, car « 129,95 » signifie quelque chose de différent sur chaque marché.

Utilisez le total de la commande pour les messages au niveau de la commande, comme une confirmation, et le prix du produit pour le contenu au niveau du produit, comme un panier ou une recommandation.

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

Comme ces propriétés accompagnent l’événement, le message reste exact pour le marché de chaque client sans configuration supplémentaire.

Vérifier les valeurs vides

Deux valeurs ne seront pas toujours présentes, et toutes deux s’affichent incorrectement lorsqu’elles sont manquantes.

market_handle est vide lorsque le pays du client ne correspond à aucun marché configuré. Vérifiez avant de créer une branche conditionnelle :

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

compare_at_price renvoie 0 lorsqu’aucun prix de comparaison ne correspond à ce marché. Vérifiez la valeur 0 avant de l’afficher ou de calculer une remise, sinon le client verra un prix barré de zéro.

Afficher des informations produit localisées

Les noms de produits dans les événements sont dans la langue par défaut de votre boutique. Pour afficher des titres, descriptions ou URL de produits traduits, recherchez le produit dans votre catalogue à l’aide de l’ID produit ou variante provenant de l’événement. Pour un exemple, consultez le Tutoriel : Afficher les produits et les prix par marché.

Déclencher des messages à partir de l’activité de commande

Les propriétés de marché sont incluses avec les événements Shopify pris en charge, de sorte qu’une Campaign ou un Canvas déclenché par une commande peut les utiliser sans configuration supplémentaire. Ces événements incluent country, presentment_currency et market_handle.

Type d’événement Événements
Événements eCommerce recommandés ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
Événements personnalisés shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order

presentment_currency offre la couverture la plus large par rapport aux autres. Elle est incluse avec les événements de panier, de paiement et de commande pris en charge, de sorte qu’un message de panier abandonné peut afficher le montant vu par le client même si les événements de panier ne contiennent pas country ni market_handle. Pour plus de détails, consultez Devise.

Rapports Markets

Lorsque Markets est activé, Braze ventile le chiffre d’affaires et les performances des messages par pays.

Chiffre d’affaires par pays

Votre rapport de chiffre d’affaires inclut une ventilation par pays en plus de la ventilation par application, à la fois sur la durée de vie et sur une période sélectionnée.

Chaque commande est attribuée à un pays, et la totalité de son chiffre d’affaires est affectée à ce pays. Le pays est d’abord déterminé à partir de la commande, puis du profil de l’acheteur. Les commandes pour lesquelles aucune des deux informations n’est disponible apparaissent sous Inconnu.

Le chiffre d’affaires est affiché en USD, comme le reste du rapport de chiffre d’affaires. Pour voir ce qu’un acheteur a réellement payé, utilisez presentment_currency sur l’événement de commande.

Performance par pays

Les analyses de Campaign et de Canvas incluent un tableau Performance par pays montrant les résultats d’un message dans chaque pays, ainsi qu’une ligne de total pour chaque pays. La devise et le chiffre d’affaires total sont agrégés à partir du champ presentment_currency de la commande.

Colonne Ce qu’elle affiche
Pays Chaque pays atteint par votre message.
Devise La devise du chiffre d’affaires de ce pays, agrégée par le champ presentment_currency.
Chiffre d’affaires total Le chiffre d’affaires attribué à ce pays.
Achats Les achats attribués à ce pays.

Supprimer un marché

Supprimer un marché empêche Braze de synchroniser de nouvelles données pour ses pays. Cela ne supprime pas les données que vous possédez déjà.

Groupes d’abonnement

Supprimer un marché met à jour la configuration de vos marchés. Cela ne supprime pas les groupes d’abonnement de votre espace de travail et ne retire pas les utilisateurs déjà abonnés aux groupes de pays.

Ce qui change dans votre configuration

  • Les pays du marché supprimé n’apparaissent plus dans l’interface des marchés.
  • Braze supprime les affectations de groupes d’abonnement de ces pays de la configuration de votre intégration.

Ce qui reste inchangé

  • Les groupes d’abonnement par pays restent dans votre espace de travail et demeurent disponibles pour le ciblage, mais Shopify ne synchronise plus les désabonnements vers ces groupes. Les utilisateurs qui se désabonnent dans Shopify peuvent toujours apparaître comme abonnés dans ces groupes de pays, à moins que vous ne mettiez à jour leur statut d’abonnement autrement, par exemple via les endpoints des groupes d’abonnement ou un workflow de désabonnement dans Braze.
  • Les utilisateurs déjà abonnés aux groupes de pays d’un marché supprimé restent abonnés.
  • Les nouveaux abonnements des acheteurs dans les pays supprimés sont synchronisés uniquement vers vos groupes à l’échelle du magasin, de la même manière que les abonnements provenant de pays que vous n’avez pas configurés.
  • Braze ne synchronise plus les nouveaux abonnements ou désabonnements vers les groupes de pays des pays supprimés.
  • Les groupes d’abonnement à l’échelle du magasin continuent de recevoir les mises à jour de consentement.

Données utilisateur

  • Les attributs déjà présents sur le profil d’un utilisateur, y compris shopify_locale et country, ne changent pas.
  • Le market_handle dans les nouveaux événements de commande n’est plus disponible.
  • Les filtres de Segment de marché Shopify pour les marchés supprimés ne sont plus disponibles.
  • Les références Liquid à un marché supprimé ne sont plus disponibles.

Catalogues

  • Les lignes de marché correspondant à ce marché ne sont plus actualisées et sont supprimées de votre catalogue.
  • Les sélections de catalogue basées sur ces lignes de marché cessent de renvoyer des produits. Mettez-les à jour ou supprimez-les avant votre prochain envoi.
  • Vos lignes par défaut, ainsi que toutes les sélections basées sur celles-ci, ne sont pas affectées.

Tutoriel : Afficher les produits et les prix par marché

Utilisez un catalogue compatible avec les marchés pour créer un seul message qui affiche à chaque utilisateur les produits et les prix correspondant à son propre marché.

  1. Créez une sélection qui utilise les données de marchés.
  2. Référencez la sélection dans un message avec Liquid.

Vous pouvez utiliser un marché fixe lorsqu’un message cible un marché spécifique.

Étape 1 : Créer une sélection à partir des données de marchés

Les sélections sont des ensembles de produits sélectionnés que vous référencez dans les messages. Pour les catalogues Shopify avec des marchés synchronisés, la section Filter settings inclut une zone Market scope qui limite les données produit à un seul marché ou les personnalise par utilisateur.

  1. Accédez à votre catalogue Shopify et ouvrez l’onglet Selections.
  2. Sélectionnez Create Selection, puis nommez la sélection, ajoutez une description facultative et définissez une limite de résultats.
  3. Dans Filter settings, sous Market scope, choisissez comment la sélection résout les produits spécifiques au marché dans le menu déroulant Market :
    • Personalized : Chaque destinataire voit les produits et les prix du marché correspondant à l’attribut country de son profil.
    • A synced market : Sélectionnez un marché par nom pour fixer la sélection sur les produits et les prix de ce marché. Utilisez cette option lorsqu’un message cible un seul marché.
  4. Finalisez les critères de filtre supplémentaires, puis enregistrez la sélection.
  5. Dans Preview for user, sélectionnez un utilisateur pour voir ce que la sélection renvoie pour ce profil. Les sélections qui utilisent Personalized ne peuvent être prévisualisées qu’après avoir sélectionné un utilisateur.
Cible Filtre
Un marché spécifique market_handle = au
Produits par défaut uniquement market_handle = default

Étape 2 : Ajouter des sélections de catalogue compatibles avec les marchés aux messages

Pour servir à chaque utilisateur les produits de son propre marché dans un seul message, créez une sélection avec ce filtre :

Nom de la sélection Champ Opérateur Valeur
market_products market_handle equals {{shopify_market.handle}}
default_products market_handle equals default

Au moment de l’envoi, Braze remplace {{shopify_market.handle}} par le marché de chaque utilisateur, de sorte que market_products fournit à chacun les bons produits. default_products est le repli pour les utilisateurs sans marché correspondant.

Référencez votre sélection dans votre message avec la balise {% shopify_market %} :

{% 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 %}
  • Placez {% shopify_market %} avant {% catalog_selection_items %} afin que le marché de l’utilisateur soit défini avant l’exécution de la sélection.
  • Remplacez <your_catalog_name> par votre catalogue, et utilisez vos propres noms de sélection s’ils diffèrent.
  • La vérification {{shopify_market.handle}} dirige les utilisateurs sans marché correspondant vers default_products, afin qu’ils reçoivent tout de même des produits au lieu d’un message vide.
  • Lorsque vous utilisez compare_at_price dans Liquid, vérifiez la valeur « 0 » avant de l’afficher ou de calculer une remise. Un marché sans prix de comparaison affiche un prix de zéro ou produit une remise incorrecte.

Prévisualisez le message en tant qu’utilisateur de votre marché pour confirmer que le message affiche les produits, les prix et les titres traduits de ce marché.

New Stuff!