Exempel på användning i DIL och kodexempel dil-use-cases-and-code-samples

Kodexempel och beskrivningar för specifika fall för användning i DIL.

Skicka dataelement till Audience Manager med DIL send-data-elements-dil

Skapa en objektvariabel som skickar information om sidelement till Audience Manager. Detta är användbart för allmän datainsamling eller som ett alternativ till att samla in data med Analytics-variabler.

Beskrivning

Följande kod visar hur du samlar in siddata och skickar dem till Audience Manager med DIL. I de här exemplen används en variabel för att lagra dataelement i en platt lista eller en array. Kom ihåg att skicka in variabler som nyckel/värde-par. Observera också prefixet c_ före nyckeln i nyckelvärdepar. Det här nödvändiga prefixet identifierar information som användardefinierade data. I det första exemplet måste du manuellt lägga till c_ i nyckeln. I det andra exemplet gör DIL detta automatiskt åt dig.

Behåll konsekventa värdeegenskaper

Tänk på att värdeegenskaperna förblir desamma när du skickar data. Om du till exempel har två identiska nycklar med olika värden, prioriteras värdet för det sista nyckel/värde-paret framför föregående värdeobjekt. Om du till exempel skickar color:blue och color:red anges det returnerade värdet som rött (blått skrivs över).

Exempel 1: Skicka data som nyckelvärdepar

I det här grundläggande exemplet skickas färg- och prisdata till Audience Manager i form av nyckelvärdepar. Koden kan se ut ungefär så här:

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

Exempel 2: Skicka data i ett objekt

I det här avancerade exemplet visas hur du skickar data i ett objekt till Audience Manager. När du arbetar med den här metoden kan du med DIL skicka ett objekt som en funktionsparameter till metoden signals(). DIL Koden kan se ut ungefär så här:

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();

Exempel 3: Skicka siddata i en array

I det här fallet använder variabeln my_object en matris för data. Det här exemplet bygger på den information som skickas med den rekommenderade metoden ovan, men lägger till ytterligare ett lager för en produkttyp och modell. Koden kan se ut ungefär så här:

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();

Hämta referens-URL capture-referring-url

Hämta och skicka en refererande URL till Audience Manager.

Kodexempel

Koden kan se ut ungefär så här:

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

Hämta sökmotortyper och sökvillkor för nyckelord capture-search-engine-types

Skicka information om sökmotortyp och sökord till Audience Manager.

Sökmotorer som stöds

Som standard känner DIL.getSearchReferrer igen sökningar från följande sökmotorer (inklusive internationella varianter):

Beskrivning

I följande kod visas hur du hämtar sökreferenten för någon av de sökmotorer som stöds. I det här fallet antar vi att en användare har sökt efter termen "hem" från Google Kanada ( www.google.ca). Med den här koden kan du hämta de söktermerna och skicka dem till Audience Manager.

Grundläggande kod

Grundläggande kod för att hämta sökreferenten (till exempel från google.com) ser ut så här:

var search_referrer = DIL.tools.getSearchReferrer();

Kodexempel för listad sökmotor

I det här fallet antar vi att en användare sökte efter termen "hem" från Google Kanada ( www.google.ca). Observera hur koden prefixerar den nödvändiga c_-parametern för sökmotorn ( c_se) och söktermen ( c_st). c_ är ett obligatoriskt prefix som identifierar dessa som kunddefinierade variabler för 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();
}

Kodexempel för sökmotor som inte finns med i listan

I det här fallet antar vi att en användare sökte efter termen "hem" från dogpile.com. Eftersom Dogpile inte stöds som standard kan du konfigurera DIL så att sökmotorn identifieras och söktermerna returneras till Audience Manager. Koden kan se ut ungefär så här:

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();
}

Mappa nyckelvärden till andra nycklar map-key-values

Associera värdet från ett nyckelvärdepar till en annan nyckel.

Beskrivning

I ett nyckelvärdepar identifierar prefixet c_ som lagts till nyckeln signalen som kunddefinierade data. Kunddefinierade data används för målanpassning på den specifika webbplats som skickade data i ett händelseanrop. Ibland vill du dock att den här informationen ska vara tillgänglig för alla egenskaper på ditt Audience Manager-konto. Det gör du genom att mappa värdet i ett c_-nyckelvärdepar till en plattformsnivånyckel. En nyckel på plattformsnivå har prefixet d_ och gör signalen tillgänglig för målinriktning över alla egenskaper i ditt konto.

Du kan till exempel samla in ZIP-koddata från en viss plats men vill rikta dem till alla dina Audience Manager-egenskaper. Om du vill göra ZIP-koden tillgänglig på plattformsnivå kan du mappa den kunddefinierade ZIP-kodnyckeln (t.ex. c_zip) till en plattformsdefinierad nyckel enligt nedan.

Kodexempel

Koden kan se ut ungefär så här:

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

Traffic DIL in Google Tag Manager (GTM) traffic-dil-gtm

Konfigurera och serva DIL med en GTM-tagg.

I den här proceduren förutsätts att du har ett Google Tag Manager-konto, viss kunskap om produkten och din dil.js-fil i Audience Manager.

Så här kör du filen dil.js i GTM: