Yotpo
Yotpo, une plateforme leader de marketing e-commerce, aide des milliers de marques innovantes à accélérer la croissance de leurs ventes directes aux consommateurs. L’approche de plateforme unique de Yotpo intègre des solutions axées sur les données pour les avis, la fidélisation, le marketing SMS et plus encore, donnant aux marques les moyens de créer des expériences clients plus intelligentes et à plus fort taux de conversion.
Grâce à l’intégration de Braze et de Yotpo, vous pouvez tirer et afficher de manière dynamique les évaluations par étoiles, les meilleurs avis et le contenu visuel généré par les utilisateurs (CGU) sur les produits dans les e-mails et les autres canaux de communication de Braze. Vous pouvez également inclure les données de fidélisation au niveau du client dans les e-mails et autres méthodes de communication afin de créer une interaction plus personnalisée, ce qui stimule les ventes et la fidélisation.
Prérequis
Condition | Descriptif |
---|---|
Compte Yotpo | Un compte Yotpo est nécessaire pour bénéficier de ce partenariat. |
Clé API des commentaires Yotpo | Cette API sera mise en œuvre dans l’extrait de code Contenu connecté. Pour plus d’informations, reportez-vous à la section Trouver votre clé d’application Yotpo et votre clé secrète. |
Clé API de fidélisation Yotpo | Cette clé API et ce GUID seront mis en œuvre dans l’extrait de code du contenu connecté. Pour plus d’informations, reportez-vous à la section Trouver votre clé API et votre GUID pour la fidélisation et les recommandations. |
Avant de continuer, confirmez que l’ID du produit Yotpo est le même que le product_id
qui sera extrait dynamiquement de Braze. Cette étape est obligatoire pour que l’intégration fonctionne.
Pour trouver votre ID de produit Yotpo, procédez comme suit :
- Allez sur le site web de votre magasin.
- Ouvrez la page du produit.
- Cliquez avec le bouton droit de la souris et sélectionnez Inspecter.
- Appuyez sur Control + F et recherchez
yotpo-main
dans le code. La variabledata-product ID
et sa valeur apparaissent dans la div Yotpo.
Intégration
Pour intégrer Yotpo et Braze, procédez comme suit :
- Rendez-vous sur votre tableau de bord de Braze.
- Sur la page Campagnes, cliquez sur Créer une campagne et sélectionnez E-mail.
- Sélectionnez le modèle de votre choix.
- Cliquez sur Modifier le corps de l’e-mail et ajoutez l’extrait de contenu connecté correspondant à votre cas d’utilisation :
Afficher le nombre d’étoiles et le nombre d’avis sur un produit
Utilisez cet extrait de code pour fournir la note moyenne publique et le nombre d’avis totaux pour un produit inclus dans l’e-mail :
1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/products/<YOTPO-API-KEY>/{{event_properties.${product_id}}}/bottomline :save result %}
{% if {{result.response.bottomline.average_score}} != 0 %}
The average rating for this product is:
{{result.response.bottomline.average_score}}/5, based on {{result.response.bottomline.total_reviews}} reviews.
{% else %}
{% endif %}
Remplacez <YOTPO-API-KEY>
par votre clé API pour les commentaires de Yotpo. Le site product_id
sera tiré dynamiquement de Braze. Pour que l’intégration fonctionne, le paramètre product_id
dans Braze doit correspondre à l’ID du produit dans Yotpo (généralement l’ID du produit parent en ligne).
Afficher un récent avis 5 étoiles sur un produit
Utilisez cet extrait de code pour fournir un avis de haut niveau (publié) sur un produit spécifique qui est inclus dans l’e-mail :
1
2
3
4
5
6
7
8
9
10
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/products/{{event_properties.${product_id}}}/reviews.json?per_page=50&star=5&sort=votes_up :save result %}
{% if {{result.response.reviews[0].score}} == 5 %}
Recent 5 Star Review for this product:
{{result.response.reviews[0].content}}
{% else %}
{% endif %}
Remplacez <YOTPO-API-KEY>
par votre clé API pour les commentaires de Yotpo. Le site product_id
sera tiré dynamiquement de Braze. Pour que l’intégration fonctionne, le paramètre product_id
dans Braze doit correspondre à l’ID du produit dans Yotpo (généralement l’ID du produit parent en ligne).
Voici à quoi ressemblera l’extrait de code dans votre éditeur d’e-mail :
Afficher les CGU visuels par produit
Utilisez cet extrait de code pour récupérer les images Yotpo étiquetées et publiées et les ajouter à vos e-mails à la place de l’image de stock ou en tant que galerie supplémentaire :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% connected_content https://api.yotpo.com/v1/widget/<YOTPO-API-KEY>/albums/product/{{event_properties.${product_id}}}?per_page=1 :save result %}
{% if {{result.response.images[0].tagged_products[0].image_url}} != null %}
The Visual content of the product:
<img src="{{result.response.images[0].tagged_products[0].image_url}}" border="0" width="200" height="200" alt="" />
{% else %}
Image return NULL
{% endif %}
Remplacez <YOTPO-API-KEY>
par votre clé API pour les commentaires de Yotpo. Le site product_id
sera tiré dynamiquement de Braze. Pour que l’intégration fonctionne, le paramètre product_id
dans Braze doit correspondre à l’ID du produit dans Yotpo (généralement l’ID du produit parent en ligne).
L’extrait de code ressemblera à ceci :
Afficher le solde du programme de fidélité d’un client dans un e-mail
Utilisez cet extrait de code pour récupérer le solde de points de fidélité d’un client et l’utiliser dans votre envoi de messages e-mail :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{% connected_content
https://loyalty.yotpo.com/api/v2/customers?customer_email=**{{${email_address}}}**
:method get
:headers {
"x-guid": "<YOTPO-LOYALTY-GUID>",
"x-api-key": "<YOTPO-LOYALTY-API-KEY>"
}
:content_type application/json
:save publication
%}
You have {{publication.points_balance}} points
Only {{publication.vip_tier_upgrade_requirements.points_needed}} more points to become part of our VIP Tier!
Remplacez <YOTPO-LOYALTY-GUID>
et <YOTPO-LOYALTY-API-KEY>
par vos identifiants de fidélité Yotpo. Le site email_address
est tiré dynamiquement de Braze. Pour que l’intégration fonctionne, l’adresse e-mail doit être celle du client qui reçoit l’e-mail.
L’extrait de code ressemblera à ceci :
Questions fréquemment posées
Que se passe-t-il si je n’ai pas d’avis 5 étoiles ?
Si vous n’avez pas d’avis 5 étoiles (par exemple si la réponse de l’endpoint renvoie NULL pour l’avis 5 étoiles), aucun contenu ne sera affiché.
Que faire si je n’ai pas d’image publiée pour un produit ?
Si vous n’avez pas d’images pour un produit (par exemple si la réponse de l’endpoint renvoie NULL pour l’image du produit), aucun contenu ne sera affiché.
Puis-je personnaliser l’apparence, ou extraire d’autres champs de données de Yotpo ?
Oui ! Pour découvrir les autres points de données et les options de personnalisation disponibles, reportez-vous à la section Effectuer un appel API. Pour ce faire, vous aurez peut-être besoin de l’aide d’un développeur.
Yotpo ne prend pas en charge les exigences personnalisées au-delà de ce qui est décrit dans ce guide.