Skip to main content

Brancher SAP Emarsys

Titane se branche à SAP Emarsys par une clé API que vous créez dans votre compte : un Client ID et son secret. Seul le propriétaire du compte (account owner) peut en créer une.
1

Ouvrir les clés API

Management › Security Settings › API Credentials, puis Create API Credentials.
2

Choisir OpenID Connect

Choisissez OpenID Connect, pas WSSE : SAP retire WSSE fin 2026, et La Forge ne l’accepte pas. Nommez la clé « Titane — La Forge ».
3

Copier le Client ID et le secret

Copiez le Client ID et le Client secret. SAP Emarsys ne montre le secret qu’une fois : sans lui, il faut créer une nouvelle clé.
4

Activer les permissions

Sur la ligne de la clé, ouvrez ses permissions (icône d’édition) et activez une à une les six permissions ci-dessous, puis Save.
5

Les coller dans La Forge

Dans La Forge, page Données, carte SAP Emarsys, collez le Client ID et le secret. La Forge vérifie l’accès tout de suite, et nomme les permissions qui manquent.
Sur une clé neuve, toutes les permissions sont désactivées : sans elles, SAP Emarsys refuse l’accès. Titane ne se sert de la clé que pour lire vos contacts et y écrire les champs titan_* : il n’envoie aucun e-mail, ne déclenche aucun programme, ne crée aucun contact et n’en supprime aucun.

Les contacts que Titane met à jour

Titane écrit sur les contacts SAP Emarsys dont l’adresse e-mail, ou le numéro de mobile, est celle d’un client de votre boutique. Un contact qui ne correspond à aucun client n’est pas touché. Titane ne crée jamais de contact.

Les champs Titane

La première nuit en mode réel, Titane crée dans votre compte les champs de contact qui lui manquent, sous les noms de la référence, en minuscules : titan_cycle, titan_churn, titan_reco_1_nom… Vous n’avez rien à créer. Un champ que vous avez déjà créé sous le même nom est repris tel quel. Chez SAP Emarsys, Titane écrit les indicateurs, les axes d’audience, la sélection personnalisée de chaque client et trois listes de produits :
  • titan_recs, les identifiants des produits de sa sélection personnalisée ;
  • titan_complementary, les identifiants des compléments de son dernier achat (TITAN-LINK) ;
  • titan_replenishment, les identifiants des produits qu’il devrait bientôt racheter.
Chaque champ est créé avec son type SAP Emarsys : Les listes rangent les produits dans l’ordre : le premier est le plus recommandé. Elles portent l’identifiant de chaque produit dans votre boutique, le même que titan_reco_{n}_id, mais ni son nom, ni son prix, ni son image : elles servent à cibler. Pour afficher un produit dans un e-mail, gardez les champs titan_reco_{n}_…. Un champ vide est vidé sur le contact, liste comprise : un client sans résultat n’a pas de valeur, ce qui n’est pas un zéro. Vos champs Titane se retrouvent dans le Field Editor (Management › Data Management).
SAP Emarsys limite le nombre de champs de contact par compte, type par type. Titane en crée 49. Si votre compte n’a plus de place pour l’un d’eux, La Forge vous le signale : libérez des champs dont vous ne vous servez plus dans le Field Editor, puis attendez la nuit suivante.

Pas de modèle Titane chez SAP Emarsys

Titane ne pose pas de modèle chez SAP Emarsys : vous composez vos e-mails dans SAP Emarsys, et vous y insérez les champs Titane.

Insérer un champ Titane dans un e-mail

SAP Emarsys désigne un champ par son numéro, pas par son nom : un champ s’insère sous la forme {{ contact.12345 }}, où 12345 est le numéro du champ dans votre compte. Pour le connaître, créez un jeton de personnalisation :
1

Créer le jeton

Content › Personalization › Create Token › Contact Data.
2

Choisir le champ

Donnez-lui un nom parlant, par exemple « Titane · Reco 1 · nom », une catégorie (« Titane »), puis choisissez le champ titan_reco_1_nom dans Field.
3

Relever le code

La ligne Personalization token affiche le code à coller, par exemple {{ contact.12345 }}. Enregistrez.
Dans l’éditeur par blocs (Block-Based Email), le jeton s’insère avec l’icône Personalization d’un bloc de texte, dans la fenêtre Insert Personalization Token ; Fallback text y donne un texte de repli quand le champ est vide. Dans un e-mail en HTML (Custom HTML Email), collez directement le code.
N’utilisez pas les anciens codes en $…$ dans le même e-mail : SAP Emarsys peut en bloquer l’envoi. Les anciens e-mails à modèle (Template-Based Email) ne lisent pas cette écriture : partez d’un e-mail par blocs ou en HTML.

Cibler

Contacts › Segments › Create Segment › Standard Segment, puis le segment de contacts (Contact, Email behavior, Geo, Smart Insight segment). Avec Add Criterion, chaque champ titan_* s’utilise comme vos autres champs, parmi les critères de contact : Equal, Is not empty, Greater than, Less than… Terminez par Save and Calculate. Des idées de cibles sont dans Les segments Titane. Une liste se cible par Contains, avec l’identifiant du produit entre deux virgules : titan_recs Contains ,8817234, retient les clients dont la sélection contient ce produit, quel que soit son rang. Les virgules évitent de confondre 1234 avec 81234. De la même façon, titan_complementary retient les clients à qui ce produit irait bien en complément, et titan_replenishment ceux qui devraient bientôt le racheter. Titane ne crée pas de segment « TITAN · … » chez SAP Emarsys : vous construisez ceux dont vous avez besoin. Un champ vide ne remplit aucune condition, sauf Is empty.

Déclencher

Dans Automation › Automation Programs › Create Program, partez d’un parcours par audience (Audience-based journeys). Deux entrées servent avec Titane :
  • Data Change : le programme part quand un champ change de valeur, par exemple titan_cycle. Un Quick Filter juste après ne garde que la valeur qui vous intéresse, comme DECROCHAGE.
  • Recurring : le programme passe chaque jour sur un segment, par exemple les clients dont titan_reassort est égal à du. Réglez Participation, en bas du canevas, avant de lancer le programme : elle ne se change plus ensuite.
Titane met les champs à jour la nuit, et Data Change part dans la foulée. SAP recommande une attente (Wait) d’un quart d’heure juste après l’entrée ; ajoutez-en une de quelques heures avant le premier e-mail, pour qu’il n’arrive pas en pleine nuit.
Data Change ne prend que les clients dont le champ change après le lancement. Ceux qui sont déjà dans la situation n’y entrent pas : pour eux, envoyez une fois une campagne ciblée sur le même segment.

Les modèles TITAN de vos cas d’usage

Chaque cas d’usage s’appuie sur un modèle TITAN : TITAN-REC choisit la sélection personnalisée de chaque client, TITAN-CORE situe chaque client dans son parcours et repère ses réassorts. Les compléments du dernier achat (TITAN-LINK) arrivent chez SAP Emarsys dans la liste titan_complementary : de quoi cibler les clients à qui un produit irait bien, mais pas de quoi afficher ces compléments dans un e-mail. Le même tableau, pour tous les CRM, est dans Les recommandations produits.

Quatre cas d’usage

Envoyer une sélection personnalisée

Un e-mail où chaque client voit ses propres produits.

Reconquérir les clients qui décrochent

Un programme qui part dès qu’un client sort de son rythme.

Rappeler un réassort

Un rappel quand un produit arrive à épuisement.

Provoquer la deuxième commande

Faire revenir les clients d’une seule commande, au bon moment.