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_numberou 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_ordershopify_fulfilled_ordershopify_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
- Sur la page d’intégration, sélectionnez Modifier les paramètres.
- À l’étape Suivre les données Shopify, ouvrez Afficher les paramètres supplémentaires des événements de commande.
- 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.