Passer au contenu

Métachamps de commande Shopify

Avec l’intégration standard de Shopify, vous pouvez ajouter certains métachamps de commande aux événements de commande. Les métachamps de commande contiennent vos propres données sur une commande, comme un message cadeau ou une préférence d’expédition.

Vous pouvez sélectionner jusqu’à 20 définitions de métachamps de commande. Braze les ajoute aux événements de commande Shopify pris en charge, pour que vous puissiez les utiliser à des fins de segmentation et de personnalisation.

Affichage des métachamps de commande dans les événements

Chaque métachamp sélectionné est ajouté à l’objet metadata de l’événement sous la forme <namespace>_<key>, à côté de champs comme metadata.tags. Par exemple, la définition Shopify custom.gift_note apparaît sous la forme metadata.custom_gift_note :

{
  "metadata": {
    "order_number": "1234",
    "tags": ["heavy", "heavy2"],
    "custom_gift_note": "Happy birthday!"
  }
}

Les tags de commande ne changent pas : Braze envoie toujours tous les tags avec l’événement. Les valeurs de métachamps vides sont omises.

Types de métachamps de commande pris en charge

Seules les définitions des types suivants apparaissent dans le sélecteur. Les références, fichiers, JSON, montants monétaires et notes ne sont pas proposés.

Type Shopify Stocké dans l’événement en tant que
Texte sur une seule ligne, texte multiligne, couleur, URL, ID Chaîne de caractères
Entier Entier
Décimal Nombre
Vrai ou faux Booléen
Date, date et heure Chaîne de caractères ISO 8601 en UTC. Une date sans heure est fixée à minuit UTC.
Liste de textes sur une seule ligne, de dates, de dates et heures, de couleurs, d’ID ou d’URL Tableau de chaînes de caractères

Braze omet une valeur de l’événement dans les cas suivants :

  • Une valeur de chaîne de caractères, ou un élément d’une liste, dépasse 255 caractères.
  • Une valeur ne peut pas être convertie dans le type de la définition, par exemple du texte dans un champ entier.
  • La clé (<namespace>_<key>) dépasse 255 caractères ou contient $ ou ..
  • La clé entre en conflit avec une propriété que Braze écrit déjà dans l’événement, comme order_number ou les champs Shopify Markets.

Événements pris en charge

Ces événements incluent les métachamps de commande sélectionnés dans metadata :

  • Commande passée (ecommerce.order_placed)
  • Commande annulée (ecommerce.order_cancelled)
  • shopify_paid_order
  • shopify_fulfilled_order
  • shopify_partially_fulfilled_order

L’événement Commande remboursée (ecommerce.order_refunded) et les événements de checkout ne contiennent pas de métachamps de commande.

Moment où Braze inclut les métachamps de commande

Source Description
Webhooks de commande Shopify La valeur correspond à l’état du métachamp au moment où Shopify envoie le webhook de commande. Les événements ne sont pas réécrits après leur envoi.
Remplissage historique Si vous sélectionnez des métachamps de commande lors de la configuration initiale et que le remplissage historique est activé, les commandes importées incluent les métachamps sélectionnés.

Toute modification de la sélection ne s’applique qu’aux commandes reçues après ce changement. Les commandes passées ne sont pas resynchronisées.

Modifier ou supprimer des métachamps

  1. Sur la page d’intégration, sélectionnez Modifier les paramètres.
  2. À l’étape Suivre les données Shopify, ouvrez Afficher les paramètres supplémentaires des événements de commande.
  3. Mettez à jour Ajouter les métachamps de commande aux événements de commande. Décocher la case efface la sélection.

Si vous supprimez une définition dans Shopify, Braze la retire automatiquement de votre sélection. Les événements déjà envoyés conservent leurs valeurs.

Segmentation et personnalisation

Les valeurs des métachamps de commande sont des propriétés d’événement situées sous metadata, au même endroit que les tags : vous pouvez donc les utiliser de la même manière que metadata.tags aujourd’hui. Par exemple, {{event_properties.${metadata}.custom_gift_note}} renvoie Happy birthday! pour l’exemple custom.gift_note de cet article.

New Stuff!