Show Menu
SUJETS×

Configuration du pipeline

Les paramètres d’authentification tels que l’ID client, la clé privée et le point de terminaison 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. Il est au format JSON. Le déclencheur est traité immédiatement à l’aide du code JavaScript. Il est enregistré dans une table de base de données sans autre traitement en temps réel. Les déclencheurs sont utilisés pour le ciblage par un processus de campagne qui envoie des courriers électroniques. La campagne est configurée de sorte qu’un client qui a les deux événements déclencheurs reçoive un courrier électronique.

Prérequis

L’utilisation Experience Cloud Triggers de Campaign requiert :
  • Adobe Campaign version 6.11 build 8705 ou ultérieure.
  • Adobe Analytics Ultimate, Premium, Foundation, OD, Select, Prime, Mobile Apps, Select ou Standard.
Les configurations préalables sont les suivantes :
  • Création d'un fichier de clé privée puis création de l'application Auth enregistrée avec cette clé.
  • Configuration des déclencheurs dans Adobe Analytics.
La configuration Adobe Analytics n'est pas du ressort de ce document.
L'Adobe Campaign nécessite les informations suivantes de Adobe Analytics :
  • Nom de l’application Auth.
  • IMSOrgId, identifiant du client Experience Cloud.
  • Noms des déclencheurs configurés en Analytics.
  • Nom et format des champs de données à rapprocher de la base de données Marketing.
Une partie de cette configuration est un développement personnalisé et requiert les éléments suivants :
  • Connaissance de l’analyse JSON, XML et Javascript dans l’Adobe Campaign.
  • Connaissance opérationnelle des API QueryDef et Writer.
  • Des notions de fonctionnement de cryptage et d'authentification utilisant des clés privées.
Etant donné que la modification du code JS nécessite des compétences techniques, ne la tentez pas sans la bonne compréhension.
Les déclencheurs sont enregistrés dans une table de base de données. Les données de déclenchement peuvent donc être utilisées en toute sécurité par les opérateurs marketing dans les workflows de ciblage.

Fichiers d’authentification et de configuration

L’authentification est requise, car Pipeline est hébergé dans Adobe Experience Cloud. Si le serveur Marketing est hébergé sur site, lorsqu’il se connecte à Pipeline, il doit s’authentifier pour disposer d’une connexion sécurisée. Il utilise une paire de clés publiques et privées. Ce processus fonctionne de la même manière qu’un utilisateur/mot de passe, mais est plus sécurisé.

IMSOrgId

IMSOrgId est l’identifiant du client sur Adobe Experience Cloud. Définissez-la dans le fichier d’instance serverConf.xml, sous l’attribut IMSOrgId. Exemple :
<redirection IMSOrgId="C5E715(…)98A4@AdobeOrg" (…)

Génération de clés

La clé est une paire de fichiers. Il est au format RSA et fait 4 096 octets. Il peut être généré avec un outil open source tel qu'OpenSSL. Chaque fois que l’outil est exécuté, une nouvelle clé est générée de manière aléatoire. Par souci de commodité, les étapes sont énumérées ci-dessous :
  • openssl genrsa -out <private_key.pem> 4096
  • openssl rsa -pubout -in <private_key.pem> -out <public_key.pem>
Exemple de fichier private_key.pem :
----BEGIN RSA PRIVATE KEY----
MIIEowIBAAKCAQEAtqcYzt5WGGABxUJSfe1Xy8sAALrfVuDYURpdgbBEmS3bQMDb
(…)
64+YQDOSNFTKLNbDd+bdAA+JoYwUCkhFyvrILlgvlSBvwAByQ2Lx
----END RSA PRIVATE KEY----

Exemple de fichier public_key.pem :
----BEGIN PUBLIC KEY----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtqcYzt5WGGABxUJSfe1X
(…)
EwIDAQAB
----END PUBLIC KEY----

Les clés ne doivent pas être générées par PuttyGen, OpenSSL est le meilleur choix.

Auteur de la création de clients dans Adobe Experience Cloud

