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 dans 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 Shopify, installez l’application Braze.
   
   

4. Après avoir installé l’application 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 en changer, sélectionnez le bon.
   
   

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 implémenter automatiquement le SDK Web et le SDK JavaScript de Braze.

Après avoir sélectionné le parcours d’onboarding standard, vous devrez choisir le moment où Braze doit s’initialiser et charger les SDK parmi les options suivantes :

• Lors de la visite du site, par exemple au début de la session
  • Suit les utilisateurs identifiés et anonymes
• Lors de l’inscription au compte, par exemple lors de la connexion au compte
  • Suit uniquement les utilisateurs identifiés
  • Commence le suivi des 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 Shopify.

Configuration du remplissage 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 la connexion de votre intégration Shopify. Pour ce faire, cochez la case pour inclure le chargement initial des données dans votre intégration.

Ce tableau contient les données qui seront initialement chargées via le remplissage.

Lorsque vos enregistrements de clients Shopify sont chargés dans Braze, l’ID client Shopify est 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 de cette intégration. Les événements personnalisés capturent les interactions uniques dans votre boutique, comme par exemple :

Le suivi des données personnalisées permet d’obtenir des informations plus approfondies sur le comportement des utilisateurs et favorise une personnalisation supplémentaire. Pour implémenter 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 vérifie si l’utilisateur actuel s’abonne à une newsletter et enregistre cela comme é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 de l’utilisateur pour enregistrer des événements ou 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 gestion de vos utilisateurs

Sélectionnez votre type d’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 avant 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 utilisateur en double dans Braze.

Étape 4.1 : Créer 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éta-champ 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énements customer/create. Cela vous permet d’écrire le méta-champ lors de la création d’un nouveau client.
• Remplir pour les clients existants : Utilisez l’API Admin ou l’API Client pour remplir le méta-champ 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 les scénarios où Shopify ne peut pas fournir directement le méta-champ braze.external_id.

Spécifications de l’endpoint

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 shopify_customer_id et email_address (le cas échéant) correspondent aux valeurs du client dans Shopify. Vous pouvez utiliser l’API Admin de Shopify ou l’API Client pour valider ces paramètres et récupérer le méta-champ braze.external_id correct.

Comportement en cas d’échec et fusion

Tout code de statut autre que 200 est considéré comme un échec.

• Implications pour la fusion : Si l’endpoint échoue (renvoie un code autre que 200 ou expire), 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 nouvelle tentative : 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 éligible (par exemple, la prochaine fois que l’utilisateur mettra à jour son profil ou effectuera un paiement).
• Disponibilité : 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 appropriée.

É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 client Shopify lorsque la fonction changeUser est 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 coexistent dans votre espace de travail.
• Lorsque l’ID externe est disponible dans le méta-champ braze.external_id, l’intégration donnera la priorité à cet ID externe et l’attribuera.
  • Si l’ID client Shopify était précédemment défini comme l’ID externe de Braze, il sera remplacé par la valeur du méta-champ 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 par e-mail et par SMS dans Braze. Si vous synchronisez des abonnements marketing par e-mail depuis Shopify, Braze créera automatiquement un groupe d’abonnement e-mail pour tous les utilisateurs associés à cette boutique 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 de vos messages. Les mises à jour automatiques s’effectuent quasiment en temps réel, de sorte que votre catalogue reflète des informations produit à jour. Pour en savoir plus, consultez la synchronisation des produits Shopify.

Étape 6 : Activer les canaux (facultatif)

Vous pouvez activer les messages in-app sans faire appel à un développeur en les configurant directement lors de la mise en place.

Prise en charge de canaux SDK supplémentaires

Les SDK de Braze permettent d’utiliser différents canaux de communication, notamment les Content Cards.

Content Cards et indicateurs de fonctionnalité

Pour ajouter des Content Cards ou des indicateurs 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 du SDK de Braze.

Notifications push web

Les notifications push web ne sont actuellement pas prises en charge pour l’intégration Shopify. Pour demander cette fonctionnalité, soumettez une demande de produit via le portail du produit 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 Ouvrir 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’application, votre configuration est terminée ! Vérifiez que vous pouvez consulter vos paramètres d’intégration, l’état de la synchronisation initiale des données et vos événements Shopify actifs.