Show Menu
ARGOMENTI×

Integrazione DFA

La configurazione dell’integrazione del DFAE comporta le seguenti attività:

Configurare l’integrazione DFA

Integrazione dei connettori dati del DFA.
Le pagine di configurazione forniscono una panoramica dell'integrazione, insieme a utili collegamenti per ulteriori informazioni. A questa integrazione sono associate sia le tariffe Adobe che DoubleClick. Contatta i rappresentanti di vendita appropriati per entrambe le organizzazioni e assicurati di conoscere la struttura delle tariffe.
  1. Log in to the Adobe Analytics.
  2. Fai clic su Admin > Data Connectors .
  3. Individua DoubleClick DFA , quindi fai clic su Add New .
    In ogni pagina della procedura guidata di integrazione, fornire le informazioni richieste, quindi fare clic Next . Nella tabella seguente sono illustrate le informazioni necessarie per completare l'integrazione tramite la procedura guidata.
Pagina della procedura guidata # Campo Descrizione
1 Nome integrazione Il nome dell'integrazione visualizzato da Genesis nell'Elenco di integrazione attiva della suite di rapporti.
1 Indirizzo e-mail integrazione L'indirizzo e-mail che riceve tutte le notifiche correlate a questa integrazione.
2 Nome utente Il nome utente dell’API DFA da utilizzare con questa integrazione. Per abilitare un utente per l'accesso alle API, controllate l'attributo API nell'interfaccia DFA. Dopo aver attivato il login all'API, viene visualizzato un campo password per fornire una password all'utente. Questa password viene inserita insieme al nome utente nella procedura guidata di autenticazione.
2 Password La password dell’API DFA.
2 ID inserzionista
L’ID dell’inserzionista DFA o l’ID di configurazione del flusso principale. I Connettori dati utilizzano questo ID per identificare l’inserzionista DFA da monitorare (versione 1.5 dell’integrazione). Questo ID inserzionista non viene utilizzato nella versione 2.0 dell'integrazione. L'ID configurazione Floodlight padre verrà cercato e utilizzato. Vedere le istruzioni sullo schermo
3 Variabile annuncio DFA L'eVar di Analytics che riceve l'attributo della campagna DFA, le impression e i dati di clic. In genere si tratta dell'eVar del codice di tracciamento ( s.campaign ), ma potete scegliere qualsiasi eVar disponibile. I Connettori dati aggiungono inoltre le seguenti classificazioni relative al DFA all'eVar selezionata:
Campagne : Una raccolta di annunci serviti a più siti che contengono messaggi comuni.
Nome sito: Il sito in cui è stato distribuito l’annuncio.
Nome annuncio: Il nome dell'annuncio, come definito nel tuo account DFA.
Nome posizionamento sito: Il sito Web e la pagina in cui è stato distribuito l'annuncio.
Strumento di consegna: Doppio clic per inserzionisti.
Canale : Annuncio banner.
Struttura dei costi: CPM, CPC o Fisso, in base alla struttura dei costi dell’annuncio.
Nome creativo: Nome del creativo associato a un ID annuncio/posizionamento/creativo.
DFA > Deduplicazione SearchCenter: Specifica che il DFAE deve inserire i valori nelle variabili del Centro di ricerca quando si verificano click-through DFA o View-through. .
4 Impressioni Evento personalizzato che riceve i dati delle metriche Impression DFA. Impression indica il numero di volte in cui l’annuncio è stato distribuito.
4 Clic Selezionate l’evento personalizzato che riceve i dati delle metriche Clic DFA. I clic indicano il numero di volte in cui i visitatori hanno fatto clic sull’annuncio, misurato dal reindirizzamento del DFAE. La metrica Click è correlata alla metrica Click-through di Analytics.
Nota: Clic DFA e Click-through di Analytics potrebbero non corrispondere esattamente a causa delle differenze nelle modalità di raccolta dei dati. .
5 Variabile View-Through
L'eVar di Analytics che riceve i dati View-Through DFA. La variabile View-Through consente di vedere in che modo le visualizzazioni influiscono sui tassi di conversione sul sito.
I Connettori dati aggiungono a questa eVar le stesse classificazioni relative al DFA e alla Variabile annuncio del DFA (vedi sopra).
5 Ora dall’ultima visualizzazione (variabile periodo fisso vista-through) L'eVar di Analytics che riceve l'ora DFA dall'ultima visualizzazione dati. L’ora dall’ultima visualizzazione indica il tempo trascorso dall’ultima visualizzazione annuncio.
5 Visualizza-through L’evento personalizzato che riceve i dati delle metriche di visualizzazione DFA attraverso. Utilizzare l'evento View-through con la variabile View-Through per vedere quali campagne non hanno influenzato un click-through diretto, ma hanno avuto un ruolo nel traffico verso il sito in un momento successivo.
I Connettori dati rinominano l'evento personalizzato selezionato in "Visualizza attraverso".
6 Errore query DFA (Facoltativo) L'eVar di Analytics che riceve tutti i codici messaggio di errore query DFA segnalati. I possibili codici messaggio DFA includono:
  • nc : Nessun cookie DoubleClick.
  • o : L'utente ha rinunciato.
  • nh : Nessuna cronologia delle campagne.
  • qe : Errore di query (timeout, inattività del server, ecc.)
