Casi d’uso di DIL ed esempi di codice dil-use-cases-and-code-samples

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

Inviare elementi dati ad Audience Manager con DIL send-data-elements-dil

Crea una variabile oggetto che invia informazioni sugli elementi della pagina a Audience Manager. Questa funzione è utile per la raccolta dati generali o in alternativa alla raccolta di dati con variabili di Analytics.

Descrizione

Nel codice seguente viene illustrato come raccogliere i dati della pagina e inviarli all'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, annota 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 le proprietà dei valori coerenti

Ricorda di mantenere le stesse proprietà del valore quando si trasmettono i dati. Ad esempio, se disponi di due chiavi identiche con valori diversi, il valore dell’ultima coppia chiave-valore ha la precedenza rispetto agli oggetti valore precedenti. Ad esempio, passando color:blue e color:red, il valore restituito viene impostato su rosso (sovrascrive il blu).

Esempio 1: inviare dati come coppie chiave-valore

In questo esempio di base i dati relativi a colore e prezzo vengono inviati 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

In questo esempio avanzato viene illustrato come inviare dati in un oggetto a Audience Manager. Quando si utilizza questo metodo, DIL consente di passare un oggetto come parametro di funzione nel metodo signals(). DIL Il codice potrebbe essere 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 in precedenza, ma aggiunge un livello aggiuntivo per ospitare un tipo e un modello di prodotto. 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();

Acquisisci URL di riferimento capture-referring-url

Acquisisci e invia un URL di riferimento a Audience Manager.

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 motore di ricerca e i termini di ricerca per parola chiave capture-search-engine-types

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

Motori di ricerca supportati

Per impostazione predefinita, DIL.getSearchReferrer riconosce le ricerche da questi motori di ricerca (incluse 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 eseguito una ricerca nel termine "home" da Google Canada ( www.google.ca). Questo codice ti aiuterà a catturare questi termini di ricerca e a inviarli ad Audience Manager.

Codice di base

Il codice di base per ottenere il referente di ricerca (ad esempio da google.com) è simile al seguente:

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). Si noti che 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 queste variabili come variabili definite dal cliente da Audience Manager.

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 i termini di ricerca ad Audience Manager. 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();
}

Mappare i valori delle chiavi ad altre chiavi map-key-values

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 vorresti che queste informazioni fossero disponibili in tutte le proprietà del tuo account di Audience Manager. A questo scopo, mappare il valore di una coppia chiave-valore c_ a una chiave a livello di piattaforma. Una chiave a livello di piattaforma ha il prefisso d_ e rende il segnale disponibile per il targeting in tutte le proprietà del tuo account.

Ad esempio, puoi raccogliere i dati del codice postale da un particolare sito, ma desideri eseguirne il targeting per tutte le proprietà dell’Audience Manager. Per rendere disponibile il codice postale a livello di piattaforma, puoi mappare il codice postale definito dal cliente (ad esempio c_zip) su 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) traffic-dil-gtm

Imposta e distribuisci DIL con un tag GTM.

Questa procedura presuppone che tu disponga di un account Google Tag Manager, di alcune conoscenze operative di quel prodotto e del tuo file di Audience Manager dil.js.

Per inviare il traffico al file dil.js in GTM: