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.

ATTENTION

Dans le cas d'un déploiement hybride, vérifiez que le pipeline est configuré sur une instance mid-sourcing.

Prérequis

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

  • Adobe Campaign version 20.3 au minimum ;
  • Adobe Analytics version standard.

Vous aurez également besoin des éléments suivants :

  • l’authentification de projet Adobe I/O ;
  • un IMSOrgId valide, l’identifiant du client Experience Cloud auquel Adobe Analytics a été ajouté ;
  • l’accès développeur à l’organisation IMS ;
  • 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 :

Option Description
appName(Hérité) AppID de l'application OAuth enregistrée dans l'application Legacy Oath où la clé publique a été chargée. Voir à ce propos cette page
authGatewayEndpoint(hérité) URL permettant d'obtenir des jetons de passerelle. Par défaut: https://api.omniture.com
authPrivateKey(hérité) La clé privée, la partie publique téléchargée dans l’application Legacy Oath, AES chiffré avec l’option XtkKey : cryptString("PRIVATE_KEY")
disableAuth(hérité) La désactivation de l'authentification, la connexion sans jetons de passerelle n'est acceptée que par certains points d’entrée du pipeline de développement.
discoverPipelineEndpoint URL permettant de trouver le point d’entrée de Pipeline Services à utiliser pour ce tenant. Par défaut: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec La période entre deux vidages du processus d'état interne dans var/INSTANCE/pipelined.json.
L'état interne est également accessible à la demande ici : http://INSTANCE:7781/pipelined/status
forcedPipelineEndpoint Désactiver la détection de PipelineServicesEndpoint et la forcer
monitorServerPort Le processus en pipeline écoutera sur ce port pour fournir le processus d'état interne ici : http://INSTANCE:PORT/pipelined/status.
La valeur par défaut est de 7781
pointerFlushMessageCount Lorsque ce nombre de messages est traité, les décalages seront enregistrés dans la base de données.
La valeur par défaut est de 1000
pointerFlushPeriodSec Après cette période, les décalages seront enregistrés dans la base de données.
La valeur par défaut est de 5 (secondes)
processingJSThreads Nombre de messages de traitement de threads dédiés avec des connecteurs JS personnalisés.
La valeur par défaut est de 4
processingThreads Nombre de messages de traitement de threads dédiés avec code natif.
La valeur par défaut est de 4
retryPeriodSec Délai entre les reprises en cas d'erreurs de traitement.
La valeur par défaut est de 30 (secondes)
retryValiditySec Ignorer le message s'il n'est pas traité correctement après cette période (trop de reprises).
La valeur par défaut est de 300 (secondes)

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.

Sur cette page