> ## Documentation Index
> Fetch the complete documentation index at: https://docs.titane-intelligence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adobe Campaign : bien démarrer

> Brancher Adobe Campaign à La Forge, importer le kit Titane, retrouver les champs Titane sur vos destinataires, puis vous en servir dans vos requêtes, vos workflows et vos diffusions.

![Adobe Campaign](https://docs.titane-intelligence.com/logos/adobe-campaign.png)

**Adobe Campaign**
· CRM et e-mailing

La Forge se branche à **Adobe Campaign Classic v7** et à **Adobe Campaign v8**, la console que votre équipe utilise déjà. Titane y lit vos diffusions et leurs statistiques, vos workflows et vos destinataires, et y écrit chaque nuit les champs `titan_*` sur vos destinataires.

## Brancher Adobe Campaign

Vous n'avez pas à connaître l'adresse de votre Campaign : dans La Forge, page **Données**, carte **Adobe Campaign**, collez **le lien d'une de vos newsletters** (un bouton, ou « Voir la version en ligne » : clic droit › Copier l'adresse du lien). La Forge y trouve votre Campaign et sa version. Votre administrateur Campaign peut aussi coller l'adresse de la console.

Puis choisissez une des deux façons d'ouvrir l'accès à La Forge.

> [tab] Compte technique Adobe
>
> Recommandé, et seul possible sur Campaign v8. Il faut l'administrateur Adobe de votre entreprise (Admin Console) et l'administrateur Campaign.
>
> **1. Créer le projet**
>
> Dans **Adobe Developer Console** (developer.adobe.com/console), créez un projet « Titane — La Forge ».
>
> **2. Ajouter l'API Adobe Campaign**
>
> Ajoutez l'API **Adobe Campaign**, choisissez **OAuth Server-to-Server**, puis le profil de produit de votre instance marketing : pas celui qui finit par « messagecenter ». Ajoutez aussi l'API **I/O Management API**. Enregistrez.
>
> **3. Copier les identifiants**
>
> Dans la section **OAuth Server-to-Server**, copiez le **Client ID** et le **Client secret** (bouton **Retrieve client secret**). Les scopes, La Forge les règle seule ; si Adobe les refuse, collez la ligne **Scopes** du credential dans les réglages avancés du formulaire.
>
> **4. Les coller dans La Forge**
>
> Collez-les avec le lien de votre newsletter, puis **Vérifier et connecter**. Ce premier appel crée dans Campaign l'opérateur technique de La Forge.
>
> **5. Donner ses droits à l'opérateur**
>
> Dans la console Campaign, **Administration** › **Gestion des accès** › **Opérateurs**, donnez à cet opérateur, ou à un groupe « Titane — La Forge », les droits du tableau ci-dessous. Puis, dans La Forge, **Vérifier maintenant**.

> [tab] Opérateur dédié
>
> Pour Campaign Classic v7 seulement : l'administrateur Campaign suffit. Adobe n'accepte plus l'identifiant et le mot de passe à partir de Campaign v8.6.
>
> **1. Créer l'opérateur**
>
> Dans la console Campaign, **Administration** › **Gestion des accès** › **Opérateurs**, créez un opérateur `titane_la_forge` réservé à La Forge, avec un mot de passe long.
>
> **2. Lui donner ses droits**
>
> Les droits du tableau ci-dessous, et rien d'autre.
>
> **3. Le limiter à La Forge**
>
> Dans l'onglet **Sécurité** de l'opérateur, limitez sa zone de sécurité à l'adresse de La Forge, indiquée dans le guide de La Forge.
>
> **4. Le coller dans La Forge**
>
> Collez son identifiant et son mot de passe avec le lien de votre newsletter, puis **Vérifier et connecter**.

| Ce que La Forge lit ou écrit | Accès |
| - | - |
| les diffusions | lecture |
| les workflows | lecture |
| les opérations (campagnes) | lecture |
| les destinataires | lecture |
| les logs de tracking et d'envoi | lecture |
| les champs `titan_*` des destinataires | écriture |

La Forge vérifie l'accès tout de suite et nomme d'un coup tout ce qu'elle ne peut pas lire.

> [!NOTE]
>
> Si votre Campaign filtre les adresses IP (**Control Panel** › **Instance settings** › **IP allow listing**), ajoutez l'adresse indiquée dans le guide de La Forge, avec le type **External API connection**.

> [!WARNING]
>
> Ne donnez à La Forge **aucun droit** de démarrage de diffusion ou de workflow. Elle ne lance, ne prépare ni ne confirme aucune diffusion, ne démarre aucun workflow, ne crée et ne supprime aucun destinataire, et ne touche jamais à leur consentement.

