Casi d’uso DIL ed esempi di codice

Ultimo aggiornamento: 2023-08-02
AVVERTENZA

A partire da luglio 2023, Adobe ha interrotto lo sviluppo del Data Integration Library (DIL) e DIL estensione.

I clienti esistenti possono continuare a utilizzare DIL implementazione. Tuttavia, Adobe non svilupperà DIL oltre questo punto. I clienti sono invitati a valutare Experienci Platform Web SDK per la strategia di raccolta dei dati a lungo termine.

I clienti che desiderano implementare nuove integrazioni di raccolta dati dopo luglio 2023 devono utilizzare Experienci Platform Web SDK invece.

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

Inviare elementi dati ad Audienci Manager con DIL

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

Descrizione

Il codice seguente illustra come raccogliere i dati della pagina e inviarli a un 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 che 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 coerenti le proprietà del valore

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 imposta il valore restituito 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 Audienci 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 Audienci Manager. Quando si utilizza questo metodo, DIL consente di passare un oggetto come parametro di funzione nel signals() metodo. 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 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

Acquisisci e invia un URL di riferimento a Audienci Manager.

NOTA

Questo metodo funziona solo quando gli utenti si spostano tra pagine con protocolli simili (HTTP vs HTTPS). Ad esempio, il browser mantiene un URL di riferimento quando ci si sposta da un sito protetto a un altro. I browser non mantengono l’URL di riferimento quando si passa da un sito protetto a uno non protetto. Questo comportamento è una normale funzionalità del browser e non può essere aggirato 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();

Acquisire i tipi di motore di ricerca e i termini di ricerca per parola chiave

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

IMPORTANTE

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 effettuate da questi motori di ricerca (incluse 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 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

Codice di base per ottenere il referente di ricerca (da google.com, ad esempio) 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). Nota come il codice prefissa il necessario c_ parametro per il motore di ricerca ( c_se) e termine di ricerca ( c_st). c_ è un prefisso obbligatorio che le identifica 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 per motore di ricerca non elencato

In questo caso, supponiamo che un utente abbia cercato il termine "home" da dogpile.com. Perché Dogpile non è supportato per impostazione predefinita, è possibile configurare DIL per riconoscere questo motore di ricerca e restituire i termini di ricerca ad Audienci 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

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

Descrizione

In una coppia chiave-valore, il c_ il prefisso 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, mappa il valore in una c_ coppia chiave-valore 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 per tutte le proprietà nel 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 il CAP disponibile a livello di piattaforma, puoi mappare la chiave del CAP definita dal cliente (ad es. c_zip) a una chiave definita dalla piattaforma, come illustrato 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)

Imposta e distribuisci DIL con un tag GTM.

Questa procedura presuppone che tu abbia Google Tag Manager del prodotto e il tuo Audience Manager dil.js file.

Per inviare traffico dil.js file 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 dal Tag Type elenco a discesa.
    • Nel campo HTML, inserisci DIL codice (libreria + codice personalizzato) all’interno di tag script <script>DIL code</script>.
    • Clic Save.
  4. Pubblica il contenitore.

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

In questa pagina