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 vous permet d’obtenir des informations plus approfondies sur le comportement des utilisateurs et de personnaliser encore davantage leur expérience. 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.

Si vous avez sélectionné un type d’ID externe personnalisé, passez aux étapes 4.1 et 4.2. Sinon, passez à l’étape 4.3.

Étape 4.1 : Créez un fichier personnalisé external_id

Tout d’abord, allez sur Shopify et créez le méta-champ braze.external_id. Nous vous recommandons de suivre les étapes de la section Création de méta-champs personnalisés. Pour l’espace de noms et la clé, entrez braze.external_id. Pour le type, nous vous recommandons de choisir un type d’ID.

Après avoir créé le métafichier, écoutez les webhookscustomer/create afin de pouvoir écrire le métafichier lorsqu’un nouveau client est créé. Ensuite, utilisez l’API Admin ou l’API Client pour ajouter ce méta-champ à tous les clients que vous avez créés précédemment.

Étape 4.2 : Créer un endpoint

Vous avez besoin d’un endpoint GET public pour récupérer votre ID externe. Si Shopify ne peut pas fournir le métafield, Braze appellera ce endpoint pour récupérer l’ID externe.

Voici un exemple d’endpoint : https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

Réponse

Braze attend un code de statut 200. Tout autre code est considéré comme une défaillance de l’endpoint. La réponse devrait être :

1
{ "external_id": "my_external_id" }

Validez le site shopify_customer_id et l’adresse e-mail en utilisant l’API Admin ou l’API Client pour confirmer que les valeurs des paramètres correspondent aux valeurs du client dans Shopify. Après validation, vous pouvez également utiliser les API pour récupérer le métafichier braze.external_id et renvoyer la valeur de l’ID externe.

Étape 4.3 : 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 reflète toujours les détails les plus récents 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

L’intégration de Shopify ne prend actuellement pas en charge le Web Push. Si vous souhaitez que ce produit soit pris en charge à l’avenir, soumettez une demande de produit via le portail des produits de Braze.

Si vous souhaitez qu’il soit pris en charge à l’avenir, 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.