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 boutique par défaut via le parcours d’intégration standard ou personnalisé (SDK), puis sélectionnez, parmi les marchés configurés dans votre boutique, ceux que Braze doit synchroniser. Si vous disposez déjà d’une intégration, vous pouvez ajouter des marchés sans perturber vos catalogues, groupes d’abonnement ou événements. Pour les 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 la 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, notamment 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 aux détails du 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, afin que chaque utilisateur reçoive un message complet et exact.
Pour des exemples, consultez les sections 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 actifs à pays unique ou multi-pays. 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é doit disposer d’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 avec 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 langues : Les langues récupèrent les titres et descriptions de produits traduits en fonction de ce que vous avez configuré avec l’application Shopify Translate & Adapt, ainsi que les URL propres à chaque langue. Le prix, la devise et les autres champs de catalogue partagés restent identiques d’une langue à 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 langue principale que Shopify attribue à ce marché. Si vous activez la prise en charge étendue des langues, Braze synchronise les langues 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 comme faisant partie de 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, y compris les titres de produits et de variantes localisés ainsi que les URL des produits lorsque les traductions sont configurées avec 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 et non au moment où le prix change dans Shopify.
- Retour en stock : Le retour en stock est pris en charge pour les produits de votre catalogue de boutique par défaut. Les lignes de marché ne déclenchent pas de notifications de retour en stock. La fonctionnalité de retour en stock tient compte de l’inventaire total disponible pour une variante de produit dans tous les 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. Inutile de la déconnecter ou de refaire 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 auxquels ils appartiennent déjà. Si vous ajoutez des groupes par pays par la suite, 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 à côté des marchés sélectionnés. Vous pouvez donc 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 : Connecter votre boutique compatible 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’assistant de configuration.
- Terminez le flux OAuth et vérifiez que Braze demande bien les autorisations liées aux marchés dans l’OAuth :
read_marketsread_publicationsread_locales
- Une fois l’autorisation accordée et l’assistant de configuration ouvert, sélectionnez Commencer la configuration.
- Activez les SDK Braze.
Étape 2 : Sélectionner 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 des marchés pour choisir votre marché, et vérifiez que vous avez choisi de suivre les événements comportementaux et les attributs utilisateur.
- (Facultatif) Activez le remplissage 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 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 locale utilisée lors du paiement. Le remplissage de l’historique l’importe également depuis la fiche client Shopify. Les modifications apportées au client dans Shopify ne la changent pas. |
Pixel web, webhooks de commande, remplissage de l’historique |
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 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 du marché correspondant au pays du client. Vide si aucun marché configuré ne correspond. | Braze, à partir de votre configuration de 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 - Événements personnalisés :
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 que vous avez donné 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 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 sont un instantané du moment où l’événement s’est produit et ne changent plus ensuite. 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
Lorsque le reporting Shopify Markets est activé, les événements webhook natifs de Shopify pour le paiement, les commandes et les 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 vus et payés par le client
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 pour comparer le chiffre d’affaires entre marchés, puisqu’elles sont déjà exprimées dans une seule devise.
Les événements de panier issus 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énement.
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érer les utilisateurs
- Sélectionnez votre type d’
external_iddans la liste déroulante. - Activez les abonnements e-mail et SMS depuis Shopify, ce qui permet à Braze de synchroniser les états d’abonnement e-mail et SMS depuis Shopify. Deux options s’offrent à vous :
- Utiliser l’intégration : Braze synchronise les états e-mail et SMS. Sélectionnez les groupes d’abonnement avec lesquels ils se synchronisent.
- Créer votre propre solution : 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 avec lesquels le consentement Shopify se synchronise :
- Groupes à l’échelle de la boutique (obligatoire) : sélectionnez au moins un groupe e-mail et un groupe SMS. Chaque abonnement que Braze reçoit de 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 a un état de consentement e-mail et un état de consentement SMS. 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 identifier 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 enregistrés uniquement 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 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é à l’aide des modèles de routage par pays E.164. |
Une locale n’identifie un pays que si elle inclut une région, comme fr-FR. Une locale fr seule ne le permet pas.
Pour les 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.
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 envoyés par Shopify. Si le pays ou la 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 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 le site d’un 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 non 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 personnes que vous pouvez contacter. 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 orientez-les vers un groupe d’abonnement distinct.

