Configuration du pipeline

Les paramètres d'authentification tels que l'identifiant client, la clé privée et le point d'entrée de l'authentification sont configurés dans les fichiers de configuration de l'instance.
La liste des déclencheurs à traiter est configurée dans une option au format JSON.
Les déclencheurs sont utilisés pour le ciblage par un workflow de campagne qui envoie des emails. La campagne est configurée de sorte qu'un client qui a les deux événements de déclencheur reçoive un email.

Conditions préalables requises

Avant de démarrer cette configuration, vérifiez que vous utilisez :

• Au minimum, l'une des versions Adobe Campaign suivantes :
  • 19.1.8.9039
  • 19.1.4.9032 - Gold Standard 11
  • 20.2.4.9187
  • 20.3.1
• Adobe Analytics version standard.

Vous avez également besoin de :

• l’authentification de projet Adobe I/O ;
• un identifiant d’organisation valide ; pour trouver votre identifiant d’organisation, reportez-vous à cette page
• un accès développeur à votre organisation
• la configuration des déclencheurs effectuée dans Adobe Analytics

Fichiers d'authentification et de configuration

L'authentification est requise, car le pipeline est hébergé dans Adobe Experience Cloud.
Une paire de clés publique et privée est utilisée. Ce processus fonctionne de la même manière qu'un nom d'utilisateur/mot de passe, mais il est plus sécurisé.
L’authentification est prise en charge pour Marketing Cloud via le projet Adobe I/O.

Étape 1 : création/mise à jour du projet Adobe I/O

Pour les clients hébergés, vous pouvez créer un ticket d’Assistance clientèle afin d’activer votre organisation avec des jetons de compte technique Adobe I/O pour l’intégration à Triggers.

Pour les clients On-Premise, reportez-vous à la page Configuration d’Adobe I/O pour les Triggers Adobe Experience Cloud. Veuillez noter que vous devez sélectionner Adobe Analytics lors de l’ajout d’API aux informations d’identification d’Adobe I/O.

Étape 2 : configuration de l'option de pipeline NmsPipeline_Config

Une fois l'authentification définie, le pipeline récupère les événements. Il traitera uniquement les déclencheurs configurés dans Adobe Campaign. Le déclencheur doit avoir été généré à partir d'Adobe Analytics et envoyé vers le pipeline qui traitera uniquement les déclencheurs configurés dans Adobe Campaign.
L'option peut également être configurée avec un caractère générique pour capturer tous les déclencheurs, quel que soit leur nom.

1. Dans Adobe Campaign, accédez au menu des options sous Administration > Plateforme > Options dans l'Explorateur.

2. Sélectionnez l'option NmsPipeline_Config.

3. Dans le champ Valeur (texte long), vous pouvez coller le code JSON suivant, qui spécifie deux déclencheurs. N'oubliez pas de supprimer les commentaires.

   {
   "topics": [ // list of "topics" that the pipelined is listening to.
      {
           "name": "triggers", // Name of the first topic: triggers.
           "consumer": "customer_dev", // Name of the instance that listens.  This value can be found on the monitoring page of Adobe Campaign.
           "triggers": [ // Array of triggers.
               {
                   "name": "3e8a2ba7-fccc-49bb-bdac-33ee33cf02bf", // TriggerType ID from Analytics
                   "jsConnector": "cus:triggers.js" // Javascript library holding the processing function.
               }, {
                   "name": "2da3fdff-13af-4c51-8ed0-05802a572e94", // Second TriggerType ID
                   "jsConnector": "cus:triggers.js" // Can use the same JS for all.
               },
           ]
       }
   ]
   }
   

4. Vous pouvez également choisir de coller le code JSON suivant qui capture tous les déclencheurs.

   {
   "topics": [
     {
       "name": "triggers",
       "consumer":  "customer_dev",
       "triggers": [
         {
           "name": "*",
           "jsConnector": "cus:pipeline.js"
         }
       ]
     }
   ]
   }
   

Le paramètre Consommateur

Le pipeline fonctionne comme un modèle "fournisseur et consommateur". Les messages ne sont consommés que pour un utilisateur individuel : chaque consommateur reçoit sa propre copie des messages.

Le paramètre Consommateur identifie l'instance comme l'un de ces consommateurs. L'identité de l'instance appelle le pipeline. Vous pouvez le remplir avec le nom de l'instance qui se trouve sur la page Surveillance de la console cliente.

Le service de pipeline effectue le suivi des messages récupérés par chaque consommateur. L'utilisation de différents consommateurs pour différentes instances vous permet de vous assurer que chaque message est envoyé à chaque instance.

Recommandations relatives à l'option Pipeline

Pour configurer l'option Pipeline, vous devez suivre les recommandations suivantes :

• Ajoutez ou modifiez les déclencheurs sous Déclencheurs, sans modifier le reste.
• Assurez-vous que le fichier JSON est valide. Vous pouvez utiliser un programme de validation JSON. Reportez-vous à ce site Web, par exemple.
• "name" correspond à l'ID du déclencheur. Un caractère générique "*" capture tous les déclencheurs.
• "Consommateur" correspond au nom de l'instance ou de l'application appelante.
• Le pipeline prend également en charge la rubrique "alias".
• Vous devez toujours redémarrer en pipeline après avoir apporté des modifications.

Étape 3 : Configuration facultative

Vous pouvez modifier certains paramètres internes en fonction de vos besoins de charge, mais veillez à les tester avant de les mettre en production.

La liste des paramètres facultatifs se trouve ci-dessous :

Démarrage automatique du processus en pipeline

Le processus en pipeline doit être démarré automatiquement.

Pour ce faire, définissez l'élément < pipelined > dans le fichier de configuration sur autostart="true" :

 <pipelined autoStart="true" ... "/>

Redémarrage du processus en pipeline

Un redémarrage est nécessaire pour que les modifications soient prises en compte :

nlserver restart pipelined@instance

Étape 4 : validation

Pour valider la configuration du pipeline pour l'approvisionnement, procédez comme suit :

• Vérifiez que le processus pipelined est en cours d'exécution.
• Recherchez les logs de connexion du pipeline dans le fichier pipeline.log.
• Vérifiez la connexion et si des pings sont reçus. Les clients hébergés peuvent utiliser le Monitoring depuis la console cliente.

Ressources Business.Adobe.com