6 Evento timeout
L'evento del contatore di Analytics che aumenta ogni volta che scade il timer s.maxDelay , e non è stata ricevuta alcuna risposta dai server DFA. Utilizzate questo evento per configurare la variabile s.maxDelay Sintonizzazione s.maxDelay .)

Aggiornamenti del sito Web per l'integrazione DFA

Dopo che Genesis ha configurato la suite di rapporti di Analytics per l'integrazione DFA, devi effettuare le seguenti operazioni per configurare il tuo sito Web e l'ambiente DFA per supportare l'integrazione:

Aggiorna il parametro query-stringa DFA

Se hai già eseguito il tracciamento delle campagne pubblicitarie con Adobe Analytics prima dell'integrazione DFA, è possibile che tutte le campagne (e-mail, ricerca o banner) utilizzino lo stesso parametro della stringa di query per identificare l'ID campagna di provenienza sulla pagina di destinazione.
Per capire quando richiedere dati di visualizzazione e click-through dai dati DFA per le campagne DFA Ad, i Connettori dati devono identificare quando un visitatore ha fatto clic su un banner pubblicitario di campagna DFA. Per rendere possibile questa operazione, devi aggiungere un parametro di stringa di query differenziata all'URL della pagina di destinazione della campagna DFA Ad in modo che i Connettori dati possano distinguere tra le pagine della campagna DFA Ad e altre pagine della campagna pubblicitaria che potresti avere sul tuo sito Web. Il plug- dfa_overrideParam in JavaScript utilizzato per il DFA.
Anche se la variabile Campaign può essere utilizzata per altre campagne, non utilizzarla per le campagne DFA. Se imposti la variabile Campagna su una pagina di destinazione della campagna DFA, Adobe non può collegare impression e clic ai click-through della campagna DFA. Una volta effettuata la visita, i server di raccolta Adobe controllano i server DFA per verificare la presenza di un click-through precedente. Per questo motivo, includete il codice plug-in DFA solo su pagine di destinazione comuni, per evitare reindirizzamenti inutili che possano rallentare i tempi di caricamento delle pagine, in particolare per gli utenti con connessioni Internet più lente.

Aggiorna il codice di raccolta dati del sito Web

L’integrazione di Genesis per il DFA sfrutta l’ID di configurazione DFA Floodlight (dfa_SPOTID), che migliora la coerenza dei rapporti tra il DFA e il sistema di raccolta dei dati Adobe.
Il termine Spotlight è stato modificato in Floodlight in una recente release di Google DFA. Il parametro JavaScript dfa_SPOTID è stato denominato in base alla terminologia Spotlight, ma viene utilizzato per entrambe le versioni.
Per abilitare l'integrazione DFA sul sito Web, è necessario aggiornare il codice di raccolta dati JavaScript aggiungendo quanto segue:
  • Modulo integrato per DFA
  • Aggiunta al codice della raccolta

