Configuration de l’intégration standard de Shopify

Cette page vous explique comment intégrer Braze à Shopify à l’aide de notre intégration standard pour les utilisateurs disposant d’une boutique en ligne Shopify. Si vous utilisez un site Shopify headless ou si vous cherchez à mettre en place des solutions plus personnalisées, reportez-vous à la configuration de l’intégration personnalisée de Shopify.

Étape 1 : Connectez votre boutique Shopify

1. Dans Braze, allez à Intégrations de partenaires > Partenaires technologiques, puis recherchez Shopify.

2. Sur la page partenaire de Shopify, sélectionnez Commencer la configuration pour lancer le processus d’intégration.



3. Dans la boutique d’applications de Shopify, installez l’application Braze.

4. Après avoir installé l’appli Braze, vous serez redirigé vers Braze pour confirmer l’espace de travail que vous souhaitez connecter à Shopify. Une boutique Shopify ne peut se connecter qu’à un seul espace de travail. Si vous devez changer d’espace de travail, sélectionnez le bon espace de travail.

5. Sélectionnez Commencer la configuration.

Étape 2 : Activer les SDK Web de Braze

Pour les boutiques en ligne Shopify, vous pouvez sélectionner la configuration standard pour mettre en œuvre automatiquement le SDK Web et le SDK JavaScript de Braze.

Après avoir sélectionné la configuration standard de l’onboarding, vous devrez choisir le moment où Braze doit s’initialiser et charger les SDK à partir de l’une des options suivantes :

• Lors de la visite du site, par exemple au début de la session
  • Trace les utilisateurs identifiés et anonymes
• Lors de l’ouverture d’un compte, par exemple lors de l’identifiant du compte
  • Suivre uniquement les utilisateurs identifiés
  • Commence à suivre les données lorsque les visiteurs du site s’inscrivent ou se connectent à leur compte.

Étape 3 : Configurez vos données Shopify

Configuration standard des données

Vous allez maintenant sélectionner les données Shopify que vous souhaitez suivre.

Les événements suivants sont activés par défaut dans l’intégration standard.

Pour plus d’informations sur les données suivies par l’intégration, consultez les fonctionnalités des données de Shopify.

Configuration du remblayage historique

Grâce à la configuration standard, vous avez la possibilité d’effectuer un chargement initial de vos clients et commandes Shopify des 90 derniers jours précédant votre connexion à l’intégration Shopify. Pour ce faire, cochez la case pour inclure le chargement initial des données dans votre intégration.

Cette table contient les données qui seront initialement chargées par le biais du remblai.

Lorsque vos enregistrements de clients Shopify sont chargés dans Braze, l’ID client Shopify sera utilisé comme ID externe de Braze.

(Avancé) Configuration personnalisée du suivi des données

Avec les SDK de Braze, vous pouvez suivre des événements personnalisés ou des attributs personnalisés qui vont au-delà des événements standard pour cette intégration. Les événements personnalisés capturent les interactions uniques dans votre magasin, comme par exemple :

Le suivi des données personnalisées permet d’obtenir des informations plus approfondies sur le comportement des clients et favorise une personnalisation supplémentaire. Pour mettre en œuvre des événements personnalisés, vous devez modifier le code du thème de votre vitrine dans le fichier theme.liquid. Vous aurez peut-être besoin de l’aide de vos développeurs.

Par exemple, l’extrait de code JavaScript suivant détermine si l’utilisateur actuel s’abonne à un bulletin d’information et consigne cet événement en tant qu’événement personnalisé sur son profil dans Braze :

1
2
3
4
5
6
7
8
9
braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

Le SDK doit être initialisé (à l’écoute de l’activité) sur l’appareil d’un utilisateur pour enregistrer des événements et des attributs personnalisés. Pour en savoir plus sur l’enregistrement des données personnalisées, reportez-vous à l’objet User et à l’objet logCustomEvent.

Étape 4 : Configurer la façon dont vous gérez les utilisateurs

Sélectionnez votre type de external_id dans le menu déroulant.

Par défaut, Braze convertit automatiquement les e-mails provenant de Shopify en minuscules avant de les utiliser comme ID externe. Si vous utilisez l’e-mail ou l’e-mail haché comme ID externe, vérifiez que vos adresses e-mail sont également converties en minuscules avant de les attribuer comme ID externe ou de les hacher à partir d’autres sources de données. Cela permet d’éviter les divergences dans les ID externes et de ne pas créer de profils utilisateurs en double dans Braze.

Étape 4.1 : Créez le méta-champ braze.external_id

1. Dans le panneau d’administration de Shopify, allez dans Paramètres > Métafields et métaobjets.
2. Sélectionnez Clients > Ajouter une définition.
3. Pour Nom, entrez braze.external_id.
4. Sélectionnez l’espace de noms et la clé générés automatiquement (custom.braze_external_id) pour les modifier et les remplacer par braze.external_id.
5. Pour Type, sélectionnez Type d’ID.

Une fois le métafichier créé, remplissez-le pour vos clients. Nous recommandons les approches suivantes :

• Écouter les webhooks de création de clients : Mettez en place un webhook pour écouter les événementscustomer/create . Cela vous permet d’écrire le méta-champ lors de la création d’un nouveau client.
• Renforcer la clientèle existante : Utilisez l’API Admin ou l’API Client pour remplir le métafichier pour les clients précédemment créés.

Étape 4.2 : Créer un endpoint pour récupérer votre ID externe

Vous devez créer un endpoint public que Braze peut appeler pour récupérer l’ID externe. Cela permet à Braze de récupérer l’ID dans des scénarios où Shopify ne peut pas fournir directement le métafield braze.external_id.

Spécifications des endpoints

Méthode : GET

Braze envoie les paramètres suivants à votre endpoint :

Exemple d’endpoint

1
GET https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

Réponse attendue

Braze attend un code de statut 200 renvoyant le JSON de l’ID externe :

1
2
3
{
  "external_id": "my_external_id"
}

Validation

Il est essentiel de valider que les adresses shopify_customer_id et email_address (le cas échéant) correspondent aux valeurs du client dans Shopify. Vous pouvez utiliser l’API d’administration de Shopify ou l’API client pour valider ces paramètres et récupérer le métafichier braze.external_id correct.

Comportement en cas d’échec et fusion

Tout code d’état autre que 200 est considéré comme un échec.

• Fusionner les implications : Si l’endpoint échoue (retour non200 ou dépassement de délai), Braze ne peut pas récupérer l’ID externe. Par conséquent, la fusion entre le profil utilisateur Shopify et le profil utilisateur Braze ne se fera pas à ce moment-là.
• Logique de réessai : Braze peut effectuer des tentatives immédiates standard sur le réseau, mais si l’échec persiste, la fusion sera reportée jusqu’au prochain événement admissible (par exemple, la prochaine fois que l’utilisateur mettra à jour son profil ou effectuera un paiement).
• Possibilité de prise en charge : Pour permettre la fusion des utilisateurs en temps voulu, assurez-vous que votre endpoint est hautement disponible et qu’il gère le champ facultatif email_address de manière gracieuse.

Étape 4.3 : Saisissez votre ID externe

Répétez l’étape 4 et saisissez l’URL de votre endpoint après avoir sélectionné l’ID externe personnalisé comme type d’ID externe Braze.

Considérations

• Si votre ID externe n’est pas généré lorsque Braze envoie une requête à votre endpoint, l’intégration utilisera par défaut l’ID du client Shopify lorsque la fonction changeUser sera appelée. Cette étape est cruciale pour fusionner le profil de l’utilisateur anonyme avec le profil de l’utilisateur identifié. Par conséquent, il peut y avoir une période temporaire pendant laquelle différents types d’ID externes existent dans votre espace de travail.
• Lorsque l’ID externe est disponible dans le métafichier braze.external_id, l’intégration donnera la priorité à cet ID externe et l’attribuera.
  • Si l’ID personnalisé de Shopify était précédemment défini comme l’ID externe de Braze, il sera remplacé par la valeur du métafield braze.external_id.

Étape 4.4 : Recueillir vos abonnements par e-mail ou SMS depuis Shopify (facultatif).

Vous avez la possibilité de collecter vos abonnements marketing par e-mail ou par SMS depuis Shopify.

Si vous utilisez les canaux e-mail ou SMS, vous pouvez synchroniser vos états d’abonnement au marketing parketeur sms et e-mail dans Braze. Si vous synchronisez des abonnements de marketing par e-mail depuis Shopify, Braze créera automatiquement un groupe d’abonnement e-mail pour tous les utilisateurs associés à ce magasin spécifique. Vous devez créer un nom unique pour ce groupe d’abonnement.

Étape 5 : Synchroniser les produits (facultatif)

Vous pouvez synchroniser tous les produits de votre boutique Shopify avec un catalogue Braze pour une personnalisation plus poussée des messages. Les mises à jour automatiques s’effectuent quasiment en temps réel, de sorte que votre catalogue contient des informations actualisées sur les produits. Pour en savoir plus, consultez le site Shopify product sync.

Étape 6 : Activer les canaux (facultatif)

Vous pouvez activer les messages in-app sans faire appel à un développeur en les configurant dans votre configuration.

Prise en charge de canaux SDK supplémentaires

Les SDK de Braze permettent d’utiliser différents canaux de messages, notamment les cartes de contenu.

Cartes de contenu et drapeaux de fonctionnalité

Pour ajouter des cartes de contenu ou des drapeaux de fonctionnalité, vous devrez collaborer avec vos développeurs pour insérer le code SDK nécessaire directement dans votre fichier theme.liquid. Pour obtenir des instructions détaillées, reportez-vous à la section Intégration SDK de Braze.

Notifications push Web

Le Web push n’est actuellement pas pris en charge pour l’intégration Shopify. Pour demander de l’aide, soumettez une demande de produit via le portail des produits de Braze.

Étape 7 : Terminer la configuration

1. Après avoir configuré votre intégration, sélectionnez Terminer la configuration.
2. Activez l’intégration de l’application Braze dans les paramètres de votre thème Shopify. Sélectionnez Open Shopify pour être redirigé vers votre compte Shopify afin d’activer l’intégration de l’application dans les paramètres du thème de votre boutique.

3. Après avoir activé l’intégration de l’app, votre configuration est terminée ! Confirmez vous pouvez consulter vos paramètres d’intégration, l’état de la synchronisation initiale des données et vos événements Shopify actifs.