Pipeline konfigurieren configuring-pipeline
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 im JSON-Format konfiguriert.
Die Auslöser werden für die Zielgruppenbestimmung 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 prerequisites
Bevor Sie mit dieser Konfiguration beginnen, überprüfen Sie, ob Sie Folgendes verwenden:
-
Mindestens einer der folgenden Adobe Campaign-Builds:
- 19.1.8.9039
- 19.1.4.9032 – Gold Standard 11
- 20.2.4.9187
- 20.3.1
-
Adobe Analytics Standard-Version
Sie benötigen außerdem:
- Projektauthentifizierung für Adobe I/O
- eine gültige Organisations-ID. Auf dieser Seite erfahren Sie, wie Sie Ihre Organisations-ID finden.
- ein Entwicklerzugriff auf Ihr Unternehmen
- Triggers-Konfiguration, ausgeführt in Adobe Analytics
Authentifizierung und Konfigurationsdateien authentication-configuration
Da das Pipeline-Hosting in Adobe Experience Cloud erfolgt, ist eine Authentifizierung erforderlich.
Hierfür wird ein Schlüsselpaar aus öffentlichem und privatem Schlüssel verwendet. Der Prozess entspricht der Verwendung einer Kombination aus Benutzer und Passwort, ist aber sicherer.
Die Authentifizierung für Experience Cloud wird über das Adobe I/O-Projekt umgesetzt.
Schritt 1: Erstellen/Aktualisieren eines Adobe I/O-Projekts creating-adobe-io-project
Kunden gehosteter Bereitstellungen können ein Ticket bei der Adobe-Kundenunterstützung eröffnen, um die Triggers-Integration für ihre Organisation über Adobe I/O-Token für technische Konten zu aktivieren.
Kunden von On-Premise-Bereitstellungen finden Informationen hierzu auf der Seite Konfigurieren von Adobe I/O für Adobe Experience Cloud Triggers. Beachten Sie, dass für die den Adobe I/O-Anmeldedaten hinzugefügte API Adobe Analytics ausgewählt sein muss.
Schritt 2: Konfigurieren der Pipeline-Option "NmsPipeline_Config" configuring-nmspipeline
Sobald die Authentifizierung eingerichtet ist, ruft die Pipeline die Ereignisse ab. Sie verarbeitet nur Auslöser, die in Adobe Campaign konfiguriert wurden. Der Auslöser muss in Adobe Analytics generiert und an die Pipeline gesendet worden sein; diese verarbeitet nur Auslöser, die in Adobe Campaign konfiguriert wurden.
Die Option kann auch mit einem Platzhalter konfiguriert werden, um alle Auslöser unabhängig vom Namen zu erfassen.
-
Rufen Sie in Adobe Campaign über Administration > Plattform > Optionen das Optionsmenü im Explorer auf.
-
Wählen Sie die Option NmsPipeline_Config aus.
-
Im Feld Wert (Memo) können Sie den folgenden JSON-Code einfügen, der zwei Auslöser angibt. Die Kommentare müssen Sie dabei entfernen.
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. }, ] } ] }
-
Sie können auch folgenden JSON-Code einfügen, der alle Auslöser abdeckt.
code language-none { "topics": [ { "name": "triggers", "consumer": "customer_dev", "triggers": [ { "name": "*", "jsConnector": "cus:pipeline.js" } ] } ] }
Der Parameter "Consumer" consumer-parameter
Die Pipeline funktioniert wie ein Anbieter-Verbraucher-Modell. Nachrichten werden nur von einem einzelnen Verbraucher "konsumiert"; jeder Verbraucher erhält eine eigene Kopie der Nachrichten.
Der Parameter Consumer identifiziert die Instanz als einen dieser Verbraucher. Über die Identität der Instanz wird die Pipeline aufgerufen. Sie können für diese den Instanznamen angeben. Sie finden diesen auf der Seite "Monitoring" der Client-Konsole.
Der Pipeline-Dienst dokumentiert die von jedem Verbraucher abgerufenen Nachrichten. Indem Sie für verschiedene Instanzen jeweils unterschiedliche Verbraucher verwenden, stellen Sie sicher, dass jede Nachricht an jede Instanz gesendet wird.
Empfehlungen für die Pipeline-Option pipeline-option-recommendation
Für die Konfiguration der Pipeline-Option wird Folgendes empfohlen:
- Wenn Sie Trigger bearbeiten oder hinzufügen, tun Sie dies unter Triggers; den Rest sollten Sie nicht bearbeiten.
- Vergewissern Sie sich, dass die JSON gültig ist. Verwenden Sie einen JSON-Validator, z. B. den auf dieser Website.
- "name" entspricht der Auslöser-ID. Ein Platzhalter (*) deckt alle Auslöser ab.
- "Consumer" entspricht dem Namen der aufrufenden Instanz oder Anwendung.
- Pipelined unterstützt auch das Thema "Aliases".
- Starten Sie pipelined grundsätzlich neu, nachdem Sie Änderungen vorgenommen haben.
Schritt 3: Optionale Konfiguration step-optional
Sie können einige interne Parameter entsprechend Ihren Lastanforderungen ändern; stellen Sie jedoch sicher, dass Sie diese testen, bevor Sie sie in die Produktion übernehmen.
Die Liste der optionalen Parameter ist nachfolgend aufgeführt:
https://api.omniture.com
cryptString("PRIVATE_KEY")
https://producer-pipeline-pnw.adobe.net
var/INSTANCE/pipelined.json.
Der interne Status ist hier auch auf Abruf verfügbar:
http://INSTANCE:7781/pipelined/status
http://INSTANCE:PORT/pipelined/status
.Der Standardwert ist 7781.
Der Standardwert ist 1000.
Der Standardwert ist 5 (Sekunden).
Der Standardwert ist 4.
Der Standardwert ist 4.
Der Standardwert ist 30 (Sekunden).
Der Standardwert ist 300 (Sekunden).
Automatischer Start des Pipelined-Prozesses pipelined-process-autostart
Der Pipelined-Prozess muss automatisch gestartet werden.
Legen Sie dazu das Element < pipelined > in der Konfigurationsdatei auf autostart="true" fest:
<pipelined autoStart="true" ... "/>
Neustart des Pipelined-Prozesses pipelined-process-restart
Ein Neustart ist erforderlich, damit die Änderungen wirksam werden:
nlserver restart pipelined@instance
Schritt 4: Validierung step-validation
Gehen Sie wie folgt vor, um die Pipeline-Einrichtung für die Bereitstellung zu validieren:
- Vergewissern Sie sich, dass der pipelined-Prozess ausgeführt wird.
- Prüfen Sie die Pipeline-Verbindungsprotokolle in der Datei "pipelined.log".
- Überprüfen Sie, ob die Verbindung besteht und Pings empfangen werden. Kunden gehosteter Bereitstellungen können über die Client-Konsole "Monitoring" verwenden.