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ée (SDK). Sélectionnez ensuite, parmi les marchés configurés dans votre boutique, ceux que Braze doit synchroniser. Les intégrations existantes peuvent ajouter des marchés sans perturber les catalogues, les groupes d’abonnement ni les événements. Pour des instructions détaillées, consultez la section Configuration de Shopify Markets.
Shopify Markets offre les fonctionnalités suivantes :
- Profils adaptés aux marchés : L’intégration enregistre la langue et région Shopify de chaque utilisateur, ainsi que les attributs standard de pays et de langue de Braze. Vous pouvez ainsi segmenter et déclencher vos messages par marché, sans aucune configuration personnalisée.
- Catalogues localisés : Les données produit propres à chaque marché sont synchronisées quotidiennement, y compris les prix et la devise, ainsi que les titres, descriptions et URL de produits traduits.
- Personnalisation adaptée aux marchés : 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 faire référence à des informations sur le marché, comme la devise de présentation, à partir des événements Shopify pris en charge, tels queecommerce.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. Chaque utilisateur reçoit ainsi un message complet et exact.
Pour des exemples, consultez Utiliser les données utilisateur de 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 à pays unique ou multi-pays actifs. Chaque pays ne peut appartenir qu’à un seul marché sélectionné.
Les marchés de sous-région, les marchés de vente au détail, les marchés B2B et les marchés de canal ne sont pas pris en charge.
Ce dont chaque marché a besoin
Chaque marché sélectionné nécessite un catalogue de marché contenant des produits actifs. Braze lit les éléments suivants dans 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 Shopify « Utiliser les devises locales » 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 de langue spécifiques à un marché. |

Points à prendre en compte
Général
- Une seule boutique connectée : Vous ne pouvez connecter qu’une seule boutique 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é dans l’application Shopify Translate & Adapt, ainsi que les URL propres à chaque locale. Le prix, la devise et les autres champs partagés du catalogue restent identiques d’une locale à l’autre au sein d’un même 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. Braze les affiche plutôt dans votre catalogue Shopify d’origine. Les données Markets sont ajoutées sous forme de nouvelles lignes dans votre catalogue Shopify.
- Sélections de catalogue : Jusqu’à 30 sélections de catalogue.
- Fréquence d’actualisation : Les données produit 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
compare_at_price, ainsi que les titres de produits et de variantes localisés et les URL de produits lorsque les traductions sont configurées via l’application Shopify Translate & Adapt. - 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 boutique. Comme les données produit 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 : Le retour en stock est pris en charge pour les produits du catalogue par défaut de votre boutique. Les lignes de marché ne déclenchent pas de notifications de retour en stock. Le retour en stock tient compte de l’inventaire total disponible pour une variante de produit sur l’ensemble des emplacements Shopify : un stock ajouté dans un point de vente physique peut donc déclencher une notification.
Configuration de Shopify Markets
Si vous disposez déjà d’une intégration Shopify active
Markets vient compléter votre intégration actuelle. Vous n’avez pas besoin de la déconnecter ni de recréer votre configuration.
- Vos groupes d’abonnement deviennent vos groupes à l’échelle de la boutique et continuent de recevoir chaque abonnement, y compris pour les groupes supplémentaires que vous avez attribués.
- Vos abonnés existants restent dans les groupes dont ils font déjà partie. Si vous ajoutez des groupes par pays plus tard, Braze n’y ajoute pas les abonnés existants.
- Votre catalogue continue de se synchroniser. Les lignes de marché y sont ajoutées au lieu d’être placées dans un nouveau catalogue, et vos sélections existantes continuent de fonctionner sur vos lignes par défaut.
- Votre boutique par défaut apparaît à côté des marchés que vous avez sélectionnés. Vous pouvez ainsi lui attribuer des groupes d’abonnement et créer des sélections de catalogue de la même manière.
Si votre boutique est déjà connectée, commencez par l’étape 2 pour en savoir plus sur chaque configuration et son fonctionnement.
Étape 1 : Connectez votre boutique compatible avec Shopify Markets
- Connectez votre boutique en suivant le parcours d’intégration standard Shopify ou d’intégration personnalisée Shopify. Une fois votre boutique connectée, configurez Shopify Markets dans l’outil de configuration.
- Terminez le flux OAuth et vérifiez que Braze demande bien les autorisations (scopes) liées aux marchés dans OAuth :
read_marketsread_publicationsread_locales
- Une fois l’autorisation accordée et l’outil de configuration ouvert, sélectionnez Commencer la configuration.
- Activez les SDK de Braze.
Étape 2 : Sélectionnez les données utilisateur de vos marchés
- Dans Suivre les données Shopify, sélectionnez Synchroniser les données Shopify Markets.
- Sélectionnez Sélectionner les marchés pour choisir votre marché, et vérifiez que vous avez bien choisi de suivre les événements comportementaux et les attributs utilisateur.
- (Facultatif) Activez le remplissage rétroactif de l’historique
Données utilisateur de Markets
Pour prendre en charge Shopify Markets, Braze synchronise des données supplémentaires en plus 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 locale du client, par exemple en ou fr-CA. Le pixel web de Braze la définit à partir de la langue du navigateur de l’acheteur, et chaque commande passée la met à jour avec la langue locale utilisée lors du paiement. Le remplissage rétroactif de l’historique l’importe également depuis la fiche client Shopify. Les modifications apportées par le client dans Shopify ne la changent pas. |
Pixel web, webhooks de commande, remplissage rétroactif de l’historique |
browser_language |
Attribut standard | La langue définie dans le navigateur du client. | SDK de Braze |
country |
Attribut standard | Le pays du client. | SDK de Braze |
Propriétés des événements de commande
| Propriété | Description | Source des données |
|---|---|---|
country |
Code pays à deux lettres du client. | L’adresse default_address du client dans Shopify, ou l’adresse 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 (handle) du marché correspondant au pays du client. Vide si aucun marché configuré ne correspond. | Braze, à partir de votre configuration des marchés |
Ces propriétés sont ajoutées aux événements suivants :
- Événements eCommerce recommandés :
ecommerce.order_placed,ecommerce.order_cancelled,ecommerce.order_refunded - Custom events :
shopify_paid_order,shopify_fulfilled_order,shopify_partially_fulfilled_order
Fonctionnement des propriétés d’événement liées aux marchés
| Propriété | Fonctionnement |
|---|---|
market_handle |
market_handle correspond à l’identifiant (handle) que vous avez attribué au marché dans Shopify, par exemple france. Ce même identifiant sert de préfixe aux ID des lignes de marché dans votre catalogue, par exemple france_46714756268231. Il est vide si vous n’avez pas configuré de marchés, ou si le pays de la commande ne correspond à aucun marché configuré : vérifiez donc qu’il n’est pas vide avant de l’utiliser dans Liquid ou dans un filtre de Segment. |
country |
country provient de l’adresse par défaut du client, et utilise l’adresse shipping_address si aucune adresse par défaut n’existe. Par exemple, un client en France qui fait livrer une commande au Japon reste associé au marché France. |
| Propriétés d’événement | Les propriétés d’événement reflètent l’instant où l’événement s’est produit et ne changent plus ensuite. Si un client modifie 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
Lorsque le reporting Shopify Markets est activé, les événements webhook natifs de Shopify relatifs au paiement, aux commandes et aux remboursements contiennent deux ensembles de valeurs :
- La devise de votre boutique dans les champs de prix et de total existants, inchangés
- L’objet
presentment_currency, qui contient les montants que le client a vus et payés
Ces événements peuvent également inclure des propriétés de marché associées, comme country et market_handle.
Utilisez presentment_currency lorsque vous montrez à un client ce qu’il a payé, par exemple dans une confirmation de commande ou un rappel de paiement. Utilisez les valeurs dans la devise de la boutique lorsque vous comparez le chiffre d’affaires entre marchés, puisqu’elles sont déjà exprimées dans une seule devise.
Les événements de panier provenant du pixel Shopify n’incluent pas presentment_currency. Les événements personnalisés de paiement et d’achat que vous envoyez via une CDP comme Segment ne l’incluent pas non plus. Pour conserver la devise du marché dans vos messages et vos rapports, ajoutez un objet équivalent dans le payload de votre événement personnalisé, ou laissez les événements Shopify natifs activés pour les types d’événements dont vous avez besoin.
Informations produit localisées
Les événements Shopify pris en charge contiennent les titres des produits et des variantes dans la langue par défaut de votre boutique. Braze ne traduit pas les payloads d’événements.
Les titres, descriptions et URL de produits traduits se trouvent dans les lignes de marché de votre catalogue. Pour afficher des informations produit localisées dans un message, recherchez le produit dans votre catalogue à l’aide de l’ID du produit ou de la variante issu de l’événement.
Étape 3 : Gérez les utilisateurs
- Sélectionnez votre type d’
external_iddans la liste déroulante. - Activez les abonnements e-mail, SMS et WhatsApp depuis Shopify, ce qui permet à Braze de synchroniser les états d’abonnement e-mail, SMS et WhatsApp depuis Shopify. Deux options s’offrent à vous :
- Utiliser l’intégration : Braze synchronise les états e-mail, SMS et WhatsApp. Sélectionnez les groupes d’abonnement vers lesquels ils sont synchronisés. Les groupes WhatsApp ne sont disponibles que si votre espace de travail dispose d’un compte WhatsApp Business connecté.
- Créer votre propre intégration : Pour mieux contrôler la gestion des états, créez une intégration personnalisée à l’aide des endpoints de groupes d’abonnement de Braze.
- Sélectionnez les groupes d’abonnement vers lesquels le consentement Shopify est synchronisé :
- Groupes à l’échelle de la boutique (obligatoire) : Sélectionnez au moins un groupe pour chaque canal que vous activez. Chaque abonnement reçu par Braze depuis Shopify y est enregistré.
- Groupes par pays (facultatif) : Attribuez un ou plusieurs groupes à n’importe quel pays de vos marchés synchronisés. Les abonnements y sont également enregistrés lorsque Braze peut déterminer le pays du client.
Fonctionnement des abonnements et des désabonnements
Dans Shopify, chaque client dispose d’un seul état de consentement e-mail, d’un seul état de consentement SMS et d’un seul état de consentement WhatsApp. Lorsqu’un client s’abonne, il s’abonne à votre marque, et non à un pays ou à une liste.
Braze enregistre chaque abonnement dans vos groupes à l’échelle de la boutique. Si vous avez configuré 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 sont uniquement enregistrés dans vos groupes à l’échelle de la boutique, ce qui correspond à la façon dont Shopify gère actuellement le consentement.
Comment Braze détermine le pays
| Canal | Détermination du pays |
|---|---|
| Utilise d’abord la langue locale Shopify du client ; à défaut, utilise l’attribut de pays de son profil Braze. | |
| SMS | Utilise le pays du numéro de téléphone, déterminé selon les modèles de routage par pays E.164. |
| Utilise le pays du numéro de téléphone, comme pour les SMS. |
Une langue locale n’identifie un pays que si elle inclut une région, par exemple fr-FR. Une langue locale fr seule ne le permet pas.
Pour les SMS et WhatsApp, 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.
Que se passe-t-il 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 |
| Impossible à déterminer | Abonné | Non abonné |
| Déterminé, mais non configuré dans vos marchés | Abonné | Non abonné |
L’appartenance aux groupes d’abonnement repose sur les événements de consentement provenant de Shopify. Si le pays ou la langue locale d’un acheteur change, son appartenance aux groupes ne change pas. Braze ne la met à jour que lorsque Shopify envoie un nouvel événement de consentement, par exemple si le consentement de l’acheteur est à nouveau recueilli sur Shopify après le changement de pays ou de langue locale.

Les groupes par pays contrôlent le consentement, pas la langue. Un pays peut avoir plusieurs langues. Les clients anglophones et francophones au Canada, en-CA et fr-CA, appartiennent au même groupe par pays. Utilisez shopify_locale dans vos messages pour définir la langue.
Que se passe-t-il lorsqu’une personne se désabonne ?
Un désabonnement dans Shopify retire l’utilisateur de tous les groupes d’abonnement attribués à votre intégration Shopify. C’est le cas qu’il se soit désabonné via un site de marché ou via la page de son compte Shopify.
Les groupes d’abonnement de votre espace de travail qui ne sont pas attribués à l’intégration ne sont pas concernés.
Abonnements provenant de 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 est abonné à vos groupes à l’échelle de la boutique. Il n’est ajouté à aucun groupe par pays.
La configuration des marchés ne limite pas les destinataires de vos messages. Si vous ne pouvez pas envoyer de messages dans un pays pour des raisons juridiques ou réglementaires, excluez ces utilisateurs à l’aide d’un filtre de Segment ou dirigez-les vers un groupe d’abonnement distinct.

Créez ce Segment sous forme de liste d’autorisation des pays que vous desservez, et non de liste de blocage des pays que vous ne desservez pas. Les utilisateurs dont le pays n’a pas pu être déterminé n’ont aucune valeur de pays : une liste de blocage ne les exclura donc pas.
Pour les SMS, les autorisations par pays de chaque groupe d’abonnement continuent de contrôler la distribution. Un utilisateur dont le pays n’est pas autorisé pour un groupe ne recevra pas de messages de ce groupe.
Les utilisateurs ne sont pas ajoutés ultérieurement aux groupes par pays
Si Braze ne peut pas déterminer le pays d’un client au moment de son abonnement, celui-ci est uniquement ajouté à vos groupes à l’échelle de la boutique. Si son pays est connu plus tard, il n’est pas automatiquement ajouté aux groupes de ce pays.
Lorsque vous activez Markets dans 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 à l’aide d’une étape Canvas Mise à jour de l’utilisateur.
Comptabiliser les abonnés de plusieurs groupes
Un seul abonnement peut ajouter un utilisateur à plusieurs groupes d’abonnement : additionner les totaux des groupes revient donc à compter plusieurs fois la même personne. Utilisez un Segment lorsque vous avez besoin du nombre d’abonnés uniques.
Fonctionnement
- Un client s’abonne aux SMS lors du paiement ou via un formulaire.
- Shopify transmet l’abonnement à Braze.
- Braze définit l’utilisateur comme en attente et envoie votre SMS de confirmation.
- Le client répond avec votre mot-clé de confirmation et devient abonné.
- S’il ne répond pas avant la fin de la période de confirmation, il reste en attente.
Pour plus d’informations, consultez la section Double opt-in.
Étape 4 : Synchronisez les produits
- Pour synchroniser les produits de votre marché, sélectionnez Synchroniser les produits et variantes Shopify avec Braze.
- Attribuez l’ID du catalogue Braze et configurez les éventuels paramètres supplémentaires.
Votre catalogue inclut une vue par marché des 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. Si vous activez Shopify Markets sur une intégration existante, la synchronisation de ces lignes peut prendre quelques minutes.
Sur les lignes de marché, les champs suivants ont des valeurs propres 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 d’origine. |
market_handle |
L’identifiant (handle) que vous avez attribué au marché dans Shopify, par exemple france. |
locale |
La langue locale du marché, qui détermine la langue du contenu traduit. |
price |
Prix propre au marché, issu de la tarification contextuelle du marché, après application des éventuels ajustements de liste de prix. |
compare_at_price |
Prix de comparaison propre au marché après ajustements. Braze renvoie 0 lorsqu’aucun prix de comparaison n’est défini pour ce marché, y compris lorsque la liste de prix du marché est configurée pour annuler les prix de comparaison. |
product_title et variant_title |
Titres traduits, lorsque les traductions sont configurées via l’application Shopify Translate & Adapt. |
product_url |
L’URL du produit pour ce marché. |