Modulo integrato per DFA

L’integrazione DFA sfrutta il modulo Adobe Experience Cloud Integrate, che aggiunge funzionalità al codice di raccolta dati JavaScript di base ( s_code.js ). Il modulo Integrate fa parte del file .zip quando si scarica il codice AppMeasurement per JavaScript da Gestione codici. Contatta il tuo Adobe Consultant solo se hai bisogno di ulteriore aiuto per trovarla.
Inserite il codice Modulo integrato nella Modules sezione del s_code.js file del sito Web.

Aggiunta al codice della raccolta

In base alle selezioni effettuate durante l'attivazione dell'integrazione DFA nella procedura guidata di integrazione, i Connettori dati generano ed inviano tramite e-mail un'aggiunta personalizzata al codice di raccolta dati JavaScript. Inserire questo codice nella sezione principale del s_code.js file (non nella doPlugins funzione o in qualsiasi altra funzione).
Il codice di esempio riportato di seguito è solo a scopo illustrativo; utilizzare il codice che ti è stato inviato via e-mail dopo aver completato l'Integrazione guidata Connettori dati.
Il codice della raccolta è costituito dai seguenti componenti:
  • Impostazioni di integrazione DFA
  • Plug-in richiesti per l'integrazione
Impostazioni di integrazione DFA
/************************** DFA VARIABLES **************************/ 
var dfaConfig = { 
   CSID:              "1234567", 
   SPOTID:            "29876543", 
   tEvar:             "eVar17", 
   errorEvar:         "eVar59", 
   timeoutEvent:      "event76", 
   requestURL:         "http://fls.doubleclick.net/ 
json?spot=[SPOTID]&src=[CSID]&var=[VAR]&host=integrate.112.2o7.net%2 
Fdfa_echo%3Fvar%3D[VAR]%26AQE%3D1%26A2S%3D1&ord=[RAND]", 
 
   maxDelay:          "1500", 
   visitCookie:       "s_dfa", 
   clickThroughParam: "CID", 
   searchCenterParam: "s_kwcid", 
   newRsidsProp:      undefined 
}; 
/************************ END DFA Variables ************************/ 

Il blocco delle impostazioni integrate DFAE imposta le variabili richieste dall’integrazione del DFAE. I valori per ciascuna di queste variabili provengono dalle origini seguenti:
CSID : ID lato client. Generato dal DFA una volta completata l'Integrazione guidata. Connettori dati precompila questa variabile con il tuo DFA CS ID e invia anche questo valore nel messaggio e-mail di configurazione dopo il completamento dell'Integrazione guidata. Questa variabile non è necessaria se sul vostro account è abilitato Advanced Ad Serving.
SPOTID : Configurazione di Floodlight (precedentemente denominato Spotlight ID). I Connettori dati precompilano questa variabile con l’ID di configurazione DFA Floodlight, in base alle informazioni sull’account DFA specificate nella procedura guidata di integrazione.
Evar : Variabile di trasferimento. Connettori dati precompila questa variabile con il nome della variabile Analytics specificato per la variabile View-Through nella procedura guidata di integrazione. Non modificate questo valore senza un'attenta coordinazione con Adobe Engineering o Engineering Services.
errorEvar : Variabile di errore. Connettori dati precompila questa variabile con il nome della variabile Analytics specificato per la variabile Errore query DFA nella procedura guidata di integrazione.
timeoutEvent : Evento Timeout. Connettori dati precompila questa variabile con il nome della variabile Analytics specificato per la variabile Evento timeout nella procedura guidata di integrazione.
requestURL : Host DFA remoto per richiedere informazioni sugli annunci. Non modificate questo valore a meno che non sia richiesto da Adobe.
maxDelay : Specifica il tempo in millisecondi che il codice JavaScript di raccolta dati attende una risposta dal server DFA Floodlight. Adobe consiglia di sperimentare questo valore per trovare il valore ottimale in base al traffico del sito. Ad esempio, se si aumenta questo valore, in genere vengono raccolti più dati DFA, ma aumenta il rischio di perdere i dati del visitatore di base se il visitatore lascia il sito durante il periodo di ritardo. Riducendo questo valore si riduce il rischio di perdita di dati hit, ma si può ridurre la quantità di dati DFA inviati con i dati hit Adobe.
visitCookie : Nome del cookie utilizzato per limitare le chiamate DFA a una volta per visita.
clickThroughParam : Una stringa di query, solitamente inclusa in tutti gli annunci, che notifica al modulo Integrate che si è appena verificato un clic. La presenza di questo parametro nella stringa di query determina l'esecuzione della richiesta ai server DFA Floodlight, indipendentemente dal fatto che il visitatore sia già stato interrogato negli ultimi 30 minuti.
newRsidsProp : (Facoltativo) Mappata a una variabile della proprietà Traffico non utilizzata. L’integrazione DFAE raccoglie e memorizza questo valore nel cookie della visita per identificare le suite di rapporti che hanno raccolto i dati per un particolare visitatore. Questa proprietà è necessaria solo con le implementazioni personalizzate con i servizi tecnici Adobe.
Plug-in richiesti per l'integrazione
L'aggiunta del codice di raccolta include plug-in aggiuntivi che migliorano il funzionamento dell'integrazione DFAE:
  • Limita le query DFA a una sola visita
  • Offre flessibilità per il nome dei cookie. Anche se la maggior parte delle organizzazioni utilizza s_dfa, è possibile utilizzare qualsiasi nome di cookie valido per l'integrazione DFA.
  • Elimina i reindirizzamenti non necessari. Poiché i dati di visualizzazione vengono raccolti in tempo reale, i server di raccolta Adobe e il DFA potrebbero potenzialmente scambiare dati su ogni visualizzazione di pagina. Il plug-in blocca questi scambi di dati quando le informazioni non sono necessarie.
