Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

GrowSurf

GrowSurf envoie les données des participants de programmes de recommandation et d’affiliation vers les profils utilisateur Braze. L’intégration ajoute les liens de recommandation, les détails des participants, les nombres de recommandations, d’invitations, d’impressions et la progression des jalons en tant qu’attributs personnalisés que vous pouvez utiliser pour la segmentation Braze et la personnalisation Liquid.

Cette intégration est maintenue par GrowSurf.

À propos de l’intégration

GrowSurf est un logiciel de programmes de recommandation et d’affiliation. L’intégration unidirectionnelle maintient les données de recommandation des participants GrowSurf disponibles dans Braze afin que vous puissiez segmenter les participants, personnaliser les messages avec les liens de recommandation et la progression, et envoyer des communications de programme pertinentes depuis Braze.

Cas d’usage

Ajouter le lien de recommandation de chaque participant aux messages Braze.
Créer des segments à partir du statut de recommandation, du nombre de recommandations et de la progression des jalons.
Personnaliser les Campaigns et les Canvas avec les attributs des participants et des parrains.

Prérequis

Avant de commencer, vous avez besoin des éléments suivants :

Prérequis	Description
Un compte GrowSurf	Un abonnement payant GrowSurf est requis pour cette intégration.
Une clé API REST Braze	Une clé API REST Braze avec les permissions `users.track`. Créez cette clé dans le tableau de bord de Braze depuis Paramètres > API et identifiants > Clés API. Pour plus d’informations, consultez Créer des clés API REST.
Un endpoint REST Braze	L’URL de votre endpoint REST Braze (par exemple, `https://rest.iad-01.braze.com`). Pour plus d’informations, consultez Endpoints de la REST API.

Intégration

Suivez ces étapes pour connecter un programme GrowSurf à Braze. Pour des instructions détaillées, consultez la documentation de l’intégration GrowSurf avec Braze.

Étape 1 : Créer une clé API REST Braze

Dans Braze, accédez à Paramètres > API et identifiants > Clés API.
Créez une clé API REST avec les permissions users.track.
Copiez la clé API et notez l’endpoint REST pour le même espace de travail Braze.

Étape 2 : Connecter Braze dans GrowSurf

Dans GrowSurf, accédez à Program Editor > 4. Options > Integrations > Braze.
Sélectionnez l’endpoint REST Braze correspondant.
Saisissez la clé API REST et sélectionnez Submit.

Étape 3 : Vérifier la première synchronisation d’un participant

Ajoutez ou mettez à jour un participant de test dans GrowSurf.
Dans Braze, accédez à Audience > Recherche d’utilisateurs et recherchez par e-mail pour ouvrir le profil utilisateur correspondant.
Confirmez que les attributs personnalisés grsf_ apparaissent sur le profil.

Attributs GrowSurf dans Braze

GrowSurf met 15 attributs de recommandation à disposition dans Braze. La première synchronisation envoie l’ensemble complet. Par la suite, GrowSurf envoie des mises à jour lorsque les données d’un participant changent. Si une valeur est supprimée dans GrowSurf, l’attribut Braze correspondant est également effacé. Les valeurs de comptage sont envoyées sous forme de nombres.

Attributs de type chaîne de caractères

Attribut personnalisé	Description
`grsf_share_url`	L’URL de partage de recommandation du participant.
`grsf_participant_id`	L’identifiant GrowSurf du participant.
`grsf_referral_status`	Le statut de recommandation du participant.
`grsf_participant_first_name`	Le prénom du participant.
`grsf_participant_last_name`	Le nom de famille du participant.
`grsf_referrer_first_name`	Le prénom du parrain.
`grsf_referrer_last_name`	Le nom de famille du parrain.
`grsf_referrer_email`	L’adresse e-mail du parrain.
`grsf_next_milestone`	Le prochain jalon vers lequel le participant progresse.
`grsf_next_monthly_milestone`	Le prochain jalon mensuel vers lequel le participant progresse.

Attributs de type nombre

Attribut personnalisé	Description
`grsf_total_referral_count`	Le nombre total de recommandations du participant.
`grsf_monthly_referral_count`	Le nombre de recommandations du participant pour le mois en cours.
`grsf_prev_monthly_referral_count`	Le nombre de recommandations du participant pour le mois précédent.
`grsf_total_invite_count`	Le nombre total d’invitations du participant.
`grsf_total_impression_count`	Le nombre total d’impressions du lien de recommandation du participant.

Utiliser GrowSurf avec Braze

Utilisez les attributs de recommandation GrowSurf pour la segmentation Braze et la personnalisation Liquid. GrowSurf met à jour ces attributs lorsqu’un participant est ajouté ou lorsque ses données de recommandation changent. Vous pouvez également synchroniser les participants qui étaient déjà dans votre programme.

Étape 1 : Créer des segments

Dans Braze, créez un segment avec les attributs personnalisés grsf_ pertinents.
Ciblez ou excluez des participants en fonction du statut de recommandation, du nombre de recommandations ou de la progression des jalons.

Étape 2 : Personnaliser les messages

Ajoutez l’attribut personnalisé grsf_share_url à un message Braze avec Liquid : {{custom_attribute.${grsf_share_url}}}.

Utilisez les autres attributs grsf_ pour personnaliser le statut de recommandation, les compteurs et la progression des jalons.

Considérations

GrowSurf envoie uniquement des attributs personnalisés. Il n’envoie pas d’événements personnalisés, d’achats ni de changements d’abonnement.
GrowSurf identifie les profils Braze par l’e-mail du participant. Si aucun profil correspondant n’existe, Braze crée un profil avec l’e-mail uniquement.
Si le même e-mail appartient à des participants dans plusieurs programmes GrowSurf connectés, les données du programme synchronisé le plus récemment apparaissent sur ce profil Braze.
Connectez Braze avant d’importer des participants. Pour synchroniser les participants existants, utilisez l’option de synchronisation des participants existants de GrowSurf.

Résolution des problèmes

Confirmez que la clé API REST Braze dispose des permissions users.track et que l’endpoint REST sélectionné appartient au même espace de travail Braze.
Si un participant ne parvient pas à se synchroniser, vérifiez que le participant possède une adresse e-mail valide.
Consultez les journaux d’activité du participant dans GrowSurf pour le résultat de la synchronisation.
GrowSurf réessaie automatiquement en cas d’erreurs temporaires de Braze. Si GrowSurf ne peut pas confirmer une mise à jour, il envoie tous les attributs de recommandation lors de la prochaine synchronisation de ce profil Braze. Si la clé API ou l’endpoint REST est invalide, corrigez les paramètres et reconnectez l’intégration.

Pour plus de détails sur la résolution des problèmes, consultez la documentation de l’intégration GrowSurf avec Braze.

New Stuff!