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

WARNING
Från och med juli 2023 har Adobe upphört med utvecklingen av tillägget Data Integration Library (DIL) och DIL.
Befintliga kunder kan fortsätta använda sin DIL-implementering. Adobe kommer dock inte att utveckla DIL efter den här punkten. Kunder uppmuntras att utvärdera Experience Platform Web SDK för sin långsiktiga datainsamlingsstrategi.
Kunder som vill implementera integreringar för datainsamling efter juli 2023 bör använda Experience Platform Web SDK i stället.

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.

NOTE
Den här metoden fungerar bara när användare flyttar mellan sidor med liknande protokoll (HTTP eller HTTPS). Webbläsaren behåller till exempel en refererande URL när du navigerar från en säker plats till en annan säker plats. Webbläsare behåller inte den refererande URL:en när du förflyttar dig mellan säkra och osäkra webbplatser. Detta beteende är normal webbläsarfunktionalitet och kan inte kringgås av DIL.

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.

IMPORTANT
I det här avsnittet beskrivs äldre funktioner, som inte stöds i de senaste versionerna av DIL.

Sökmotorer som stöds

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

  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!

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:

  1. Skapa en ny behållare eller öppna en befintlig behållare.

  2. Lägg till en ny tagg i behållaren.

  3. Öppna taggen för att redigera den och:

    • Ge taggen ett namn.
    • Välj Custom HTML Tag i listrutan Tag Type.
    • Placera DIL-koden (bibliotek + den anpassade koden) i skripttaggar <script>DIL code</script> i fältet HTML.
    • Klicka på Save.
  4. Publish behållaren.

  5. Generera behållartaggkod och placera den i lagret.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695