Uno dei meccanismi utilizzati dal plug-in per eliminare le query DFA non necessarie è un cookie di visita basato su dominio. Una suite di rapporti per l'integrazione che si estende su più domini aumenta i dati di click-through e visualizzazione through quando i visitatori attraversano più domini dopo una visualizzazione o un click-through influenzati dal DFA.

Conferma di un'integrazione DFA di successo

Dopo aver effettuato tutti gli aggiornamenti necessari al sito Web, potete utilizzare un visualizzatore del traffico di rete, come Charles*, Chrome Developer Tools o Firebug*, per confermare che DFA sta comunicando con i server di raccolta Adobe.
Dopo aver distribuito il s_code.js file abilitato per il DFA, utilizzate il visualizzatore del traffico di rete per visualizzare le richieste tra il DFA e i server di raccolta dati Adobe, alla ricerca di quanto segue:
  • Una richiesta al fls.doubleclick.net/json servizio del DFAE. Questo servizio può rispondere in modo diverso a seconda della versione del DFAE in uso. Con la versione 1.5 dell’integrazione DFAE:
    • Reindirizzamento HTTP 302 a ad.doubleclick.net. Verrà inviata una posizione: nella risposta che contiene informazioni sul visitatore dell'annuncio.
    • Questo tag Location causa il reindirizzamento a integrate.112.2o7.net/dfa_echo. Questo servizio traduce le informazioni sul visitatore dell'annuncio in una stringa codificata JSON (JavaScript Object Notati on). Questi dati vengono restituiti con una risposta HTTP di 200 OK.
  • Con l'integrazione DFA versione 2.0 (Advanced Ad Serving enabled):
    • fls.doubleclick.net risponderà direttamente con 200 OK.
In entrambi i casi, una richiesta corretta darà luogo a una richiesta ai server di raccolta dati Adobe che contengono il parametro vX, dove X è il numero eVar View-Through. Questo valore di parametro assume la forma: DFA-XXXX-XXXX- XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX. Questa stringa contiene i dati sull’ultimo clic e l’ultima impressione per il visitatore corrente.

Tuning s.maxDelay

