Documentation Campaign Documentation de Campaign Classic v7

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

Configuration du pipeline configuring-pipeline

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Triggers

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 prerequisites

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 authentication-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 creating-adobe-io-project

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 configuring-nmspipeline

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.

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

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.

code language-none

code language-none
{ "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. }, ] } ] }

{
"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.
            },
        ]
    }
]
}

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

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

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 :

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 step-optional

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

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

recommendation-more-help

601d79c3-e613-4db3-889a-ae959cd9e3e1