Show Menu
THEMEN×

Pipeline konfigurieren

Authentifizierungsparameter wie die Kunden-ID, der private Schlüssel und der Authentifizierungsendpunkt werden in den Konfigurationsdateien der Instanz konfiguriert. Die Liste der zu verarbeitenden Auslöser wird in einer Option konfiguriert. Dabei kommt das JSON-Format zum Einsatz. Der Auslöser wird unmittelbar mit JavaScript-Code verarbeitet. Er wird ohne weitere Verarbeitung in Echtzeit in einer Datenbanktabelle gespeichert. Die Auslöser werden für das Targeting eines Kampagnen-Workflows verwendet, der E-Mails sendet. Die Kampagne ist so eingerichtet, dass ein Kunde, der beide Auslöserereignisse aufweist, eine E-Mail erhält.

Voraussetzungen

Die Verwendung von Experience Cloud Triggers in Campaign erfordert:
  • Adobe Campaign Version 6.11 Build 8705 oder höher.
  • Adobe Analytics Ultimate, Premium, Foundation, OD, Select, Prime, Mobile Apps, Select oder Standard.
Vorausgesetzte Konfigurationen sind:
  • Erstellen einer privaten Schlüsseldatei und anschließendes Erstellen der OAuth-Anwendung, die mit diesem Schlüssel registriert wird.
  • Konfigurieren der Auslöser in Adobe Analytics.
Die Adobe Analytics-Konfiguration wird nicht in diesem Dokument behandelt.
Für Adobe Campaign sind folgende Informationen von Adobe Analytics erforderlich:
  • Der Name der OAuth-Anwendung.
  • Die IMSOrgId, die Kennung des Experience Cloud-Kunden.
  • Die Namen der in Analytics konfigurierten Auslöser.
  • Name und Format der Datenfelder, die mit der Marketing-Datenbank abgestimmt werden sollen.
Teil dieser Konfiguration muss vom Benutzer vorgenommen werden und erfordert Folgendes:
  • Grundkenntnisse der JSON-, XML- und JavaScript-Analyse in Adobe Campaign.
  • Grundkenntnisse der QueryDef- und Writer-APIs.
  • Grundverständnis der Verschlüsselung und Authentifizierung mit privaten Schlüsseln.
Da die Bearbeitung des JS-Codes technische Fertigkeiten voraussetzt, sollten Sie es ohne entsprechende Kenntnisse nicht versuchen.
Auslöser werden in einer Datenbanktabelle gespeichert. Auf diese Weise können Auslöserdaten von Marketing-Anwendern in Zielgruppen-Workflows sicher verwendet werden.

Authentifizierungs- und Konfigurationsdateien

Eine Authentifizierung ist erforderlich, da die Pipeline in Adobe Experience Cloud gehostet wird. Wenn der Marketing-Server lokal gehostet wird, muss er sich bei der Anmeldung bei der Pipeline für eine sichere Verbindung authentifizieren. Er verwendet ein Schlüsselpaar aus öffentlichem und privatem Schlüssel. Der Prozess entspricht der Verwendung einer Kombination aus Benutzer und Passwort, ist aber sicherer.

IMSOrgId

Die IMSOrgId ist die Kennung des Kunden in Adobe Experience Cloud. Legen Sie sie in der Datei "serverConf.xml" der Instanz unter dem Attribut "IMSOrgId" fest. Beispiel:
<redirection IMSOrgId="C5E715(…)98A4@AdobeOrg" (…)

Schlüsselgenerierung

Der Schlüssel besteht aus einem Dateipaar. Er liegt im RSA-Format vor und ist 4.096 Byte lang. Er kann mit einem Open-Source-Tool wie OpenSSL generiert werden. Bei jeder Ausführung des Tools wird zufällig ein neuer Schlüssel generiert. Die Schritte werden im Folgenden beschrieben:
  • openssl genrsa -out <private_key.pem> 4096
  • openssl rsa -pubout -in <private_key.pem> -out <public_key.pem>
Beispiel für die Datei "private_key.pem":
----BEGIN RSA PRIVATE KEY----
MIIEowIBAAKCAQEAtqcYzt5WGGABxUJSfe1Xy8sAALrfVuDYURpdgbBEmS3bQMDb
(…)
64+YQDOSNFTKLNbDd+bdAA+JoYwUCkhFyvrILlgvlSBvwAByQ2Lx
----END RSA PRIVATE KEY----

Beispiel für die Datei "public_key.pem":
----BEGIN PUBLIC KEY----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtqcYzt5WGGABxUJSfe1X
(…)
EwIDAQAB
----END PUBLIC KEY----

Schlüssel sollten nicht von PuttyGen generiert werden. OpenSSL ist die beste Wahl.

OAuth-Client-Erstellung in Adobe Experience Cloud

Sie müssen eine Anwendung vom Typ "JWT" erstellen, indem Sie sich bei Adobe Analytics unter Admin > User Management > Veraltete OAuth-Anwendung im richtigen Organisationskonto anmelden.
Führen Sie folgende Schritte aus:
  1. Wählen Sie das Dienstkonto (JWT Assertion) .
  2. Geben Sie den Anwendungsnamen ein.
  3. Registrieren Sie den öffentlichen Schlüssel .
  4. Wählen Sie die Perimeter des Auslösers aus.
  5. Klicken Sie auf Erstellen und überprüfen Sie die Anwendungs-ID und den erstellten Anwendungs-Geheimcode .

Registrierung des Anwendungsnamens in Adobe Campaign Classic

Die Anwendungs-ID des erstellten OAuth-Clients muss in Adobe Campaign konfiguriert werden. Bearbeiten Sie dazu die Konfigurationsdatei der Instanz im pipelined-Element, und zwar das Attribut "appName".
Beispiel:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Verschlüsselung des Schlüssels

Der private Schlüssel muss verschlüsselt werden, damit er von pipelined verwendet werden kann. Die Verschlüsselung erfolgt mit der JavaScript-Funktion "cryptString" und muss auf derselben Instanz wie pipelined vorgenommen werden.
Auf dieser Seite finden Sie ein Beispiel für die Verschlüsselung des privaten Schlüssels mit JavaScript.
Der verschlüsselte private Schlüssel muss in Adobe Campaign registriert werden. Bearbeiten Sie dazu die Konfigurationsdatei der Instanz im pipelined-Element, und zwar das Attribut "authPrivateKey".
Beispiel:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Automatischer Start von Pipelined-Prozess

Der pipelined-Prozess muss automatisch gestartet werden. Setzen Sie dazu das Element in der Konfigurationsdatei auf autostart="true":
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Neustart von Pipelined-Prozess

Der Prozess kann über die Befehlszeile auch manuell gestartet werden:
nlserver start pipelined@instance

Ein Neustart ist erforderlich, damit die Änderungen wirksam werden:
nlserver restart pipelined@instance

Sollten Fehler auftreten, suchen Sie nach Fehlern in der Standardausgabe (wenn Sie manuell gestartet haben) oder in der pipelined-Log-Datei. Weitere Informationen zum Beheben von Problemen finden Sie im Abschnitt zur Fehlerbehebung in diesem Dokument.

Optionen für die Pipelined-Konfiguration

Option
Beschreibung
appName
Kennung der OAuth-Anwendung (Anwendungs-ID), in Adobe Analytics registriert (wo der öffentliche Schlüssel hochgeladen wurde): "Admin" > "User Management" > "Veraltete OAuth-Anwendung". Siehe diesen Abschnitt .
authGatewayEndpoint
URL zum Abrufen von "Gateway-Tokens".
Standard: https://api.omniture.com
authPrivateKey
Privater Schlüssel (öffentlicher Teil wurde in Adobe Analytics hochgeladen (siehe diesen Abschnitt)). AES-Verschlüsselung mit der XtkSecretKey-Option xtk.session.EncryptPassword("PRIVATE_KEY");
disableAuth
Deaktivieren der Authentifizierung (Verbindungen ohne Gateway-Tokens werden nur von einigen Entwicklungs-Pipeline-Endpunkten akzeptiert)
discoverPipelineEndpoint
URL für die Ermittlung des Pipeline-Dienstendpunkts, der für diesen Mandanten verwendet werden soll. Standard: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Der Zeitraum zwischen zwei Dumps des internen Prozessstatus in "var/INSTANCE/pipelined.json". Der interne Status ist auch bei Bedarf abrufbar unter "http://INSTANCE/pipelined/status" (Port 7781).
forcedPipelineEndpoint
Deaktivieren der Erkennung und Erzwingen des PipelineServicesEndpoint
monitorServerPort
Der pipelined-Prozess prüft diesen Port, um den internen Prozessstatus unter „http://INSTANCE/pipelined/status“ bereitzustellen (Port 7781).
cursorFlushMessageCount
Sobald diese Anzahl von Nachrichten verarbeitet wurde, werden die Versätze in der Datenbank gespeichert. Der Standardwert ist 1.000.
cursorFlushPeriodSec
Nach diesem Zeitraum werden die Versätze in der Datenbank gespeichert. Der Standardwert ist 5 (Sekunden).
processingJSThreads
Anzahl der dedizierten Threads, die Nachrichten mit benutzerdefinierten JS-Connectoren verarbeiten. Der Standardwert ist 4.
processingThreads
Anzahl der dedizierten Threads, die Nachrichten mit nativem Code verarbeiten. Der Standardwert ist 4.
retryPeriodSec
Pause zwischen weiteren Zustellversuchen (bei Verarbeitungsfehlern). Der Standardwert ist 30 (Sekunden).
retryValiditySec
Verwerfen der Nachricht, wenn sie nach diesem Zeitraum nicht erfolgreich verarbeitet wurde (zu viele weitere Zustellversuche). Der Standardwert ist 300 (Sekunden).