Un composant Viral permet au contact d'inviter ses amis à s'abonner, participer à un concours, etc. Ces composants sont également dits campagnes « Conseiller à un ami ». Le contact complète un formulaire avec des informations sur un ami (nom, adresse-mail, etc.). Ces informations doivent être vérifiées et stockées quelque part. Si le contact ne peut inviter qu'un seul ami dans le formulaire, la validation et le stockage des informations sont également possibles avec un Composant Données. Si le contact peut inviter plusieurs amis dans le formulaire, utilisez le composant Viral. Le composant Viral passe en boucle par chaque ensemble de données relatives aux amis (nom 1, adresse e-mail 1 - nom 2, adresse e-mail 2, etc.), les valide et crée une fiche pour chaque ami.
Ces fiches peuvent être créées dans la liste d'audience du contact ou dans une liste d'audience « Amis » séparée. La dernière est préférable car elle ne « pollue » pas la liste d'audience du contact avec des amis qui ne sont pas encore des contacts réels. Tant que l'ami du contact ne s'est pas abonné, vous ne pouvez pas communiquer avec lui, à part lui envoyer un e-mail d'invitation. L'e-mail d'invitation à chaque ami du contact peut aussi être envoyé avec le composant Viral. Par la suite, lorsque l'ami du contact cliquera sur le lien présent dans l'e-mail d'invitation, vous pourrez vérifier si c'est déjà un contact ou non.
Le composant Viral fonctionne en association avec le composant Parent viral (mais pas obligatoirement). Le composant Parent viral vous permet de repasser à l'inviteur, de le récompenser et de lui envoyer un e-mail l'informant que son ami a accepté son invitation. C'est pour cette raison qu'un composant Parent viral suivra toujours le composant Viral dans le même Journey.
Dans l'exemple ci-dessous, le contact invite 3 amis dans le formulaire « Inviter des amis ». Le composant Viral validera et stockera les données saisies pour chaque ami. Si ces opérations réussissent, le contact visualisera la page « Invitations envoyées ». Le déclencheur « Ami » du composant Viral passera au profil de l'ami et lui enverra l'e-mail d'invitation. Et ce pour chaque ami invité.
Vous pouvez utiliser un seul composant Viral pour inviterplusieursamis
Avant de traiter du composant Viral, voyons le formulaire d'invitation
Le composant Viral passe en boucle par chaque ensemble de données relatives aux amis (nom 1, adresse e-mail 1 - nom 2, adresse e-mail 2, etc.), les valide et crée une fiche pour chaque ami. Dans l'e-mail d'invitation, utilisez un numéro d'itération pour chaque ensemble de données sur les amis. Exemple de champ d'entrée du nom et de l'e-mail pour inviter 3 amis dans le formulaire :
<input name="NAME1" type="text " value="~@NAME1~" /> + <input name="MAIL1" type="text " value="~@MAIL1~" />
<input name="NAME2" type="text " value="~@NAME2~" /> + <input name="MAIL2" type="text " value="~@MAIL2~" />
<input name="NAME3" type="text " value="~@NAME3~" /> + <input name="MAIL3" type="text " value="~@MAIL3~" />
Dans Editor, ouvrez la boîte de texte des propriétés pour modifier les attributs de nom et de valeur du champ d'entrée.
Le composant Viral valide également l'ensemble des données de chaque ami. Tout comme pour un Composant Données, si la validation échoue, vous devrez renvoyer le contact au formulaire (déclencheur « Échec ») et afficher les messages d'erreur. Pour afficher les messages d'erreur individuels pour chaque ami, ~DATA_ERROR~ doit également avoir un numéro d'itération :
~DATA_ERROR1~, ~DATA_ERROR2~, ~DATA_ERROR3~, etc.
Vous pouvez continuer d'utiliser le ~DATA_ERROR~ général pour afficher les erreurs de validation générales : si le contact a indiqué deux fois le même ami ou s'il n'a pas invité assez d'amis (au moins 1).
Attributs du composant Viral
Événements
Le composant Viral génère les trois événements suivants :
- Succès : déclenché si tout le processus de validation des données a réussi et que les amis ont été stockés. Ce déclencheur continuera dans le Journey pour l'inviteur et non pour l'ami.
- Échec : La validation ou le stockage des données a échoué. La validation et le stockage sont définis dans les propriétés du composant Viral. Ce déclencheur continuera dans le Journey pour l'inviteur et non pour l'ami.
- Ami : Cet événement basculera vers le profil de l'ami. Toutes les opérations postérieures à ce déclencheur sont exécutées sur le profil de l'ami : stockage des données, recherche, etc. Mais aussi envoi d'un e-mail instantané à l'ami comme un e-mail d'invitation.
Propriétés
1. Sélectionnez la liste d'audience (maîtresse) ou une liste d'audience « Amis » liée 1 à plusieurs à mettre à jour avec les informations sur l'ami.
La dernière est préférable car elle ne « pollue » pas la liste d'audience du contact avec des amis qui ne sont pas encore des contacts réels. Cependant, cela complique quelque peu le travail sur les données de l'ami. Si l'ami s'abonne à la liste d'audience principale du contact, vous devrez vérifier s'il existe déjà dans cette liste d'audience et mettre à jour son profil. Autrement, vous devrez insérer une nouvelle fiche pour lui.
Pour sélectionner la liste d'audience « Amis » dans la liste déroulante « Liste liée », celle-ci doit être liée 1 à plusieurs à la liste d'audience du contact (maîtresse). Voir la rubrique Relations des listes pour en savoir plus sur la liaison des listes.
2. Sélectionnez ensuite un champ ou une combinaison de champs dans la liste sélectionnée à utiliser pour identifier l'ami comme étant unique. Cliquez sur le bouton ... situé à droite pour accéder à la liste des champs disponibles.
Généralement, le champ d'identification est MAIL. La plupart du temps, vous voulez des adresses e-mail uniques dans la liste d'audience « Amis ».
Si vous sélectionnez une combinaison, les deux valeurs doivent s'appliquer, MAIL et NAME par exemple : info@somedomain.com + John, n'est pas info@somedomain.com + Alan.
3. Puis définissez les messages d'erreur à afficher si la situation suivante se présente :
- Échec si le formulaire d'invitation envoyé contient deux fois le même contact. L'ami est identifié par les champs sélectionnés à l'étape 2. ci-dessus.
Le message d'erreur s'affiche dans le DATA_ERROR général. - Échec si le même contact a déjà été invité : À savoir, stocké dans la liste. L'ami est identifié par les champs sélectionnés à l'étape 2 ci-dessus. Vous pouvez choisir entre :
- « Par cette personne » : l'ami est stocké dans la liste et a été invité par ce contact (selon les champs de correspondance des relations des listes, ID sur PARENTID par exemple) ;
- « Par quiconque » : l'ami est stocké dans la liste.
Le message d'erreur s'affiche dans le DATA_ERROR spécifique à l'ami. E.g. ~DATA_ERROR1~, ~DATA_ERROR2~, ~DATA_ERROR3~,... - Un contact doit inviter au moins 'n' amis dans le formulaire. Par exemple, au moins 1.
Le message d'erreur s'affiche dans le DATA_ERROR général.
4. L'onglet « Validation » permet de vérifier les données publiées envoyées par le contact. Le numéro d'itération doit être remplacé par un « i » (minuscule)
Par exemple, la validation ci-dessous vérifie si le contact a rempli tous les champs du formulaire pour chaque ami (et que la syntaxe de l'e-mail est correcte) ou aucun. Sur l'onglet « Général », la validation garantit déjà que le contact a indiqué au moins 1 ami. Dans cet exemple, le formulaire ne transmet que 2 valeurs publiées par ami : @MAIL1,2,3 et @NAME1,2,3. Le numéro d'itération est remplacé par « i ». À savoir, @MAILiet @NAMEi.
Remarque : Le Traitement des amis dans l'onglet Général permet de déterminer le nombre minimum d'invitations d'amis et de gérer les entrées déjà existantes. Les contraintes de l'onglet Validation déterminent quant à elles si les amis ajoutés sont considérés comme valides ou non (en vérifiant le contenu de l'entrée réelle).
5. Sur l'onglet « Données » saisissez les valeurs à stocker dans la liste d'audience du contact (maîtresse) ou dans la liste d'audience « Amis » liée 1 à plusieurs selon le choix opéré sur l'onglet « Général ».
- Le ou les champs en jaune indiquent le ou les champs d'identification sélectionnés sur l'onglet « Général ». Une valeur doit être saisie pour ce ou ces champs.
- Le champ grisé indique le champ de correspondance de la relation entre la liste d'audience du contact (maîtresse) et la liste d'audience « Amis » liée 1 à plusieurs. Ci-dessous, ID sur FROM_USER_ID.
Voir la rubrique Relations des listes pour en savoir plus sur la liaison des listes.
- Stocker une fiche pour chaque invitation entrante : L'ami peut être stocké plusieurs fois dans la liste sélectionnée. Ce qui est préférable si vous utilisez une liste d'audience liée 1 à plusieurs pour stocker les amis. Après tout, le même ami peut être invité par différents contacts.
- Stocker une fiche par ami : L'ami est identifié par les champs sélectionnés à l'étape 2 ci-dessus. Si la fiche d'un ami existe déjà dans le même formulaire, les informations existantes sont laissées telles quelles (fiche ni créée ni mise à jour).
Avant de traiter du composant Viral, voyons l'email d'invitation
Le déclencheur « Ami » du composant Viral basculera vers le profil de l'ami. Toutes les opérations postérieures à ce déclencheur sont exécutées sur le profil de l'ami, y compris l'envoi de l'e-mail d'invitation. Le composant Viral exécutera ces opérations pour chaque ami. Par conséquent, les champs de personnalisation utilisés dans l'e-mail, comme ~NAME~, doivent faire référence à l'ami stocké dans la liste. Pour utiliser des champs de personnalisation pour l'inviteur, utilisez l'étendue VIRAL_PARENT, par exemple ~VIRAL_PARENT.FIRSTNAME~.
L'e-mail doit être un e-mailinstantané.
Remarque technique :
Le composant Parent viral a un événement « Parent » qui repasse à l'inviteur (parent). De retour sur le profil de l'inviteur, vous pouvez utiliser l'étendue VIRAL_FRIEND pour les champs de personnalisation de l'ami, par exemple ~VIRAL_FRIEND.NAME~.