Une application de type JWT doit être créée en se connectant à Adobe Analytics dans le compte d’organisation approprié sous Admin > Gestion ​utilisateur > Application de serment héritée.
Procédez comme suit :
  1. Sélectionnez le compte de service (assertion JWT) .
  2. Saisissez le nom de l’ application.
  3. Enregistrez la clé ​publique.
  4. Sélectionnez les étendues du déclencheur.
  5. Cliquez sur Créer et vérifiez le ID de l&#39;application et la Clé secrète créés.

Enregistrement du nom de l’application dans Adobe Campaign Classic

Le ID de l'application du client Auth créé doit être configuré dans Adobe Campaign. Pour ce faire, modifiez le fichier de configuration d’instance dans l’ pipelined élément, en particulier l’attribut appName.
Exemple :
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Chiffrement de clé

Pour être utilisée par pipelined, la clé privée doit être chiffrée. Le chiffrement est effectué à l’aide de la fonction JavaScript cryptString et doit être exécuté sur la même instance que pipelined.
Un exemple de chiffrement de clé privée avec JavaScript est disponible dans cette page .
La clé privée chiffrée doit être enregistrée dans l'Adobe Campaign. Vous pouvez le faire en modifiant le fichier de configuration de l’instance dans l’ pipelined élément, en particulier l’attribut authPrivateKey.
Exemple :
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

début automatique du processus en pipelines

Le pipelined processus doit être démarré automatiquement. Pour ce faire, définissez l’élément du fichier de configuration sur autostart="true" :
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Redémarrage du processus en pipeline

Il peut également être démarré manuellement à l’aide de la ligne de commande :
nlserver start pipelined@instance

Un redémarrage est nécessaire pour que les modifications prennent effet :
nlserver restart pipelined@instance

En cas d’erreur, recherchez des erreurs sur la sortie standard (si vous avez démarré manuellement) ou dans le fichier pipelined journal. Consultez la section Résolution des problèmes de ce document pour plus d'informations sur la résolution des problèmes.

Options de configuration des pipelines

Option
Description
appName
ID de l'application OAuth (ID de l'application) enregistrée dans Adobe Analytics (où la clé publique a été téléchargée) : Admin > Gestion utilisateur > Application de serment héritée. Refer to this  section .
authGatewayEndpoint
URL permettant d’obtenir des "jetons de passerelle".
Par défaut : https://api.omniture.com
authPrivateKey
Clé privée (partie publique téléchargée dans Adobe Analytics (voir cette section). AES crypté avec l'option XtkSecretKey : xtk.session.EncryptPassword("PRIVATE_KEY");
disableAuth
Désactiver l'authentification (la connexion sans jetons de passerelle n'est acceptée que par certains points de terminaison du pipeline de développement)
discoverPipelineEndpoint
URL permettant de découvrir le point de terminaison Pipeline Services à utiliser pour ce client. Par défaut : https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Période comprise entre 2 vidages de l’état interne du processus dans var/INSTANCE/pipelined.json L’état interne est également accessible à la demande à l’adresse http://INSTANCE/pipelined/status (port 7781).
forcedPipelineEndpoint
Désactiver la découverte du point de terminaison PipelineServices et la forcer
monitorServerPort
Le pipelined processus écoute sur ce port pour fournir l’état interne du processus à l’adresse http://INSTANCE/pipelined/status (port 7781).
pointerFlushMessageCount
Lorsque ce nombre de messages est traité, les décalages sont enregistrés dans la base de données. La valeur par défaut est 1 000
pointerFlushPeriodSec
Après cette période, les décalages seront enregistrés dans la base de données. La valeur par défaut est 5 (secondes)
processingJSThreads
Nombre de messages de traitement de threads dédiés avec des connecteurs JS personnalisés. Par défaut : 4
processingThreads
Nombre de messages de traitement de threads dédiés avec du code intégré. Par défaut : 4
retryPeriodSec
Délai entre les Reprises (en cas d’erreurs de traitement). La valeur par défaut est 30 (s)
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 300 (s)