DocumentazioneCampaignDocumentazione di Campaign Classic v7

[Applicabile anche a v8]{class="badge positive" title="Applicabile anche a Campaign v8"}

Configurare la pipeline configuring-pipeline

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

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 prerequisites

Prima di avviare questa configurazione, verifica di disporre di:

  • Un progetto Adobe Developer
  • Un ID organizzazione valido. Per trovare l'ID organizzazione, fare riferimento a questa pagina
  • Accesso per sviluppatori all’organizzazione
  • Una configurazione dei trigger valida in Adobe Analytics

È necessaria l’autenticazione perché la pipeline è ospitata in Adobe Experience Cloud. Utilizza un’autenticazione supportata per tramite un progetto Adobe Developer.

Passaggio 1: creare/aggiornare il progetto Adobe Developer creating-adobe-io-project

Abilita la tua organizzazione con i token di account Adobe Developer per l’integrazione Triggers.

Scopri come creare il tuo account tecnico Adobe in questa pagina. È necessario selezionare Adobe Analytics durante l'aggiunta dell'API alle credenziali di Adobe Developer.

Passaggio 2: configurare l’opzione pipeline configuring-nmspipeline

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, accedere al menu delle opzioni in Administration > Platform > Options in Explorer.

  2. Selezionare l'opzione NmsPipeline_Config.

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

    code language-json 
    {
"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.

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

Imposta il parametro Consumer consumer-parameter

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 parametro Consumer 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 pipeline-option-recommendation

Per configurare l’opzione Pipeline, segui queste raccomandazioni:

  • Aggiungi o modifica trigger in Triggers.
  • Verifica che il JSON sia valido.
  • Il parametro Name corrisponde all'ID del trigger. Un carattere jolly "*" acquisirà tutti i trigger.
  • Il parametro Consumer corrisponde al nome dell'istanza o dell'applicazione chiamante.
  • il processo pipelined supporta anche l'argomento "alias".
  • È sempre necessario riavviare pipelined processo dopo aver apportato modifiche.

(facoltativo) Passaggio 3: configurazione aggiuntiva step-optional

Puoi modificare alcuni parametri interni in base ai requisiti di carico, ma assicurati di testarli prima di applicarli all’ambiente di produzione.

L’elenco dei parametri facoltativi è:

Opzione
Descrizione
appName(Legacy)
AppID dell’applicazione OAuth registrata nell’applicazione Oath legacy in cui è stata caricata la chiave pubblica. Per ulteriori informazioni, consulta questa pagina
authGatewayEndpoint(Legacy)
URL per ottenere i token del gateway. Predefinito: https://api.omniture.com
authPrivateKey(Legacy)
Chiave privata, parte pubblica caricata nell'applicazione Oath legacy, AES crittografata con l'opzione XtkKey: cryptString("PRIVATE_KEY")
disableAuth(Legacy)
Disabilita l’autenticazione: la connessione senza token gateway verrà accettata solo da alcuni endpoint della pipeline di sviluppo.
findPipelineEndpoint
URL per trovare l’endpoint dei servizi di pipeline da utilizzare per questo tenant. Predefinito: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Periodo tra due immagini del processo dello stato interno in var/INSTANCE/pipelined.json.
Lo stato interno è accessibile anche on-demand qui: http://INSTANCE:7781/pipelined/status
forcedPipelineEndpoint
Disattiva il rilevamento di PipelineServicesEndpoint per forzarlo
monitorServerPort
Il processo pipeline ascolterà su questa porta per fornire il processo dello stato interno qui: http://INSTANCE:PORT/pipelined/status.
Il valore predefinito è 7781
pointerFlushMessageCount
Quando questo numero di messaggi viene elaborato, gli offset vengono salvati nel database. Il valore predefinito di
è 1000
pointerFlushPeriodSec
Trascorso questo periodo, gli offset verranno salvati nel database.
Il valore predefinito è 5 (sec)
processingJSThreads
Numero di thread dedicati che elaborano i messaggi con connettori JS personalizzati. Il valore predefinito di
è 4
processingThreads
Numero di thread dedicati che elaborano i messaggi con codice incorporato.
Il valore predefinito è 4
retryPeriodSec
Ritardo tra nuovi tentativi in caso di errori di elaborazione.
Il valore predefinito è 30 (sec)
retryValiditySec
Ignora il messaggio se non viene elaborato correttamente dopo questo periodo (troppi tentativi).
Il valore predefinito è 300 (sec)

Avvio automatico del processo pipeline pipelined-process-autostart

Il processo pipelined deve essere avviato automaticamente.

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

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

Riavvio del processo pipeline pipelined-process-restart

Per rendere effettive le modifiche è necessario riavviare il computer:

nlserver restart pipelined@instance

Passaggio 4: convalida step-validation

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

  • Verificare che il processo pipelined sia in esecuzione.
  • Controllare pipelined.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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1