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.
In caso di distribuzione ibrida, accertati che la pipeline sia configurata su un'istanza intermedia.
Prima di avviare la configurazione, verificare che:
Sarà inoltre necessario:
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.
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 .
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.
In Adobe Campaign, accedere al menu delle opzioni in Administration > Platform > Options in Explorer.
Selezionare l'opzione NmsPipeline_Config.
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.
},
]
}
]
}
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"
}
]
}
]
}
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.
Per configurare l'opzione pipeline, attenersi alle seguenti raccomandazioni:
È 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) |
Il processo tubato deve essere avviato automaticamente.
Per questo, impostate l'elemento < pipeline > nel file di configurazione su autostart="true":
<pipelined autoStart="true" ... "/>
Per rendere effettive le modifiche è necessario riavviare il sistema:
nlserver restart pipelined@instance
Per convalidare la configurazione della pipeline per il provisioning, attenetevi alla procedura seguente: