Show Menu
ARGOMENTI×

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. Il trigger viene elaborato immediatamente utilizzando il codice JavaScript. Viene salvata in una tabella di database senza ulteriore elaborazione in tempo reale. 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

L'utilizzo Experience Cloud Triggers in Campaign richiede:
  • Adobe Campaign versione 6.11 build 8705 o successiva.
  • Adobe Analytics Ultimate, Premium, Foundation, OD, Select, Prime, Mobile Apps, Select o Standard.
Le configurazioni preliminari sono:
  • Creazione di un file di chiave privata e quindi creazione dell'applicazione Auth registrata con quella chiave.
  • Configurazione degli attivatori in Adobe Analytics.
La configurazione Adobe Analytics non rientra nell'ambito di questo documento.
Adobe Campaign richiede le seguenti informazioni da Adobe Analytics:
  • Nome dell'applicazione Auth.
  • IMSOrgId, l’identificatore del cliente del Experience Cloud .
  • I nomi degli attivatori configurati in Analytics.
  • Nome e formato dei campi di dati da riconciliare con il database Marketing.
Parte di questa configurazione è uno sviluppo personalizzato e richiede quanto segue:
  • Conoscenza di base delle analisi di JSON, XML e Javascript in Adobe Campaign.
  • Conoscenza operativa delle API QueryDef e Writer.
  • Nozioni di funzionamento di crittografia e autenticazione utilizzando chiavi private.
Poiché la modifica del codice JS richiede competenze tecniche, non provate a farlo senza una comprensione adeguata.
Gli attivatori vengono salvati in una tabella di database. Pertanto, i dati di attivazione possono essere utilizzati dagli operatori di marketing nei flussi di lavoro di targeting.

File di autenticazione e configurazione

L'autenticazione è necessaria in quanto la pipeline è ospitata nell'Adobe Experience Cloud. Se il server Marketing è ospitato in sede, quando accede alla pipeline, deve autenticarsi per disporre di una connessione protetta. Utilizza un paio di chiavi pubbliche e private. Questa procedura è la stessa funzione di utente/password, solo più sicura.

IMSOrgId

IMSOrgId è l’identificatore del cliente sull’Adobe Experience Cloud. Impostatelo nel file instance serverConf.xml, sotto l’attributo IMSOrgId. Esempio:
<redirection IMSOrgId="C5E715(…)98A4@AdobeOrg" (…)

Generazione di chiavi

La chiave è un paio di file. È in formato RSA e dura 4096 byte. Può essere generato con uno strumento open source come OpenSSL. Ogni volta che lo strumento viene eseguito, viene generata una nuova chiave in modo casuale. Per comodità, i passaggi sono elencati di seguito:
  • openssl genrsa -out <private_key.pem> 4096
  • openssl rsa -pubout -in <private_key.pem> -out <public_key.pem>
Esempio di file private_key.pem:
----BEGIN RSA PRIVATE KEY----
MIIEowIBAAKCAQEAtqcYzt5WGGABxUJSfe1Xy8sAALrfVuDYURpdgbBEmS3bQMDb
(…)
64+YQDOSNFTKLNbDd+bdAA+JoYwUCkhFyvrILlgvlSBvwAByQ2Lx
----END RSA PRIVATE KEY----

Esempio di file public_key.pem:
----BEGIN PUBLIC KEY----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtqcYzt5WGGABxUJSfe1X
(…)
EwIDAQAB
----END PUBLIC KEY----

Le chiavi non devono essere generate da PuttyGen, OpenSSL è la scelta migliore.

Creazione di client di autenticazione in Adobe Experience Cloud

È necessario creare un'applicazione di tipo JWT effettuando l'accesso all'Adobe Analytics nell'account organizzazione corretto in Admin > User Management > Legacy Oath application .
Effettuate le seguenti operazioni:
  1. Seleziona Service Account (JWT Assertion) .
  2. Inserire il Application Name .
  3. Registra il Public key .
  4. Selezionare l'attivatore Scopes .
  5. Fate clic su Create e controllate il Application ID e Application Secret create.

Registrazione del nome dell'applicazione in Adobe Campaign Classic

L'ID applicazione del client Auth creato deve essere configurato in Adobe Campaign. Potete farlo modificando il file di configurazione dell'istanza nell' pipelined elemento, in particolare l'attributo appName.
Esempio:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Cifratura chiave

Per essere utilizzata da pipelined, la chiave privata deve essere crittografata. La cifratura viene eseguita utilizzando la funzione cryptString Javascript e deve essere eseguita sulla stessa istanza di pipelined.
Un esempio di crittografia di chiave privata con JavaScript è disponibile in questa pagina .
La chiave privata crittografata deve essere registrata in Adobe Campaign. Potete farlo modificando il file di configurazione dell'istanza nell' pipelined elemento, in particolare l'attributo authPrivateKey.
Esempio:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Avvio automatico processo tubato

Il pipelined processo deve essere avviato automaticamente. Per eseguire questa operazione, impostate l’elemento nel file di configurazione su autostart="true":
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Riavvio processo tubato

Può anche essere avviata manualmente utilizzando la riga di comando:
nlserver start pipelined@instance

Per rendere effettive le modifiche è necessario riavviare il sistema:
nlserver restart pipelined@instance

In caso di errori, cercate gli errori nell’output standard (se avviato manualmente) o nel file di pipelined registro. Per ulteriori informazioni sulla risoluzione dei problemi, consultare la sezione Risoluzione dei problemi del documento.

Opzioni di configurazione pipeline

Opzione
Descrizione
appName
ID dell’applicazione OAuth (ID applicazione) registrata in Adobe Analytics (dove è stata caricata la chiave pubblica): Admin (Amministratore) > User Management (Gestione utente) > Legacy Oath application (Applicazione giurata legacy). Refer to this  section .
authGatewayEndpoint
URL per ottenere i "token gateway".
Valore predefinito: https://api.omniture.com
authPrivateKey
Chiave privata (parte pubblica caricata in Adobe Analytics (consultare questa sezione). AES crittografato con l'opzione XtkSecretKey: xtk.session.EncryptPassword("PRIVATE_KEY");
disableAuth
Disattiva autenticazione (la connessione senza token gateway è accettata solo da alcuni endpoint pipeline di sviluppo)
findPipelineEndpoint
URL per scoprire l'endpoint di Pipeline Services da utilizzare per questo tenant. Valore predefinito: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Il periodo compreso tra 2 discariche dello stato interno del processo nello stato var/INSTANCE/pipelined.json è accessibile anche on-demand all'indirizzo http://INSTANCE/pipelined/status (porta 7781).
forzatoPipelineEndpoint
Disabilitare l'individuazione di PipelineServicesEndpoint e forzarla
monitorServerPort
Il pipelined processo è in ascolto di questa porta per fornire lo stato interno del processo all'indirizzo http://INSTANCE/pipelined/status (porta 7781).
puntatoreFlushMessageCount
Quando questo numero di messaggi viene elaborato, gli offset vengono 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 presenza 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)