inventory_quantity n’est pas inclus dans les lignes de marché. Ce champ apparaît uniquement sur les lignes par défaut, où il reflète le stock total disponible d’une variante de produit sur l’ensemble des emplacements Shopify.
Lorsque vous utilisez compare_at_price dans Liquid, vérifiez si la valeur est « 0 » avant de l’afficher ou de calculer une remise. Un marché sans prix de comparaison affiche sinon un prix nul ou une remise incorrecte.
Étape 5 : Activez les canaux
- (Facultatif) Indiquez si vous souhaitez activer les messages dans le navigateur.
- Sélectionnez Terminer la configuration.
Utiliser les données utilisateur de Markets
Une fois ces attributs et propriétés ajoutés aux profils utilisateurs, vous pouvez vous en servir pour cibler les utilisateurs par marché et personnaliser vos messages.
Cibler par marché dans la segmentation
Filtrez par pays, par langue du navigateur ou par shopify_locale dans les Segments et dans les critères d’entrée des Campaigns ou des Canvas. Vous pouvez par exemple cibler les utilisateurs situés en France ou créer un parcours de Canvas basé sur shopify_locale.
Vous pouvez aussi utiliser les filtres de Segment Shopify Market, qui ciblent les clients selon le marché associé à leurs commandes. Pour ne toucher que les clients associés à votre marché par défaut, créez un Segment qui exclut les utilisateurs de chaque marché autre que celui par défaut que vous synchronisez. Vous pouvez par exemple inclure toutes les personnes ayant passé une commande, sauf celles dont le marché est le Mexique.
Pour sélectionner des produits du catalogue par identifiant de marché (y compris lorsque market_handle vaut default pour les lignes de produits par défaut), consultez Tutoriel : Afficher les produits et les prix par marché.
Déclencher et personnaliser avec Liquid
Référencez les données de marché dans vos messages à l’aide des variables Liquid suivantes.
À partir du profil utilisateur
| Attribut | Liquid |
|---|---|
| La langue du client | {{custom_attribute.${shopify_locale}}} |
| Le pays du client | {{${country}}} |
À partir des é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 utilisée par le client pour payer | {{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. Afficher un montant seul est l’erreur la plus fréquente dans les messages multi-marchés, car « 129,95 » n’a pas la même signification d’un marché à l’autre.
Utilisez le total de la commande pour les messages liés à la commande, comme une confirmation, et le prix du produit pour les contenus liés au 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 sont pas toujours présentes, et elles s’affichent toutes les deux de manière incorrecte lorsqu’elles sont absentes.
market_handle est vide lorsque le pays du client ne correspond à aucun marché configuré. Vérifiez sa présence avant de créer une branche à partir de cette valeur :
{% if event_properties.${market_handle} != blank %}
...
{% endif %}
compare_at_price renvoie 0 lorsqu’aucun prix de comparaison n’est défini pour 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
Dans les événements, les noms de produits sont dans la langue par défaut de votre boutique. Pour afficher des titres, des descriptions ou des URL de produits traduits, recherchez le produit dans votre catalogue à l’aide de l’ID du produit ou de la variante fourni dans l’événement. Pour un exemple, consultez 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 dans les événements Shopify pris en charge : une Campaign ou un Canvas déclenché par une commande peut donc 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 est inclus dans les événements de checkout, de commande et de remboursement pris en charge : un rappel de checkout ou une confirmation de commande peut ainsi afficher le montant vu par le client. Les événements de panier ne contiennent pas presentment_currency, country ni market_handle. Pour en savoir plus, consultez Devise.
Rapports Markets

Les clients Shopify existants doivent utiliser le chiffre d’affaires ecommerce.order_placed pour afficher les rapports Markets. Pour les nouveaux clients, cette option est activée par défaut. Pour toute question, contactez votre équipe de compte.
Lorsque Markets est activé, Braze ventile le chiffre d’affaires et les performances des messages par pays.
Chiffre d’affaires par pays
Votre rapport sur le chiffre d’affaires comprend une ventilation par pays en plus de la ventilation par application, à la fois sur toute la durée de vie et sur une période sélectionnée.
Chaque commande est attribuée à un seul pays, et la totalité de son chiffre d’affaires revient à ce pays. Le pays est d’abord déterminé à partir de la commande, puis à partir du profil de l’acheteur. Les commandes pour lesquelles aucune de ces informations n’est disponible apparaissent sous Inconnu.
Le chiffre d’affaires est affiché en USD, comme dans le reste du rapport sur le chiffre d’affaires. Pour connaître le montant réellement payé par un acheteur, utilisez presentment_currency dans l’événement de commande.
Performances par pays
Les analyses des campagnes et des Canvas comprennent un tableau Performances par pays qui montre les performances d’un message dans chaque pays, avec une ligne de total pour chaque pays. La devise et le chiffre d’affaires total sont agrégés à partir du 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 selon le presentment_currency. |
| Chiffre d’affaires total | Le chiffre d’affaires attribué à ce pays. |
| Achats | Les achats attribués à ce pays. |
Vous pouvez également ventiler les performances des campagnes et des Canvas par pays dans le Générateur de rapports en utilisant Countries (Shopify Markets) comme ligne ou comme niveau d’exploration.
Supprimer un marché
La suppression d’un marché empêche Braze de synchroniser de nouvelles données pour les pays qui lui sont associés. Les données dont vous disposez déjà ne sont pas supprimées.
Groupes d’abonnement
La suppression d’un marché met à jour votre configuration Markets. Elle ne supprime pas les groupes d’abonnement de votre espace de travail et ne retire pas les utilisateurs déjà abonnés aux groupes par pays.
Ce qui change dans votre configuration
- Les pays du marché supprimé n’apparaissent plus dans l’interface Markets.
- Braze supprime les affectations de groupes d’abonnement de ces pays dans la configuration de votre intégration.
Ce qui ne change pas
- Les groupes d’abonnement par pays restent dans votre espace de travail et peuvent toujours servir au ciblage, mais Shopify n’y synchronise plus les désabonnements. Les utilisateurs qui se désabonnent dans Shopify peuvent donc toujours apparaître comme abonnés dans ces groupes par pays, sauf si vous mettez à jour leur statut d’abonnement par un autre moyen, par exemple via les endpoints des groupes d’abonnement ou un flux de désabonnement dans Braze.
- Les utilisateurs déjà abonnés aux groupes par pays d’un marché supprimé restent abonnés.
Synchronisation future du consentement
- Les nouveaux abonnements des clients situés dans les pays supprimés sont synchronisés uniquement avec vos groupes à l’échelle de la boutique, comme pour les abonnements provenant de pays que vous n’avez pas configurés.
- Braze ne synchronise plus les nouveaux abonnements ni les nouveaux désabonnements avec les groupes par pays des pays supprimés.
- Les groupes d’abonnement à l’échelle de la boutique continuent de recevoir les mises à jour de consentement.
Données utilisateur
- Les attributs déjà présents dans le profil d’un utilisateur, notamment
shopify_localeetcountry, ne changent pas. - Le
market_handlen’est plus disponible dans les nouveaux événements de commande. - Les filtres de segmentation Shopify Market pour les marchés supprimés ne sont plus disponibles.
- Le code Liquid faisant référence à un marché supprimé n’est plus disponible.
Catalogues
- Les lignes de ce marché ne sont plus actualisées et sont supprimées de votre catalogue.
- Les sélections de catalogue reposant sur ces lignes de marché ne renvoient plus de produits. Mettez-les à jour ou supprimez-les avant votre prochain envoi.
- Vos lignes par défaut, ainsi que les sélections qui reposent sur elles, ne sont pas concernées.
Tutoriel : Afficher les produits et les prix par marché
Utilisez un catalogue compatible avec les marchés pour créer un message unique qui présente à chaque utilisateur les produits et les prix de son propre marché.
- Créez une sélection qui utilise les données des marchés.
- 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 des marchés
Les sélections sont des ensembles de produits organisés que vous référencez dans vos messages. Pour les catalogues Shopify dont les marchés sont synchronisés, la section Paramètres de filtre comprend une zone Portée du marché. Elle permet de limiter les données produit à un seul marché ou de les personnaliser pour chaque utilisateur.
- Accédez à votre catalogue Shopify et ouvrez l’onglet Sélections.
- Sélectionnez Créer une sélection. Nommez ensuite la sélection, ajoutez une description facultative et définissez une limite de résultats.
- Dans Paramètres de filtre, sous Portée du marché, choisissez dans la liste déroulante Marché comment la sélection détermine les produits propres à chaque marché :
- Personnalisé : Chaque destinataire voit les produits et les prix du marché correspondant à l’attribut
countryde son profil. - Un marché synchronisé : Sélectionnez un marché par son nom pour associer la sélection aux produits et aux prix de ce marché. Utilisez cette option lorsqu’un message cible un seul marché.
- Personnalisé : Chaque destinataire voit les produits et les prix du marché correspondant à l’attribut
- Complétez les autres critères de filtre si nécessaire, puis enregistrez la sélection.
- Dans Aperçu pour l’utilisateur, sélectionnez un utilisateur pour voir ce que la sélection renvoie pour ce profil. Les sélections qui utilisent l’option Personnalisé ne peuvent être prévisualisées qu’après la sélection d’un utilisateur.
| Cible | Filtre |
|---|---|
| Un marché spécifique | market_handle = au |
| Produits par défaut uniquement | market_handle = default |

Si vous ne spécifiez aucun marché, Braze utilise vos produits par défaut.
Étape 2 : Ajouter des sélections de catalogue compatibles avec les marchés à vos messages
Pour proposer à chaque utilisateur les produits de son propre marché dans un message unique, créez une sélection avec ce filtre :
| Nom de la sélection | Champ | Opérateur | Valeur |
|---|---|---|---|
market_products |
market_handle |
est égal à | {{shopify_market.handle}} |
default_products |
market_handle |
est égal à | default |
Au moment de l’envoi, Braze remplace {{shopify_market.handle}} par le marché de chaque utilisateur. Ainsi, market_products présente les bons produits à tout le monde. default_products sert de solution de repli pour les utilisateurs sans marché correspondant.
Référencez votre sélection dans votre message avec l’étiquette {% 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 sont différents. - La vérification
{{shopify_market.handle}}redirige les utilisateurs sans marché correspondant versdefault_products. Ils reçoivent donc quand même des produits au lieu d’un message vide. - Lorsque vous utilisez
compare_at_pricedans Liquid, vérifiez la valeur « 0 » avant de l’afficher ou de calculer une remise. Pour un marché sans prix de comparaison, le prix affiché sera nul ou la remise calculée sera incorrecte.
Prévisualisez le message en tant qu’utilisateur de votre marché pour vérifier qu’il affiche bien les produits, les prix et les titres traduits de ce marché.