## Importer le kit Titane

Chez Adobe Campaign, un champ n'existe que si votre administrateur Campaign l'ajoute. Le **kit Titane** le fait pour vous : un package à importer une fois, qui ajoute les champs `titan_*` à la table de vos destinataires.

**1. Télécharger le kit**

Dans La Forge, page **Données**, carte **Adobe Campaign** : **Télécharger le kit Titane**. Il est fait pour la table de vos destinataires.

**2. L'importer**

Dans la console Campaign, **Outils** › **Avancé** › **Import de package**, puis importez le fichier téléchargé.

**3. Mettre à jour la base**

**Outils** › **Avancé** › **Mettre à jour la structure de la base**, et suivez l'assistant jusqu'au bout.

**4. Le dire à La Forge**

Dans La Forge, carte **Adobe Campaign** : **Vérifier maintenant**. Les champs Titane arrivent la nuit suivante.

> [!NOTE]
>
> Le kit n'ajoute que des colonnes à la table de vos destinataires. Il ne contient ni workflow, ni diffusion, ni droit. Quand Titane écrit un nouveau champ, La Forge vous propose un kit à jour : réimportez-le de la même façon.

## Les destinataires que Titane met à jour

Titane écrit sur les destinataires Adobe Campaign dont l'**adresse e-mail** est celle d'un client de votre boutique. Un destinataire qui ne correspond à aucun client n'est pas touché. Titane ne crée jamais de destinataire et ne change jamais ses listes de blocage.

## Les champs Titane

