Envoyer des liens de carte dans Email Studio

Générez des liens de carte Wallet Crew authentifiés 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. C’est le 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 fidélité un accès direct à la page de la 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 la 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 résout 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')
    set @expirationDate = DateAdd(Now(), '3', 'Y')
    set @secondsSinceEpoch = Multiply(DateDiff(@epochStart, Now(), 'MI'), 60)
    set @secondsToEnd = Multiply(DateDiff(@epochStart, @expirationDate, 'MI'), 60)

    set @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, '/pass?neo.authToken=', @jwt)
]%%

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

Utilisez l’identifiant du tenant The Wallet Crew comme @tenant.

Utilisez le domaine personnalisé du tenant comme @host lorsqu’un domaine personnalisé est configuré.

Utilisez un autre identifiant si nécessaire

L’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 de charge utile

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

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

Insérer le lien dans le contenu

Une fois @link 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 de la 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 les URL dynamiques.

Prévisualiser et valider

La validation doit être effectuée dans Content Builder avant que le bloc ne soit utilisé en production.

1

Prévisualiser avec un contact connu

Utilisez un contact de test avec un identifiant connu et affichez le contenu.

2

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

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

3

Ouvrir le lien sur un appareil de test

Confirmez que la page The Wallet Crew attendue 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 Email non vide.

utilisable.

Le lien est rejeté par The Wallet Crew Configuration.

Le mauvais contexte client s’ouvre

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

Le schéma 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. Tout 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 par défaut de la plateforme 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.