Envoyer des liens de Carte dans Email Studio

Générez des liens de Carte authentifiés de Wallet Crew dans Salesforce Marketing Cloud Email Studio avec AMPscript.

Email Studio peut distribuer des liens authentifiés qui ouvrent la bonne page The Wallet Crew pour chaque contact. Il s'agit du schéma standard pour les e-mails de téléchargement de Carte, de rappel et de réactivation.

Terminé Configuration avant de créer le bloc de contenu.

Exemples concrets

• Un e-mail de bienvenue donne à un nouveau membre de fidélité un accès direct à la page de Carte.
• Un e-mail de rappel cible les contacts qui n'ont toujours pas installé la Carte.
• Un e-mail de réactivation ouvre la page de Carte sans étape de connexion séparée.

Comment fonctionnent les liens de Carte dans Email Studio

Le lien est un JWT signé dans Salesforce Marketing Cloud. La charge utile contient un identifiant client connu de The Wallet Crew.

Lorsque l'e-mail est ouvert, The Wallet Crew vérifie le jeton et détermine le bon contexte client.

Créer le bloc AMPscript

L’exemple ci-dessous signe un jeton avec l’e-mail du contact.

Exemple AMPscript

%%[
    var @tenant, @keyId, @json, @jwt, @email, @host
    var @epochStart, @expirationDate, @secondsSinceEpoch, @secondsToEnd

    set @keyId = '0000-00000000-0000000000-0000'
    set @tenant = 'xxx'
    set @email = Email
    set @host = 'https://app.thewalletcrew.io'

    set @epochStart = DateParse('1970/01/01 00:00AM')
    définir @expirationDate = DateAdd(Now(), '3', 'Y')
    définir @secondsSinceEpoch = Multiply(DateDiff(@epochStart, Now(), 'MI'), 60)
    définir @secondsToEnd = Multiply(DateDiff(@epochStart, @expirationDate, 'MI'), 60)

    définir @json = '{
        "email":"@email",
        "nbf": @secondsSinceEpoch,
        "exp": @secondsToEnd,
        "iat": @secondsSinceEpoch,
        "iss": "neostore.cloud",
        "aud": "@tenant"
    }'

    set @json = Replace(@json, '@secondsSinceEpoch', @secondsSinceEpoch)
    set @json = Replace(@json, '@secondsToEnd', @secondsToEnd)
    set @json = Replace(@json, '@tenant', @tenant)
    set @json = Replace(@json, '@email', @email)

    set @jwt = GetJWTByKeyName(@keyId, 'HS256', @json)
    set @link = Concat(@host, '/', @tenant, '/Carte?neo.authToken=', @jwt)
]%%

Utilisez la valeur de la clé externe Salesforce Marketing Cloud créée pendant Configuration comme @keyId.

Utilisez l'identifiant du locataire de l'équipe Wallet comme @tenant.

Utilisez le domaine personnalisé du locataire comme @host lorsqu'un domaine personnalisé est configuré.

Utilisez un autre identifiant si nécessaire

L'adresse e-mail n'est pas le seul identifiant pris en charge. Tout identifiant externe déjà connu de The Wallet Crew peut être utilisé.

Par exemple, un identifiant client Cegid Y2 peut remplacer la revendication e-mail.

Exemple de revendication du payload

"https://neostore.cloud/customer/identifiers:id.y2.customerId":"@customerId"

@customerId est le champ Salesforce Marketing Cloud qui stocke l’identifiant Y2.

Insérez le lien dans le contenu

Une fois @link est généré, Content Builder peut l’associer à un lien texte, une image ou un bouton.

Un exemple minimal ressemble à ceci.

Extrait de contenu d’e-mail

%%[
  /* Insérez le bloc AMPscript ci-dessus */
]%%

<a href="%%=RedirectTo(@link)=%%">Ouvrir la page Carte</a>

Le même lien peut être réutilisé dans un bloc d’e-mail, un extrait réutilisable ou un message SMS lorsque le canal prend en charge des URL dynamiques.

Prévisualiser et valider

La validation doit avoir lieu dans Content Builder avant que le bloc ne soit utilisé en production.

1

Prévisualiser avec un contact connu

Utilisez un contact de test doté d’un identifiant connu et affichez le contenu.

2

Vérifiez l’URL générée

Confirmez que l’URL affichée contient un élément non vide neo.authToken valeur.

3

Ouvrez le lien sur un appareil de test

Confirmez que la page attendue de The Wallet Crew s’ouvre pour le bon client.

Dépannage

Le lien s’affiche, mais le jeton est vide

Vérifiez le champ source utilisé dans AMPscript.

Pour les liens basés sur l’e-mail, confirmez que l’enregistrement du contact expose un E-mail valeur.

Le lien est rejeté par The Wallet Crew

Confirmez que la clé symétrique Salesforce Marketing Cloud correspond au secret The Wallet Crew configuré lors de Configuration.

Le mauvais contexte client s’ouvre

Vérifiez l’identifiant utilisé dans la charge utile JWT.

Le modèle le plus sûr est un identifiant externe stable déjà stocké dans The Wallet Crew.

FAQ

L’e-mail est-il le seul identifiant pris en charge ?

Non. N’importe quel identifiant déjà connu de The Wallet Crew peut être utilisé.

L’e-mail n’est que le point de départ le plus courant.

Le lien doit-il pointer vers le domaine de la plateforme ou vers un domaine personnalisé ?

Utilisez le domaine personnalisé du tenant lorsqu’il est configuré.

Sinon, utilisez le domaine de plateforme par défaut de The Wallet Crew.

Le même lien peut-il être réutilisé dans les SMS ?

Oui, lorsque le canal Salesforce Marketing Cloud prend en charge le rendu dynamique des URL.

Le même modèle de lien authentifié peut être réutilisé en dehors d’Email Studio.