Titane écrit chaque nuit, sur chaque destinataire, les champs de la [référence](https://docs.titane-intelligence.com/livre/reference-champs.md), sous ces noms, en minuscules : `titan_cycle`, `titan_churn`, `titan_reco_1_nom`… Dans la console, ils portent un libellé qui commence par « Titane · », par exemple « Titane · Risque de départ (0 à 1) ».

**Hugo, client de la boutique Pure**
Adobe Campaign · profil

Valeurs d'exemple : un client fictif de la marque de démonstration « Pure ».

Chez Adobe Campaign, 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.

| Champs | Type chez Adobe Campaign | Ce que ça change |
| - | - | - |
| les nombres (`titan_churn`, `titan_ltv`, `titan_commandes`…) | nombre, avec un point décimal (`0.42`) | des conditions « supérieur à », « inférieur à » |
| `titan_prochain_achat`, `titan_prochain_reassort`, `titan_asof` | date | des conditions sur une date |
| `titan_recs`, `titan_complementary`, `titan_replenishment` | texte : les identifiants entre virgules, `,8817234,8817102,` | une condition « contient » sur un produit |
| tous les autres (`titan_cycle`, `titan_reco_{n}_nom`, `titan_reco_{n}_url`…) | texte | des conditions « égal à », « n'est pas vide » |

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 une diffusion, gardez les champs `titan_reco_{n}_…`.

Un champ vide est **vidé** sur le destinataire, liste comprise : un client sans résultat n'a pas de valeur, ce qui n'est pas un zéro.

### Pas de modèle Titane chez Adobe Campaign

Titane ne pose pas de modèle chez Adobe Campaign : vous composez vos diffusions dans Campaign, et vous y insérez les champs Titane.

## Insérer un champ Titane dans une diffusion

Dans le contenu HTML d'une diffusion e-mail, un champ Titane s'insère comme vos autres champs de personnalisation :

```html theme={null}
<%= recipient.titan_reco_1_nom %>

<% if (recipient.titan_reco_2_nom != "") { %>
  … ce qui ne s'affiche que si le champ est renseigné …
<% } %>
```

Les prix sont **déjà mis en forme** (`24,90 €`) : affichez-les tels quels. Pour un texte de repli quand un champ est vide, ajoutez un `else` à la condition. Dans l'éditeur de contenu, le bouton **Champ de personnalisation** (Personalization field) insère aussi le champ, choisi parmi ceux du destinataire.

> [!NOTE]
>
> Campaign ne suit pas de façon sûre un lien dont **toute l'adresse** vient d'un champ, comme `titan_reco_1_url` : les clics sur ces produits peuvent ne pas remonter dans les statistiques de la diffusion. Ajoutez un bouton vers votre site, à une adresse fixe, pour suivre les clics.

## Cibler

Dans une diffusion, le lien **À** (To) ouvre le choix de la cible : vos destinataires, filtrés par des conditions. Dans un workflow, c'est l'activité **Requête** (Query) qui cible. Dans les deux cas, l'éditeur de requête propose chaque champ Titane sous son libellé « Titane · … », avec les opérateurs habituels : **égal à** (Equal to), **n'est pas vide** (Is not empty), **supérieur à** (Greater than), **inférieur à** (Less than)… Des idées de cibles sont dans [Les segments Titane](https://docs.titane-intelligence.com/livre/segments.md).

Une liste se cible par **contient** (Contains), avec l'identifiant du produit **entre deux virgules** : `titan_recs` **contient** `,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 liste « TITAN · … » chez Adobe Campaign : vous construisez les cibles dont vous avez besoin. Un champ vide ne remplit aucune condition, sauf **est vide**.

## Déclencher

Pour qu'une diffusion parte d'elle-même chaque jour, construisez un **workflow de ciblage** autour d'une **Requête incrémentale** (Incremental query) :

1. la **Requête incrémentale** cible le champ Titane qui vous intéresse, par exemple `titan_cycle` **égal à** `DECROCHAGE`. Dans son onglet **Planification et historique** (Scheduling & History), faites-la passer **chaque jour en fin de matinée** : Titane met les champs à jour la nuit ;
2. à chaque passage, elle **écarte les destinataires qu'elle a déjà retenus** : un client ne reçoit le message qu'une fois. **Historique en jours** (History in days) dit pendant combien de jours elle s'en souvient ;
3. derrière elle, une activité **Diffusion e-mail** (Email delivery), à partir de votre modèle de diffusion, envoie le message aux destinataires retenus.

> [!NOTE]
>
> Au premier passage, la requête retient **tous** les clients déjà dans la situation ; ensuite, seulement ceux qui y entrent. Regardez combien elle en retient avant de lancer la diffusion. Un jour où elle ne retient personne, le workflow attend le passage suivant.

## 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.

| Cas d'usage | Modèle TITAN | Les champs du destinataire |
| - | - | - |
| [Envoyer une sélection personnalisée](https://docs.titane-intelligence.com/crm/adobe-campaign/selection-personnalisee.md) | TITAN-REC | `titan_reco_1_…` à `titan_reco_5_…` |
| [Reconquérir les clients qui décrochent](https://docs.titane-intelligence.com/crm/adobe-campaign/reconquete.md) | TITAN-REC | `titan_cycle` pour cibler, `titan_reco_*` pour les produits |
| [Écrire à une audience d'opportunité](https://docs.titane-intelligence.com/crm/adobe-campaign/audience-opportunite.md) | TITAN-REC | `titan_opportunite` pour cibler, `titan_reco_*` pour les produits |
| [Rappeler un réassort](https://docs.titane-intelligence.com/crm/adobe-campaign/reassort.md) | TITAN-CORE | `titan_reassort`, `titan_prochain_reassort` |
| [Provoquer la deuxième commande](https://docs.titane-intelligence.com/crm/adobe-campaign/deuxieme-commande.md) | TITAN-CORE | `titan_parcours`, `titan_recence` |

Les compléments du dernier achat (**TITAN-LINK**) arrivent chez Adobe Campaign dans la liste `titan_complementary` : de quoi cibler les clients à qui un produit irait bien, mais pas de quoi afficher ces compléments dans une diffusion. Le même tableau, pour tous les CRM, est dans [Les recommandations produits](https://docs.titane-intelligence.com/livre/recommandations.md#sur-le-profil-de-chaque-client).

## Cinq cas d'usage

> [card] [Envoyer une sélection personnalisée](https://docs.titane-intelligence.com/crm/adobe-campaign/selection-personnalisee.md)
>
> Une diffusion où chaque client voit ses propres produits.

> [card] [Reconquérir les clients qui décrochent](https://docs.titane-intelligence.com/crm/adobe-campaign/reconquete.md)
>
> Un workflow qui écrit à chaque client le jour où il sort de son rythme.

> [card] [Écrire à une audience d'opportunité](https://docs.titane-intelligence.com/crm/adobe-campaign/audience-opportunite.md)
>
> Un workflow qui écrit à chaque client le jour où il entre dans une audience d'opportunité.

> [card] [Rappeler un réassort](https://docs.titane-intelligence.com/crm/adobe-campaign/reassort.md)
>
> Un rappel quand un produit arrive à épuisement.

> [card] [Provoquer la deuxième commande](https://docs.titane-intelligence.com/crm/adobe-campaign/deuxieme-commande.md)
>
> Faire revenir les clients d'une seule commande, au bon moment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.