Questo tutorial si applica se disponi sia di Adobe Audience Manager (AAM) che di Adobe Analytics e stai attualmente inviando un hit dalla pagina all’AAM utilizzando DIL (Data Integration Library) e l'invio di un hit dalla pagina ad Adobe Analytics. Poiché si dispone di entrambe queste soluzioni e poiché fanno entrambe parte di Adobe Experience Cloud, è possibile seguire la best practice di attivazione dell'inoltro lato server, che consente Analytics server di raccolta dati per inoltrare i dati di analisi del sito in tempo reale ad Audience Manager, invece di richiedere che il codice lato client invii un hit aggiuntivo dalla pagina all’AAM. Questo tutorial illustra i passaggi necessari per passare dall’implementazione precedente di DIL lato client al più recente metodo di inoltro lato server.
Quando si confrontano e si confrontano questi due metodi per ottenere i dati di Adobe Analytics nell’AAM, potrebbe essere utile innanzitutto visualizzare le differenze nell’immagine seguente:
Se utilizzi questo metodo per inserire i dati di Adobe Analytics nell’AAM, puoi avere due risultati provenienti dalle pagine web: uno Analytics, e uno verso l'AAM (dopo aver copiato il Analytics nella pagina Web. Segments vengono restituiti dall’AAM alla pagina, dove possono essere utilizzati per la personalizzazione e così via. Questa viene considerata un’implementazione legacy e non è più consigliata.
Oltre al fatto che non si tratta di seguire le best practice, gli svantaggi dell’utilizzo di questo metodo includono:
È consigliabile passare a un metodo di inoltro lato server per l’implementazione dell’AAM.
Come mostrato nell’immagine precedente, un hit viene dalla pagina web ad Adobe Analytics. Analytics inoltra quindi tali dati all’AAM in tempo reale, e i visitatori vengono valutati in caratteristiche AAM e segments, come se l’hit provenisse direttamente dalla pagina.
Segments vengono restituiti sullo stesso hit in tempo reale a Analytics, che inoltra la risposta alla pagina web per la personalizzazione e così via.
Non esiste alcun downside temporale per il passaggio a Server-Side Forwarding. Adobe consiglia vivamente a chiunque abbia sia Audience Manager che Analytics utilizza questo metodo di implementazione.
Ci sono un bel po 'di informazioni su questa pagina, ed è tutto importante, naturalmente. Tuttavia, tutto si riduce a due cose principali da fare:
Se salti una di queste attività, l'inoltro lato server non funzionerà correttamente. In questo documento sono stati aggiunti passaggi e dati aggiuntivi per aiutarti a eseguire questi due passaggi correttamente per la tua configurazione.
Quando passi dall’inoltro lato client a quello lato server, una delle attività che dovrai svolgere è quella di modificare il codice per inserirlo nel nuovo codice di inoltro lato server. Questa operazione viene eseguita utilizzando una delle seguenti opzioni:
doPlugins
funzione all'interno del appMeasurement.js
file, se non utilizzi (ancora) Adobe LaunchdoPlugins
, ovunque l’altro gestore di tag memorizzi AppMeasurement codiceEsamineremo ciascuno di questi elementi di seguito nella Aggiornamento del codice sezione.
I passaggi seguenti descrivono l’implementazione.
Il prerequisito principale per passare all'inoltro lato server è l'implementazione del servizio ID Experience Cloud. Questa operazione è più semplice se si utilizza Experience Platform Launch, nel qual caso è sufficiente installare l’estensione ECID e fare il resto.
Se utilizzi un TMS non Adobe, o nessun TMS, implementa ECID per l’esecuzione prima di qualsiasi altra soluzione di Adobe. Consulta la Documentazione ECID per ulteriori dettagli. L’unico altro prerequisito è relativo alle versioni del codice, quindi puoi applicare semplicemente le versioni più recenti del codice nei passaggi seguenti.
Leggi l’intero documento prima di implementare. La sezione "Tempistiche" riportata di seguito contiene informazioni importanti su quando devi implementare ogni elemento, incluso ECID (se non è ancora implementato).
Quando ti prepari a passare dal codice DIL lato client all’inoltro lato server, il primo passaggio consiste nell’identificare tutto ciò che si sta facendo con il codice DIL, inclusi le impostazioni personalizzate e i dati inviati all’AAM. Gli aspetti da considerare includono:
siteCatalyst.init
Modulo DIL - Non devi preoccuparti di questo, perché il suo lavoro è solo quello di inviare il normale Analytics e questo accade semplicemente perché è stato abilitato l’inoltro lato server.DIL.create
funzione, annota partner
parametro. Questo è noto come "sottodominio partner" o talvolta "ID partner" e sarà necessario quando inserisci il nuovo codice di inoltro lato server.In entrata Opzioni di implementazione (sopra), sono fornite più opzioni relative a come e dove si implementa l’inoltro lato server. Affinché questa sezione sia efficace, è necessario suddividerla in queste sezioni (con due di esse combinate). Vai al metodo di questa sezione che descrive meglio le tue esigenze.
Guarda il video seguente per scoprire come spostare le opzioni di implementazione dal codice DIL lato client all’inoltro lato server nel Experience Platform Launch.
Guarda il video seguente per scoprire come spostare le opzioni di implementazione dal codice DIL lato client all’inoltro lato server in AppMeasurement che risiedono in un file o in un sistema di gestione dei tag non Adobe.
Finora in questo tutorial abbiamo dedicato tutto il nostro tempo a passare dal codice DIL lato client all’inoltro lato server. Va bene, perché è la parte più difficile. Questa sezione, anche se è molto semplice, è importante quanto l’aggiornamento del codice. Questo video illustra come capovolgere lo switch che consente l’effettivo inoltro di dati da Analytics ad Audience Manager.
NOTA: Come indicato nel video, ricorda che saranno necessarie fino a 4 ore per consentire la piena implementazione dell’inoltro sul backend Experience Cloud.
Come promemoria, ci sono due attività principali per passare dal DIL lato client all’inoltro lato server:
Ma la domanda è, quale fai per primo? Importa? Ok, scusate, erano due domande. Ma le risposte sono… dipende, e sì, può è importante. Com'è per essere vago? Suddividiamola. Ma prima una domanda aggiuntiva che può venire fuori se siete una grande organizzazione con numerosi siti: Devo fare tutto in una volta? Quello è un po' più facile. No. Potete farlo pezzo per pezzo.
Il motivo per cui la tempistica e l'ordine contano è a causa di come inoltro davvero lavori, che possono essere sintetizzati nei seguenti elementi tecnici:
Sulla base di questi dettagli tecnici, ecco le raccomandazioni su cosa fare e quando:
Capovolgere l'interruttore Analytics per ogni report suite che abiliterai per l’inoltro lato server.
Per sito, aggiorna il codice da client-side DIL all’inoltro lato server (ad esempio nei tag di Platform) o sulla pagina, come descritto in un’altra sezione precedente.
Prepara e pianifica in modo da essere pronto ad aggiornare il codice da DIL all’inoltro lato server PER report suite che abiliterai per l’inoltro lato server:
Capovolgere l'interruttore Analytics per abilitare l'inoltro lato server.
Non appena possibile, aggiorna il codice da client-side DIL all’inoltro lato singolo (potrebbe trattarsi dei tag di Platform o della pagina, come descritto in un’altra sezione in precedenza).
È importante che questi due passaggi si avvicinino il più possibile, perché tra i passaggi 1 e 2 di cui sopra, si avranno duplicazioni dei dati che vanno nell’AAM. In altre parole, l’inoltro lato singolo avrà iniziato a inviare dati da Analytics all'AAM, e poiché il codice DIL è ancora sulla pagina, ci sarà anche un hit che passa direttamente dalla pagina all'AAM, raddoppiando così i dati. Non appena aggiorni il codice da DIL all'inoltro lato server, questo sarà alleviato.
Se preferisci una piccola discrepanza nei dati piuttosto che una piccola duplicazione di dati, puoi cambiare l’ordine dei passaggi 1 e 2 precedenti. Lo spostamento del codice da DIL all’inoltro lato server interrompe il flusso di dati in AAM fino a quando non sei in grado di capovolgere lo switch per attivare l’inoltro lato server per report suite. In genere, i clienti preferiscono raddoppiare i dati piuttosto che perdere l’opportunità di trasformare i visitatori in caratteristiche e segments.
Questo argomento è trattato brevemente nelle sezioni precedenti, in quanto la strategia principale può essere riassunta come segue:
Esegui migrazione di un sito/report suite (o gruppo di siti/report suites) alla volta.
Tuttavia, questo può diventare un po’ complicato in base ad alcuni possibili scenari:
A causa di questi elementi, può diventare un po 'complicato. Le cose migliori che posso suggerire sono:
Il modo principale per verificare che l’inoltro lato server sia in esecuzione, consiste nell’esaminare la risposta a qualsiasi hit di Adobe Analytics proveniente dall’app.
Se non esegui l'inoltro lato server dei dati da Analytics ad Audience Manager, non esiste alcuna risposta al Analytics (oltre a un pixel 2x2). Tuttavia, se esegui l’inoltro lato server, vi sono elementi che puoi verificare nel Analytics richiesta e risposta che ti informeranno che Analytics comunica correttamente con Audience Manager, inoltrando l’hit e ricevendo una risposta.
Attenzione al falso esito “Success”. Se ricevi una risposta e tutto sembra funzionare, assicurati di disporre di stuff
oggetto nella risposta. In caso contrario, potresti visualizzare un messaggio che indica "status":"SUCCESS"
. Per quanto sembri folle, questa è la prova che NON funziona correttamente.
Questo significa che hai completato l’aggiornamento del codice nei tag di Platform o AppMeasurement, ma che l'inoltro nel Analytics Admin Console non ancora completato. In questo caso è necessario verificare di aver abilitato l’inoltro lato server in Analytics Admin Console per report suite. Se lo hai fatto, e non sono ancora passate 4 ore, attendi, poiché potrebbe essere necessario attendere così tanto per apportare tutte le modifiche necessarie sul backend.
Per ulteriori informazioni sull'inoltro lato server, vedi documentazione.