DIL-gebruiksscenario’s en codevoorbeelden dil-use-cases-and-code-samples

Codevoorbeelden en beschrijvingen voor specifieke gevallen waarin DIL wordt gebruikt.

Gegevenselementen naar Audience Manager verzenden met DIL send-data-elements-dil

Maak een objectvariabele die informatie over pagina-elementen naar de Audience Manager verzendt. Dit is nuttig voor algemene gegevensinzameling of als alternatief aan het verzamelen van gegevens met variabelen van de Analyse.

Beschrijving

De volgende code laat zien hoe u paginagegevens kunt verzamelen en naar de Audience Manager kunt verzenden met DIL. In deze voorbeelden wordt een variabele gebruikt om gegevenselementen op te nemen in een platte lijst of een array. Onthoud, variabelen doorgeven als sleutelwaardeparen. Let ook op de c_ voor de toets in het sleutelwaardepaar. Dit vereist voorvoegsel identificeert informatie als user-defined gegevens. In het eerste voorbeeld moet u handmatig toevoegen c_ op de toets. In het tweede voorbeeld: DIL doet dit automatisch voor u.

Waardeeigenschappen consistent houden

Vergeet niet de eigenschappen van de waarde gelijk te houden wanneer u gegevens doorgeeft. Als u bijvoorbeeld twee identieke toetsen met verschillende waarden hebt, heeft de waarde van het laatste sleutelwaardepaar voorrang op de voorgaande waardeobjecten. Bijvoorbeeld, doorgeven color:blue en color:red Hiermee stelt u de geretourneerde waarde in op rood (overschrijft u blauw).

Voorbeeld 1: Gegevens verzenden als sleutel-waardeparen

In dit eenvoudige voorbeeld worden kleur- en prijsgegevens naar de Audience Manager verzonden in de vorm van sleutelwaardeparen. De code kan er ongeveer als volgt uitzien:

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

Voorbeeld 2: Gegevens verzenden in een object

In dit geavanceerde voorbeeld wordt getoond hoe gegevens in een object naar Audience Manager worden verzonden. Wanneer u met deze methode werkt, DIL Hiermee kunt u een object als functieparameter doorgeven aan signals() methode. DIL De code kan er ongeveer als volgt uitzien:

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

Voorbeeld 3: Paginagegevens verzenden in een array

In dit geval wordt de variabele my_object gebruikt een array om gegevens op te slaan. Dit voorbeeld bouwt op de informatie voort die door de geadviseerde methode hierboven wordt overgegaan, maar voegt een extra laag toe om een producttype en een model aan te passen. De code kan er ongeveer als volgt uitzien:

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

URL van vastlegverwijzing capture-referring-url

Leg een referentie-URL vast en verzend deze naar de Audience Manager.

Codevoorbeeld

De code kan er ongeveer als volgt uitzien:

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

Typen zoekmachines vastleggen en zoektermen vastleggen capture-search-engine-types

Gegevens over zoekmachinetypen en trefwoordzoekopdrachten naar Audience Manager verzenden.

Ondersteunde zoekmachines

Standaard, DIL.getSearchReferrer erkent zoekopdrachten van deze zoekmachines ( inclusief internationale variaties ) :

Beschrijving

In de volgende code ziet u hoe u de zoekreferentie ophaalt voor een van de ondersteunde zoekprogramma's. In dit geval, veronderstellen wij een gebruiker die op de term "huizen"van wordt gezocht Google Canada ( www.google.ca). Met deze code kunt u deze zoektermen vastleggen en naar de Audience Manager verzenden.

Basiscode

Basiscode voor het ophalen van de zoekreferentie (van google.comBijvoorbeeld) ziet er als volgt uit:

var search_referrer = DIL.tools.getSearchReferrer();

Voorbeeld code van vermelde zoekmachine

In dit geval, veronderstellen wij dat een gebruiker naar de term "huizen"van zocht Google Canada ( www.google.ca). Let op hoe de code de vereiste voorvoegsels bevat c_ parameter voor zoekmachine ( c_se) en zoekterm ( c_st). c_ is een vereist voorvoegsel die deze als klant-bepaalde variabelen aan Audience Manager identificeert.

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

Voorbeeld van code van niet-vermelde zoekmachine

In dit geval, veronderstellen wij dat een gebruiker naar de term "huizen"van zocht dogpile.com. Omdat Dogpile wordt niet door gebrek gesteund, kunt u DIL vormen om dit onderzoeksmotor te erkennen en de onderzoekstermijnen aan Audience Manager terug te keren. De code kan er ongeveer als volgt uitzien:

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

Sleutelwaarden toewijzen aan andere toetsen map-key-values

Koppel de waarde van een sleutelwaardepaar aan een andere sleutel.

Beschrijving

In een sleutelwaardepaar, c_ Het voorvoegsel dat aan de sleutel is toegevoegd, identificeert het signaal als door de klant gedefinieerde gegevens. Door de klant gedefinieerde gegevens worden gebruikt om zich te richten op de specifieke site die gegevens heeft doorgegeven bij een gebeurtenisaanroep. Soms wilt u deze informatie echter wel beschikbaar stellen voor alle eigenschappen in uw Audience Manager-account. Wijs de waarde in een c_ sleutel-waarde paar aan een sleutel van het platformniveau. Een toets op platformniveau is vooraf ingesteld op d_ en stelt het signaal beschikbaar voor het richten over alle eigenschappen in uw rekening.

Als voorbeeld verzamelt u ZIP-codegegevens van een bepaalde site, maar wilt u deze als doel instellen voor al uw Audience Manager-eigenschappen. Als u de ZIP-code beschikbaar wilt maken op platformniveau, kunt u de door de klant gedefinieerde ZIP-codesleutel toewijzen (bijvoorbeeld c_zip) naar een door het platform gedefinieerde sleutel, zoals hieronder wordt weergegeven.

Codevoorbeeld

De code kan er ongeveer als volgt uitzien:

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

Stel DIL in en bedien deze met een GTM-tag.

Deze procedure veronderstelt u hebt Google Tag Manager -account, enige praktische kennis van dat product en uw Audience Manager dil.js bestand.

Om het dil.js bestand in GTM: