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.
Prima di avviare questa configurazione, verifica di utilizzare:
Sono inoltre necessari:
È 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.
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.
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.
In Adobe Campaign, accedi al menu delle opzioni in Administration > Platform > Options nel Explorer.
Seleziona la NmsPipeline_Config opzione.
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.
},
]
}
]
}
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"
}
]
}
]
}
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.
Per configurare l’opzione Pipeline, segui queste raccomandazioni:
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:
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) | La 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 di 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 di 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 è 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 è 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) |
Il processo pipeline deve essere avviato automaticamente.
Per questo, imposta l’elemento < pipeline > nel file di configurazione su autostart="true":
<pipelined autoStart="true" ... "/>
Per rendere effettive le modifiche è necessario riavviare il computer:
nlserver restart pipelined@instance
Per convalidare la configurazione della pipeline per il provisioning, effettua le seguenti operazioni: