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 di attivatori da elaborare è configurato in un'opzione in formato JSON.
I trigger vengono utilizzati per il targeting tramite 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 la configurazione, verificare che:

• Adobe Campaign 20.3, 20.2.4, 19.1.8 o Gold Standard 11 minimo
• versione Adobe Analytics Standard

Sarà inoltre necessario:

• autenticazione del progetto Adobe I/O
• un IMSOrgID valido, l’identificatore del cliente del Experience Cloud con aggiunto Adobe Analytics
• Accesso sviluppatore all'organizzazione IMS
• attiva la configurazione in Adobe Analytics

File di autenticazione e configurazione

L'autenticazione è necessaria perché la pipeline è ospitata nell'Adobe Experience Cloud.
Utilizza un paio di chiavi pubbliche e private. Questa procedura ha la stessa funzione di utente/password ma è più sicura.
L'autenticazione è supportata per il Marketing Cloud tramite progetto Adobe I/O.

Passaggio 1: Creazione/aggiornamento progetto Adobe I/O

Per i clienti ospitati, puoi creare un ticket di assistenza clienti per abilitare la tua organizzazione con Token account tecnici di Adobe I/O per l'integrazione Triggers.

Per i clienti Premise, fare riferimento alla pagina Configuring Adobe I/O for Adobe Experience Cloud Triggers. È necessario selezionare Adobe Analytics durante l'aggiunta di API alle credenziali del Adobe I/O .

Passaggio 2: Configurazione dell'opzione pipeline NmsPipeline_Config

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

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

2. Selezionare l'opzione NmsPipeline_Config.

3. Nel campo Value (long text) potete incollare il seguente codice JSON, che specifica due attivatori. È necessario assicurarsi 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. Potete anche scegliere di incollare il seguente codice JSON che cattura tutti i trigger.

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

Il parametro Consumer

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

Il parametro Consumer identifica l'istanza come uno di questi consumatori. L'identità dell'istanza chiamerà la pipeline. Potete compilarlo con il nome dell'istanza che si trova nella pagina Monitoraggio della console client.

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

Suggerimenti per l'opzione pipeline

Per configurare l'opzione pipeline, attenersi alle seguenti raccomandazioni:

• Aggiungere o modificare attivatori in Triggers, non modificare gli altri.
• Assicurati che il JSON sia valido. È possibile utilizzare una Convalida JSON, fare riferimento a questo sito Web, ad esempio.
• "name" corrisponde all'ID attivatore. Un carattere jolly "*" intercetta tutti i trigger.
• "Consumer" corrisponde al nome dell'istanza o dell'applicazione chiamante.
• Pipeline supporta anche l'argomento "alias".
• Dopo aver apportato le modifiche, riavviare sempre la pipeline.

Passaggio 3: Configurazione opzionale

È possibile modificare alcuni parametri interni in base ai requisiti di carico, ma assicurarsi di verificarli prima di metterli in produzione.

L'elenco dei parametri opzionali è riportato di seguito:

Avvio automatico processo tubato

Il processo tubato deve essere avviato automaticamente.

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

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

Riavvio processo tubato

Per rendere effettive le modifiche è necessario riavviare il sistema:

nlserver restart pipelined@instance

Passaggio 4: Convalida

Per convalidare la configurazione della pipeline per il provisioning, attenetevi alla procedura seguente:

• Assicurarsi che il processo [!DNL pipelined] sia in esecuzione.
• Controllate i registri di connessione della pipeline nel file pipelining.log.
• Verificare la connessione e se i ping sono ricevuti. I clienti ospitati possono utilizzare il monitoraggio dalla console client.