Esempi di codice e descrizioni per casi d’uso specifici di 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 e invia ad Audience Manager un URL di riferimento.
Questo metodo funziona solo quando gli utenti si spostano tra pagine con protocolli simili (HTTP o HTTPS). Ad esempio, il browser mantiene un URL di riferimento quando si passa da un sito protetto a un altro sito protetto. I browser non mantengono l’URL di riferimento quando si passa da un sito sicuro a un sito non protetto. Questo comportamento è normale funzionalità del browser e non può essere eluso da DIL.
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();
Invia ad Audience Manager informazioni sul tipo di motore di ricerca e sulle ricerche per parola chiave.
Questa sezione descrive le funzionalità legacy non supportate nelle versioni più recenti di DIL.
Motori di ricerca supportati
Per impostazione predefinita, DIL.getSearchReferrer
riconosce le ricerche da questi motori di ricerca (comprese le varianti internazionali):
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();
}
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
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:
Crea un nuovo contenitore o apri un contenitore esistente.
Aggiungi un nuovo tag al contenitore .
Apri il tag per modificarlo e:
<script>DIL code</script>
.Pubblica il contenitore .
Genera il codice del tag contenitore e inseriscilo nel tuo inventario.