[S’applique également à la v8.]{class="badge positive" title="S’applique également à Campaign v8."}

Configurer le pipeline configuring-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 prerequisites

Avant de commencer cette configuration, vérifiez que vous disposez des éléments suivants :

  • Un projet Adobe Developer.
  • Un identifiant d’organisation valide : pour trouver votre identifiant d’organisation, consultez cette page.
  • Un accès de développement à votre organisation.
  • Une configuration de déclencheurs valide dans Adobe Analytics.

Une authentification est requise, car le pipeline est hébergé dans Adobe Experience Cloud. Celui-ci utilise une authentification prise en charge via un projet Adobe Developer.

Étape 1 : créer/mettre à jour votre projet Adobe Developer creating-adobe-io-project

Vous devez activer votre organisation avec des jetons de compte Adobe Developer pour l’intégration de Triggers.

Découvrez comment créer votre compte technique Adobe sur cette page. Notez que vous devez sélectionner Adobe Analytics lorsque vous ajoutez une API aux informations d’identification d’Adobe Developer.

Étape 2 : configurer l’option de pipeline configuring-nmspipeline

Une fois l’authentification configurée, le pipeline récupère les événements. Celui-ci traite 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. Veillez à supprimer les commentaires.

    code language-json
    {
    "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.

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

Définir le paramètre Consommateur consumer-parameter

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 pipeline-option-recommendation

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

  • Ajouter ou modifier des déclencheurs dans Triggers.
  • Vous assurer que le JSON est valide.
  • Le paramètre Nom correspond à l’identifiant du déclencheur. Un caractère générique « * » capture tous les déclencheurs.
  • Le paramètre Consommateur correspond au nom de l’instance ou de l’application qui effectue l’appel.
  • Le processus pipelined prend également en charge la rubrique « alias ».
  • Vous devez toujours redémarrer le processus pipelined après avoir apporté des modifications.

(Facultatif) Étape 3 : configuration supplémentaire step-optional

Vous pouvez modifier certains paramètres internes en fonction de vos besoins de charge, mais assurez-vous de les tester avant de les appliquer dans votre environnement de production.

Voici la liste des paramètres facultatifs :

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 pipelined-process-autostart

Le processus pipelined 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 pipelined-process-restart

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

nlserver restart pipelined@instance

Étape 4 : validation step-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 pipelined.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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1