Sono necessari diversi passaggi per implementare Adobe Analytics come origine di reporting per Adobe Target (A4T). Il processo varia a seconda che tu implementi A4T con il Adobe Experience Platform Web SDK o con at.js.
Le sezioni seguenti descrivono i passaggi necessari per distribuire questa integrazione al sito se intendi utilizzare Platform Web SDK:
Prima di implementare A4T, è necessario disporre del provisioning per Analytics e Target. Utilizza questo modulo per richiedere il provisioning.
I requisiti dell’account utente devono essere soddisfatti prima di poter creare un’attività basata su Analytics in Target. Consulta Requisiti delle autorizzazioni utente.
Creare una configurazione Edge tramite Adobe Experience Platform utilizzando lo strumento di configurazione degli spigoli. Configurare Analytics and Target impostazioni di configurazione edge.
Per iniziare la consegna Target esperienze e applicare Analytics a fini di tracciamento e analisi, Installa e configura Platform Web SDK sulle pagine del sito.
In Target UI, fai clic su Amministrazione > Compositore esperienza visivo, quindi scegliere Seleziona per attività o Adobe Analytics.
Le sezioni seguenti descrivono i passaggi necessari per distribuire questa integrazione al sito se intendi utilizzare at.js:
Dopo l’implementazione Analytics come origine di reporting per Target, è necessario disporre del provisioning per Analytics e Target. Utilizza questo modulo per richiedere il provisioning.
I requisiti dell'account utente devono essere soddisfatti prima di poter creare un Analyticsattività basata su in Target. Consulta Requisiti delle autorizzazioni utente.
Il servizio ID visitatore consente di identificare gli utenti attraverso le diverse soluzioni Adobe Experience Cloud. Implementa o esegui la migrazione alla versione richiesta dell’ID visitatore Experience Cloud. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.
Consulta Implementazione del servizio ID Experience Cloud per Target nel Servizio ID visitatore Experience Cloud documentazione.
Implementa o esegui la migrazione alla versione richiesta di appMeasurement.js. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.
Per le nuove implementazioni, vedi Panoramica sull’implementazione di JavaScript nel Guida all’implementazione di Analytics.
Per una migrazione, consulta Migrazione ad AppMeasurement per JavaScript nel Guida all’implementazione di Analytics.
Implementa o esegui la migrazione alla versione richiesta di at.js utilizzando il tuo account di produzione. Non sono richieste modifiche al codice.
Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.
Se at.js è stato distribuito in precedenza, puoi sostituire il file esistente con la versione aggiornata. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.
In caso contrario, il file può essere incluso in hosting insieme al servizio ID visitatore e AppMeasurement per file JavaScript. Questi file devono essere in hosting su un server web accessibile a tutte le pagine del sito. È necessario definire il percorso di questi file nella fase successiva.
Includi at.js sotto VisitorAPI.js aggiungendo la seguente riga di codice al tag in ogni pagina:
Per at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>
VisitorAPI.js deve essere caricato prima di at.js. Se stai aggiornando un file at.js esistente, accertati di verificare l’ordine di caricamento.
Impostazione predefinita per Target e Analytics dal punto di vista dell'implementazione, è utilizzare l'identificatore SDID passato dalla pagina per unire Target e Analytics richiedi automaticamente insieme sul backend.
Puoi controllare come e quando inviare dati analitici relativi a Target a Analytics a scopo di reporting. Se non si desidera aderire alle impostazioni predefinite di Target e Analytics unire automaticamente i dati di analisi tramite SDID, impostare analyticsLogging = lato_client tramite window.targetGlobalSettings. Nota: questo approccio non è supportato dalle versioni precedenti alla versione 2.1.
Ad esempio:
window.targetGlobalSettings = {
analyticsLogging: "client_side"
};
Questa configurazione ha un effetto globale, il che significa che ogni chiamata effettuata da at.js ha analyticsLogging: "client_side" inviato all'interno del Target e viene restituito un payload di analytics per ogni richiesta. Quando questa opzione è impostata, il formato del payload restituito è simile al seguente:
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
Il payload può quindi essere inoltrato ad Analytics tramite API di inserimento dati. Per le attività Allocazione automatica e Targeting automatico, devi anche inoltrare il sessionId. Per ulteriori informazioni, consulta Generazione di rapporti di Analytics for Target (A4T) nel SDK per Adobe Target guida.
Se non desideri usare un’impostazione globale e preferisci un approccio di tipo on-demand, utilizza la funzione at.js getOffers() passando analyticsLogging: “client_side”. Il payload di Analytics viene restituito solo per questa chiamata e il Target il backend non inoltra il payload a Analytics. Seguendo questo approccio, ogni at.js Target request restituisce il payload per impostazione predefinita, ma solo quando desiderato e specificato.
Ad esempio:
adobe.target.getOffers({
request: {
experienceCloud: {
analytics: {
logging: "client_side"
}
},
prefetch: {
mboxes: [{
index: 0,
name: "a1-serverside-xt"
}]
}
}
})
.then(console.log)
Questa chiamata richiama una risposta dalla quale è possibile estrarre il payload di Analytics.
La risposta si presenta come segue:
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "bucharest",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "romania"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
Il payload può quindi essere inoltrato a Analytics tramite API di inserimento dati.
Carica le pagine dopo aver aggiornato le librerie JavaScript per confermare che i valori dei parametri mboxMCSDID
Target nelle chiamate di corrispondano al valore del parametro sdid
Analytics nella chiamata di visualizzazione della pagina
È particolarmente importante confermare che questi valori corrispondano nelle applicazioni a pagina singola (SPA) in cui l’ordine delle chiamate non è sempre prevedibile.
La corrispondenza di questi valori è necessaria per il corretto funzionamento di A4T.
L’Adobe consiglia di rimuovere l’integrazione precedente per semplificare l’implementazione ed eliminare la necessità di risolvere eventuali discrepanze tra i sistemi. Puoi rimuovere il codice che hai distribuito da una precedente integrazione tra SC e T&T, tra cui mboxLoadSCPlugin
.
In entrata Target, fai clic su Amministrazione > Generazione rapporti e scegliere Seleziona per attività o Adobe Analytics per abilitare le opzioni.