v7 v8

Configurazione della pipeline

I parametri di autenticazione come l’ID cliente, la chiave privata e l’endpoint di autenticazione sono configurati nei file di configurazione dell’istanza.
L’elenco dei trigger da elaborare è configurato in un’opzione in formato JSON.
I trigger vengono utilizzati per il targeting da un flusso di lavoro della campagna che invia e-mail. La campagna è impostata in modo che un cliente con entrambi gli eventi di attivazione riceva un’e-mail.

Prerequisiti

Prima di avviare questa configurazione, verifica di utilizzare:

• Almeno una delle seguenti build di Adobe Campaign:
  • 19.1.8.9039
  • 19.1.4.9032 - Gold Standard 11
  • 20.2.4.9187
  • 20.3.1
• Versione Adobe Analytics Standard

Sono inoltre necessari:

• Autenticazione progetto di Adobe I/O
• un ID organizzazione valido: per trovare l’ID organizzazione, fai riferimento a questa pagina
• accesso per sviluppatori all’organizzazione
• configurazione dei trigger eseguita in Adobe Analytics

File di autenticazione e configurazione

È necessaria l’autenticazione perché la pipeline è ospitata in Adobe Experience Cloud.
Utilizza una coppia di chiavi pubbliche e private. Questo processo ha la stessa funzione di un utente/password, ma è più sicuro.
L’autenticazione è supportata per il Marketing Cloud tramite il progetto Adobe I/O.

Passaggio 1: creazione/aggiornamento del progetto Adobe I/O

Per i clienti in hosting, puoi creare un ticket di assistenza clienti per abilitare la tua organizzazione con Adobi I/O di token di account tecnici per l’integrazione Triggers.

Per i clienti On-Premise, consulta Configurazione di Adobe I/O per Adobe Experience Cloud Triggers pagina. Tieni presente che devi selezionare Adobe Analytics durante l’aggiunta dell’API alle credenziali Adobe I/O.

Passaggio 2: configurazione dell’opzione NmsPipeline_Config pipeline

Una volta impostata l’autenticazione, la pipeline recupererà gli eventi. Elabora solo i trigger configurati in Adobe Campaign. Il trigger deve essere stato generato da Adobe Analytics e inviato alla pipeline, che elaborerà solo i trigger configurati in Adobe Campaign.
L’opzione può anche essere configurata con un carattere jolly per acquisire tutti i trigger, indipendentemente dal nome.

1. In Adobe Campaign, accedi al menu delle opzioni in Administration > Platform > Options nel Explorer.

2. Seleziona la NmsPipeline_Config opzione.

3. In Value (long text) , puoi incollare il seguente codice JSON, che specifica due trigger. Assicurati di rimuovere i commenti.

   {
   "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. Puoi anche scegliere di incollare il seguente codice JSON che rileva tutti i trigger.

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

Il parametro Consumer

La pipeline funziona come un modello di fornitore e di consumatore. I messaggi vengono utilizzati solo per un singolo consumatore: ogni consumatore riceve la propria copia dei messaggi.

Il Consumatore Il parametro identifica l’istanza come uno di questi consumer. L’identità dell’istanza chiamerà la pipeline. È possibile compilarlo con il nome dell’istanza che si trova nella pagina Monitoraggio della console client.

Il servizio pipeline tiene traccia dei messaggi recuperati da ciascun consumatore. L’utilizzo di consumer diversi per istanze diverse consente di assicurarsi che ogni messaggio venga inviato a ogni istanza.

Raccomandazioni sulle opzioni della pipeline

Per configurare l’opzione Pipeline, segui queste raccomandazioni:

• Aggiungi o modifica trigger in Triggers, non modificare il resto.
• Verifica che il JSON sia valido. Puoi utilizzare una convalida JSON, fai riferimento a questa sito web ad esempio.
• "name" corrisponde all’ID del trigger. Un carattere jolly "*" acquisirà tutti i trigger.
• "Consumer" corrisponde al nome dell’istanza o dell’applicazione chiamante.
• Pipelined supporta anche l’argomento "alias".
• Dopo aver apportato modifiche, è sempre necessario riavviare la pipeline.

Passaggio 3: configurazione opzionale

Puoi modificare alcuni parametri interni in base ai requisiti di carico, ma assicurati di testarli prima di metterli in produzione.

L’elenco dei parametri opzionali è disponibile di seguito:

Avvio automatico del processo pipeline

Il processo pipeline deve essere avviato automaticamente.

Per questo, imposta l’elemento < pipeline > nel file di configurazione su autostart="true":

 <pipelined autoStart="true" ... "/>

Riavvio del processo pipeline

Per rendere effettive le modifiche è necessario riavviare il computer:

nlserver restart pipelined@instance

Passaggio 4: convalida

Per convalidare la configurazione della pipeline per il provisioning, effettua le seguenti operazioni:

• Assicurati che le pipelined processo in esecuzione.
• Controlla il file pipeline.log per i registri di connessione della pipeline.
• Verifica la connessione e se vengono ricevuti ping. I clienti in hosting possono utilizzare il monitoraggio dalla console client.