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.
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 e invia un URL di riferimento a Audienci Manager.
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();
Invia ad Audience Manager informazioni sul tipo di motore di ricerca e sulle ricerche per parole 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 effettuate 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
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();
}
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
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:
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 tag contenitore e inseriscilo nel tuo inventario.