Casi d’uso DIL ed esempi di codice

Esempi di codice e descrizioni per casi d’uso specifici di DIL.

Inviare elementi dati ad Audience Manager con DIL

Crea una variabile oggetto che invia ad Audience Manager informazioni sugli elementi della pagina. Questo è utile per la raccolta di dati generali o come alternativa alla raccolta di dati con le variabili di Analytics.

Descrizione

Il codice seguente illustra come raccogliere i dati della pagina e inviarli ad Audience Manager con DIL. In questi esempi viene utilizzata una variabile per contenere gli elementi dati in un elenco semplice o in una matrice. Ricorda, passa le variabili come coppie chiave-valore. Inoltre, tieni presente il prefisso c_ prima della chiave nella coppia chiave-valore. Questo prefisso obbligatorio identifica le informazioni come dati definiti dall'utente. Nel primo esempio, devi aggiungere manualmente c_ alla chiave. Nel secondo esempio, DIL esegue automaticamente questa operazione.

Mantieni proprietà valore coerenti

Ricorda di mantenere le proprietà del valore uguali quando trasmetti i dati. Ad esempio, in presenza di due chiavi identiche con valori diversi, il valore dell'ultima coppia chiave-valore ha la precedenza sugli oggetti valore precedenti. Ad esempio, se si passano color:blue e color:red il valore restituito viene impostato su rosso (sovrascrive il blu).

Esempio 1: Inviare dati come coppie chiave-valore

Questo esempio di base invia i dati su colori e prezzi ad Audience Manager sotto forma di coppie chiave-valore. Il codice sarà simile al seguente:

var sample_dil = DIL.create({partner:"partner name"}); 
sample_dil.api.signals({ 
   c_color:"blue", 
   c_price:"900" 
}); 
sample_dil.api.submit();

Esempio 2: Inviare dati in un oggetto

Questo esempio avanzato illustra come inviare ad Audience Manager i dati di un oggetto. Quando si utilizza questo metodo, DIL consente di passare un oggetto come parametro di funzione nel metodo signals(). DIL Il codice sarà simile al seguente:

var my_object = { 
   color : "blue", 
   price : "900" 
}; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager. 
sample_dil.api.signals(my_object,"c_").submit();

Esempio 3: Inviare dati di pagina in un array

In questo caso, la variabile my_object utilizza un array per contenere i dati. Questo esempio si basa sulle informazioni trasmesse dal metodo consigliato di cui sopra, ma aggiunge un livello aggiuntivo per contenere un tipo di prodotto e un modello. Il codice sarà simile al seguente:

var my_objects = [{ 
   color : "blue", 
   price : "900" 
}, { 
   type : "acura", 
   model : "tl" 
}]; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
 
for (var i = 0; i < my_objects.length; i++) 
//Load the object and append "c_" to all the keys in the key-value pairs.  
{ 
    sample_dil.api.signals(my_objects[i], "c_"); 
} 
sample_dil.api.submit();

Cattura URL di riferimento

Cattura e invia ad Audience Manager un URL di riferimento.

Esempio di codice

Il codice sarà simile al seguente:

var adobe_dil = DIL.create({ partner : "partner name" }); 
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

Acquisire i tipi di motori di ricerca e i termini di ricerca delle parole chiave

Invia ad Audience Manager informazioni sul tipo di motore di ricerca e sulle ricerche per parola chiave.

Motori di ricerca supportati

Per impostazione predefinita, DIL.getSearchReferrer riconosce le ricerche da questi motori di ricerca (comprese le varianti internazionali):

• AOL
• Ask
• Bing
• Google
• Yahoo!

Descrizione

Il codice seguente illustra come ottenere il referente di ricerca per uno qualsiasi dei motori di ricerca supportati. In questo caso, supponiamo che un utente abbia cercato il termine "home" da Google Canada ( www.google.ca). Questo codice ti aiuterà a acquisire quei termini di ricerca e inviarli ad Audience Manager.

Codice di base

Il codice di base per ottenere il referente di ricerca (ad esempio da google.com) si presenta così:

var search_referrer = DIL.tools.getSearchReferrer();

Esempio di codice del motore di ricerca elencato

In questo caso, supponiamo che un utente abbia cercato il termine "home" da Google Canada ( www.google.ca). Il codice prefissa il parametro c_ richiesto al motore di ricerca ( c_se) e al termine di ricerca ( c_st). c_ è un prefisso obbligatorio che identifica ad Audience Manager queste variabili definite dal cliente.

var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

Esempio di codice del motore di ricerca non elencato

In questo caso, supponiamo che un utente abbia cercato il termine "home" da dogpile.com. Poiché Dogpile non è supportato per impostazione predefinita, è possibile configurare DIL per riconoscere questo motore di ricerca e restituire ad Audience Manager i termini di ricerca. Il codice sarà simile al seguente:

var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {  
    hostPattern:/dogpile\./, 
    queryParam:"q" 
}); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

Mappatura dei valori chiave su altre chiavi

Associa il valore da una coppia chiave-valore a un’altra chiave.

Descrizione

In una coppia chiave-valore, il prefisso c_ aggiunto alla chiave identifica il segnale come dati definiti dal cliente. I dati definiti dal cliente vengono utilizzati per il targeting sul sito specifico che ha trasmesso i dati in una chiamata evento. Tuttavia, a volte è necessario che queste informazioni siano disponibili in tutte le proprietà dell'account Audience Manager. A questo scopo, mappa il valore in una coppia chiave/valore c_ su una chiave a livello di piattaforma. Una chiave a livello di piattaforma ha il prefisso d_ e rende il segnale disponibile per il targeting su tutte le proprietà del tuo account.

Ad esempio, puoi raccogliere dati di codice ZIP da un particolare sito ma desideri indirizzarli a tutte le proprietà di Audience Manager. Per rendere disponibile il codice ZIP a livello di piattaforma, puoi mappare la chiave del codice ZIP definita dal cliente (ad esempio c_zip) a una chiave definita dalla piattaforma come mostrato di seguito.

Esempio di codice

Il codice sarà simile al seguente:

var adobe_dil = DIL.create({ 
    partner : "adobe", 
    mappings : { 
        c_zip : 'd_zip', 
        d_key2 : 'h_dil_key2' 
    } 
}); 
adobe_dil.api.signals({c_zip : '10010'}).submit(); 
// Request will look like /event?c_zip=10010&d_zip=10010

DIL del traffico in Google Tag Manager (GTM)

Configura e distribuisci DIL con un tag GTM.

Questa procedura presuppone che tu disponga di un account Google Tag Manager, che il prodotto sia a conoscenza del suo funzionamento e che il tuo file di Audience Manager dil.js sia presente.

Per eseguire il traffico del file dil.js in GTM:

1. Crea un nuovo contenitore o apri un contenitore esistente.

2. Aggiungi un nuovo tag al contenitore .

3. Apri il tag per modificarlo e:

   • Denomina il tag .
   • Seleziona Custom HTML Tag dall'elenco a discesa Tag Type.
   • Nel campo HTML , inserisci il codice DIL (libreria + codice personalizzato) all'interno dei tag script <script>DIL code</script>.
   • Clic Save.

4. Pubblica il contenitore .

5. Genera il codice del tag contenitore e inseriscilo nel tuo inventario.