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.

ATTENZIONE

In caso di distribuzione ibrida, accertati che la pipeline sia configurata su un'istanza intermedia.

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:

Opzione Descrizione
appName(Legacy) AppID dell’applicazione OAuth registrata nell’applicazione giuramento legacy in cui è stata caricata la chiave pubblica. Per ulteriori informazioni, consulta questa pagina
authGatewayEndpoint(Legacy) URL per ottenere token gateway. Predefinito: https://api.omniture.com
authPrivateKey(Legacy) La chiave privata, parte pubblica caricata nell’applicazione Legacy Oath, AES crittografata con l’opzione XtkKey: cryptString("PRIVATE_KEY")
disableAuth(Legacy) Disattiva l'autenticazione. La connessione senza token gateway verrà accettata solo da alcuni endpoint pipeline di sviluppo.
findPipelineEndpoint URL per trovare l'endpoint di Pipeline Services da utilizzare per questo tenant. Predefinito: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec Periodo tra due discariche del processo di stato interno in var/INSTANCE/pipelined.json.
Lo stato interno è accessibile anche su richiesta: http://INSTANCE:7781/pipelined/status
forzatoPipelineEndpoint Disabilitare il rilevamento di PipelineServicesEndpoint per forzarlo
monitorServerPort Il processo condotto sarà in ascolto su questa porta per fornire il processo di stato interno qui: http://INSTANCE:PORT/pipelined/status.
Il valore predefinito è 7781
puntatoreFlushMessageCount Quando questo numero di messaggi viene elaborato, gli offset verranno salvati nel database.
Il valore predefinito è 1000
puntatoreFlushPeriodSec Dopo questo periodo, gli offset verranno salvati nel database.
Il valore predefinito è 5 (secondi)
processingJSThread Numero di messaggi di elaborazione thread dedicati con connettori JS personalizzati.
Il valore predefinito è 4
processingThread Numero di messaggi di elaborazione thread dedicati con codice incorporato.
Il valore predefinito è 4
tryPeriodSec Ritardo tra i tentativi in caso di errori di elaborazione.
Il valore predefinito è 30 (secondi)
tryValiditySec Ignora il messaggio se non è stato elaborato correttamente dopo questo periodo (troppi tentativi).
Il valore predefinito è 300 (secondi)

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.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free