Per ottenere una corretta implementazione DFA è necessario ottimizzare s.maxDelay per il sito specifico.
In generale, la decisione di aumentare o diminuire s.maxDelay comporta un compromesso tra l’ottenimento di più dati visitatore DFA e la raccolta dei dati dei visitatori Adobe in pericolo. Aumentando s.maxDelay ottiene più dati visitatore DFA, ma (inseriti eccessivamente alti) potrebbe compromettere la raccolta dei dati visitatore Adobe. La riduzione di s.maxDelay assicura la raccolta dei dati dei visitatori Adobe, ma potrebbe perdere i dati dei visitatori DFA.
s.maxDelay incapsula più del semplice tempo di comunicazione in rete per contattare il DFAE; rappresenta anche i ritardi del browser per attivare e valutare il codice JavaScript da cui si basano tali comunicazioni. Questo perché il modulo Integrate avvia il s.maxDelay timer dopo che ha inserito l'elemento HTML nel DOM che estrae i dati dal server DFA Floodlight. Il tempo necessario affinché il browser avvii effettivamente la richiesta HTTP in base a questo nuovo elemento HTML varia in base ad altre immagini o file JavaScript che vengono caricati contemporaneamente, alla velocità del computer dei visitatori e a specifiche implementazioni del browser. Inoltre, quando i dati JSON vengono recuperati dal server DFA Floodlight, JavaScript deve essere valutato dal browser. Anche questa operazione è controllata completamente dal browser e può essere ritardata in caso di grandi quantità di codice JavaScript in esecuzione simultanea o di molte richieste JavaScript asincrone.
A tal fine, s.maxDelay è necessario impostare la pagina di destinazione in base alla complessità della pagina e al ritardo della rete con il DFAE. In alcuni siti, un modo possibile per ridurre la complessità consiste nell'attivare il codice di raccolta Adobe all'inizio del caricamento della pagina, in modo che il browser non venga utilizzato al momento della richiesta del server Floodlight.
La variabile Timeout è assolutamente necessaria durante l'ottimizzazione s.maxDelay , perché viene incrementata ogni volta che viene raggiunto il timeout s.maxDelay. Per decidere se aumentare o diminuire s.maxDelay consigliamo di seguire questo processo:
  1. Raccogliere diversi giorni di dati con s.maxDelay un valore particolare.
  2. Eseguire un Daily Unique Visitors Report intervallo di tempo.
  3. Eseguite il comando Timeout Event Report per controllare il numero di timeout che stanno arrivando. Ricorda che un timeout viene raccolto solo una volta per visitatore.
Ora con le cifre in mano, calcolare
Timeout Percentage = [Step 3] / [Step 2] * 100

La percentuale di timeout sta prendendo in considerazione tutti i visitatori del sito. Alcuni di questi visitatori non sarebbero stati legati al DFAE, quindi il timeout è fuorviante. Per migliorare questo calcolo, un'altra analisi potrebbe considerare solo i visitatori univoci nelle pagine con il clickThroughParam set (ad esempio, ?CID=1 ). Questo mostrerà più precisione.
Se la percentuale di timeout è molto bassa, prendete in considerazione la riduzione s.maxDelay . Se è molto alto, aumentare s.maxDelay . In caso di diminuzione, s.maxDelay si desidera ripetere l'operazione per Timeout Report garantire che i timeout non siano aumentati drasticamente. Con s.maxDelay l'aumento, è necessario eseguire un'operazione Page Views Report per verificare che le visualizzazioni delle pagine non risultino compromesse a causa della perdita di dati. Ogni volta s.maxDelay viene modificato osservano i dati per diversi giorni al fine di garantire che i dati rappresentino una tendenza, e non solo una fluttuazione giornaliera.
L’impostazione ottimale per s.maxDelay è il punto in cui la percentuale di timeout viene ridotta a icona mentre le visualizzazioni pagina non vengono eliminate.
I timeout dovrebbero diminuire quando si passa alla versione 2.0 dell'integrazione, a causa delle eliminazioni dei reindirizzamenti 302. Le prime scoperte con i client beta hanno mostrato una consistente riduzione dei timeout, e quindi la raccolta di più dati DFA