DIL Use cases and Code Samples dil-use-cases-and-code-samples
Codevoorbeelden en beschrijvingen voor specifieke DIL-gebruiksgevallen.
Gegevenselementen naar Audience Manager verzenden met DIL send-data-elements-dil
Maak een objectvariabele die informatie over pagina-elementen naar Audience Manager verzendt. Dit is nuttig voor algemene gegevensinzameling of als alternatief aan het verzamelen van gegevens met variabelen van de Analyse.
Beschrijving
In de volgende code ziet u hoe u paginagegevens kunt verzamelen en naar 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. Herinner me, ga in variabelen als zeer belangrijk-waardeparenover. Noteer ook het voorvoegsel c_
vóór de toets in het sleutelwaardepaar. Dit vereiste prefixidentificeert informatie als user-defined gegevens. In het eerste voorbeeld moet u c_
handmatig aan de sleutel toevoegen. In het tweede voorbeeld doet DIL dit automatisch voor u.
houd de Eigenschappen van de Waarde verenigbaar
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. Als u bijvoorbeeld color:blue
en color:red
opgeeft, wordt de geretourneerde waarde ingesteld op rood (overschrijft blauw).
Voorbeeld 1: Verzend Gegevens als sleutel-Waarde paren
In dit eenvoudige voorbeeld worden kleur- en prijsgegevens naar 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: Verzend Gegevens in een Voorwerp
In dit geavanceerde voorbeeld wordt getoond hoe gegevens in een object naar Audience Manager worden verzonden. Wanneer u met deze methode werkt, kunt u met DIL een object als functieparameter doorgeven aan de methode signals() . DIL De code kan er 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: Verzend de Gegevens van de Pagina in een Serie
In dit geval gebruikt de variabele my_object
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 Audience Manager.
Steekproef van de Code
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
Stuur informatie over zoekmachinetypen en trefwoordzoekopdrachten naar Audience Manager.
Ondersteunde Motoren van het Onderzoek
Standaard herkent DIL.getSearchReferrer
zoekopdrachten vanuit deze zoekmachines (inclusief internationale variaties):
- AOL
- Ask
- Bing
- Yahoo!
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 Google Canada ( www.google.ca
) wordt gezocht. Met deze code kunt u deze zoektermen vastleggen en naar Audience Manager verzenden.
Basiscode
De basiscode voor het ophalen van de zoekreferentie (bijvoorbeeld uit google.com
) ziet er als volgt uit:
var search_referrer = DIL.tools.getSearchReferrer();
Lijst van de Code van de Motor van het Onderzoek Code van de Motor
Laten we er in dit geval van uitgaan dat een gebruiker de term "huizen" heeft gezocht vanuit Google Canada ( www.google.ca
). Let op hoe de code de vereiste parameter c_
vooraf bepaalt in de zoekmachine ( c_se
) en de zoekterm ( c_st
). c_
is a vereiste prefixdie 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();
}
Niet-vermelde de Codesteekproef van de Motor van het Onderzoek
In dit geval, veronderstellen wij dat een gebruiker naar de term "huizen"van dogpile.com
zocht. Omdat Dogpile niet standaard wordt ondersteund, kunt u DIL zo configureren dat dit zoekprogramma wordt herkend en de zoektermen worden teruggestuurd naar Audience Manager. 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 identificeert het voorvoegsel c_
dat aan de sleutel is toegevoegd 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. Hiervoor wijst u de waarde in een c_
sleutelwaardepaar toe aan een platformniveausleutel. Een sleutel op platformniveau wordt vooraf ingesteld met d_
en maakt het signaal beschikbaar voor alle eigenschappen in uw account.
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 op platformniveau beschikbaar wilt maken, kunt u de door de klant gedefinieerde ZIP-codesleutel (bijvoorbeeld c_zip
) toewijzen aan een platformgedefinieerde sleutel, zoals hieronder wordt weergegeven.
Steekproef van de Code
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
Verkeer DIL in Google Tag Manager (GTM) traffic-dil-gtm
DIL instellen en bedienen met een GTM-tag.
Bij deze procedure wordt ervan uitgegaan dat u een Google Tag Manager -account, enige praktische kennis van dat product en uw Audience Manager dil.js
-bestand hebt.
U kunt als volgt het dil.js
-bestand verzenden in GTM:
-
Maak een nieuwe container of open een bestaande container.
-
Voeg een nieuwe tag toe aan de container.
-
Open de tag om deze te bewerken en:
- Geef de tag een naam.
- Selecteer Custom HTML Tag in de vervolgkeuzelijst Tag Type .
- Plaats in het HTML-veld de DIL -code (bibliotheek + de aangepaste code) binnen scripttags
<script>DIL code</script>
. - Klik op Save.
-
Publiceer de container.
-
Genereer de code van de containertag en plaats deze op uw voorraad.