Créez ce Segment sous forme de liste d’autorisation des pays que vous servez, et non de liste de blocage des pays que vous ne servez 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 exclurait 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 le 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 ajouté uniquement à vos groupes à l’échelle de la boutique. Si son pays est connu par la suite, 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 regroupant ces utilisateurs et abonnez-les à l’aide d’une étape Canvas de mise à jour utilisateur.
Comptabiliser les abonnés entre plusieurs groupes
Un même abonnement peut ajouter un utilisateur à plusieurs groupes d’abonnement : additionner les totaux des groupes compte donc la même personne plusieurs fois. 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 envoie 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 abonnement.
Étape 4 : Synchroniser 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 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 |
Prix propre au marché, issu de la tarification contextuelle du marché, après application des éventuels ajustements de la 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é. Il apparaît uniquement dans les lignes par défaut, où il reflète le stock total disponible pour une variante de produit dans tous les emplacements Shopify.
Lorsque vous utilisez compare_at_price dans Liquid, vérifiez la présence de « 0 » avant de l’afficher ou de calculer une remise. Un marché sans prix de comparaison affiche un prix nul ou une remise incorrecte.
Étape 5 : Activer les canaux
- (Facultatif) Choisissez d’activer ou non 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 enregistrés sur les profils utilisateurs, vous pouvez les utiliser 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 de vos Campaigns ou Canvas. Par exemple, ciblez les utilisateurs situés en France, ou créez un parcours Canvas basé sur shopify_locale.
Vous pouvez aussi utiliser les filtres de Segment Shopify Market, qui ciblent selon le marché associé à l’activité de commande d’un client. Pour atteindre uniquement les clients associés à votre marché par défaut, créez un Segment qui exclut les utilisateurs de chaque marché non défini par défaut que vous synchronisez. Par exemple, incluez 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 la section Tutoriel : Afficher les produits et les prix par marché.
Déclencher et personnaliser avec Liquid
Faites référence aux données de marché dans vos messages à l’aide de ces variables Liquid.
À 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 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. 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 aux produits, 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 leur absence entraîne un affichage incorrect.
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é égal à zéro.
Afficher des informations produit localisées
Les noms de produits figurant dans les événements 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 issu de l’événement. Pour un exemple, consultez la section 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, ce qui permet à un rappel de checkout ou à une confirmation de commande d’afficher le montant que le client a vu. Les événements de panier ne contiennent pas presentment_currency, country ni market_handle. Pour plus de détails, consultez la section 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 inclut 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, auquel revient la totalité de son chiffre d’affaires. 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 de Campaign et de Canvas incluent 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 de la presentment_currency de la commande.
| Colonne | Contenu |
|---|---|
| Pays | Chaque pays atteint par votre message. |
| Devise | La devise du chiffre d’affaires de ce pays, agrégée selon la 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 Campaigns et des Canvas par pays dans le générateur de rapports en utilisant Pays (Shopify Markets) comme ligne ou comme niveau d’exploration.
Supprimer un marché
Lorsque vous supprimez un marché, Braze cesse de synchroniser les nouvelles données pour les pays de ce marché. 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 retire 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 peuvent toujours servir au ciblage, mais Shopify n’y synchronise plus les désabonnements. Les utilisateurs qui se désabonnent dans Shopify peuvent donc continuer d’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 avec les endpoints de groupes d’abonnement ou un workflow 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 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 du consentement.
Données utilisateur
- Les attributs déjà présents dans le profil d’un utilisateur, y compris
shopify_localeetcountry, ne changent pas. - Le
market_handlen’est plus disponible dans les nouveaux événements de commande. - Les filtres de Segment 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 marché correspondant à ce marché ne sont plus actualisées et sont retirées de votre catalogue.
- Les sélections de catalogue basées 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 basées sur celles-ci, 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 seul marché précis.
É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é qui limite les données produit à un seul marché ou les personnalise pour chaque utilisateur.
- Accédez à votre catalogue Shopify et ouvrez l’onglet Sélections.
- Sélectionnez Créer une sélection, puis nommez 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 le menu déroulant Marché la manière dont la sélection résout 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 éventuels critères de filtre supplémentaires, 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 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 précisez pas de 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 seul message, 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 : market_products fournit ainsi à chacun les bons produits. 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 de
{{shopify_market.handle}}redirige les utilisateurs sans marché correspondant versdefault_products, pour qu’ils reçoivent quand même des produits plutôt qu’un message vide. - Lorsque vous utilisez
compare_at_pricedans Liquid, vérifiez la valeur « 0 » avant de l’afficher ou de calculer une remise. Un marché sans prix de comparaison affiche un prix nul ou génère une remise 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é.