DIL-Anwendungsfälle und Codebeispiele dil-use-cases-and-code-samples
Codebeispiele und Beschreibungen für bestimmte DIL-Anwendungsfälle.
Senden von Datenelementen an den Audience Manager mit DIL send-data-elements-dil
Erstellen Sie eine Objektvariable, die Informationen zu Seitenelementen an Audience Manager sendet. Dies ist für die allgemeine Datenerfassung oder als Alternative zum Sammeln von Daten mit Analytics-Variablen nützlich.
Beschreibung
Der folgende Code zeigt, wie Sie Seitendaten erfassen und mit DIL an den Audience Manager senden können. In diesen Beispielen wird eine Variable verwendet, um Datenelemente in einer flachen Liste oder in einem Array zu speichern. Denken Sie daran, Variablen als Schlüssel-Wert-Paare zu übergeben. Beachten Sie außerdem das Präfix c_
vor dem Schlüssel im Schlüssel-Wert-Paar. Dieses erforderliche Präfix kennzeichnet Informationen als benutzerdefinierte Daten. Im ersten Beispiel müssen Sie dem Schlüssel manuell c_
anhängen. Im zweiten Beispiel führt DIL dies automatisch für Sie aus.
Die Werteigenschaften konsistent halten
Beachten Sie, dass die Werteigenschaften beim Übergeben von Daten gleich bleiben. Wenn Sie beispielsweise zwei identische Schlüssel mit unterschiedlichen Werten haben, hat der Wert des letzten Schlüssel-Wert-Paares Vorrang vor den vorhergehenden Wertobjekten. Wenn beispielsweise color:blue
und color:red
übergeben werden, wird der zurückgegebene Wert auf Rot gesetzt (blauer Wert wird überschrieben).
Beispiel 1: Senden von Daten als Schlüssel-Wert-Paare
Dieses grundlegende Beispiel sendet Farb- und Preisdaten in Form von Schlüssel-Wert-Paaren an Audience Manager. Ihr Code könnte in etwa wie folgt aussehen:
var sample_dil = DIL.create({partner:"partner name"});
sample_dil.api.signals({
c_color:"blue",
c_price:"900"
});
sample_dil.api.submit();
Beispiel 2: Senden von Daten in einem Objekt
In diesem erweiterten Beispiel wird gezeigt, wie Daten in einem Objekt an Audience Manager gesendet werden. Bei der Arbeit mit dieser Methode können Sie mit DIL ein Objekt als Funktionsparameter an die Methode signals() übergeben. DIL Ihr Code könnte in etwa wie folgt aussehen:
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();
Beispiel 3: Senden von Seitendaten in einem Array
In diesem Fall verwendet die Variable my_object
ein Array, in dem Daten gespeichert werden. Dieses Beispiel baut auf den Informationen auf, die von der oben empfohlenen Methode übergeben wurden, fügt jedoch eine zusätzliche Ebene hinzu, um einen Produkttyp und ein Modell aufzunehmen. Ihr Code könnte in etwa wie folgt aussehen:
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();
Verweisende URL erfassen capture-referring-url
Erfassen und Senden einer verweisenden URL an Audience Manager.
Codebeispiel
Ihr Code könnte in etwa wie folgt aussehen:
var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ d_referer : document.referrer }).submit();
Suchmaschinentypen und Suchbegriffe erfassen capture-search-engine-types
Senden Sie Informationen zum Suchmaschinentyp und zu Suchbegriffsuchen an Audience Manager.
Unterstützte Suchmaschinen
Standardmäßig erkennt DIL.getSearchReferrer
Suchvorgänge aus diesen Suchmaschinen (einschließlich internationaler Varianten):
- AOL
- Ask
- Bing
- Yahoo!
Beschreibung
Der folgende Code zeigt, wie Sie den Suchreferrer für eine der unterstützten Suchmaschinen erhalten. In diesem Fall nehmen wir an, dass ein Benutzer nach dem Begriff "Wohnungen"aus Google Kanada ( www.google.ca
) gesucht hat. Mit diesem Code können Sie diese Suchbegriffe erfassen und an den Audience Manager senden.
Einfacher Code
Der grundlegende Code zum Abrufen des Suchverweises (z. B. von google.com
) sieht wie folgt aus:
var search_referrer = DIL.tools.getSearchReferrer();
Beispiel für aufgelisteten Suchmaschinen-Code
In diesem Fall nehmen wir an, dass ein Benutzer nach dem Begriff "Wohnungen"aus Google Kanada ( www.google.ca
) gesucht hat. Beachten Sie, wie der Code den erforderlichen Parameter c_
der Suchmaschine ( c_se
) und dem Suchbegriff ( c_st
) vorangestellt. c_
ist ein erforderliches Präfix, das diese als kundendefinierte Variablen für Audience Manager angibt.
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();
}
Beispiel für nicht aufgelisteten Suchmaschinen-Code
In diesem Fall nehmen wir an, dass ein Benutzer nach dem Begriff "Wohnungen"von dogpile.com
gesucht hat. Da Dogpile nicht standardmäßig unterstützt wird, können Sie DIL so konfigurieren, dass diese Suchmaschine erkannt wird und die Suchbegriffe an Audience Manager zurückgegeben werden. Ihr Code könnte in etwa wie folgt aussehen:
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();
}
Zuordnen von Schlüsselwerten zu anderen Schlüsseln map-key-values
Verknüpfen Sie den Wert aus einem Schlüssel-Wert-Paar mit einem anderen Schlüssel.
Beschreibung
In einem Schlüssel-Wert-Paar identifiziert das an den Schlüssel angehängte c_
-Präfix das Signal als kundendefinierte Daten. Kundendefinierte Daten werden für das Targeting auf der spezifischen Site verwendet, die Daten bei einem Ereignisaufruf übergeben hat. Manchmal möchten Sie diese Informationen jedoch für alle Eigenschaften in Ihrem Audience Manager-Konto verfügbar machen. Weisen Sie dazu den Wert in einem Schlüssel-Wert-Paar c_
einem Schlüssel auf Plattformebene zu. Bei einem Schlüssel auf Plattformebene wird d_
vorangestellt und das Signal für das Targeting über alle Eigenschaften in Ihrem Konto hinweg verfügbar gemacht.
Beispiel: Sie erfassen Postleitzahlendaten von einer bestimmten Site, möchten sie jedoch auf alle Eigenschaften Ihres Audience Managers ausrichten. Um die Postleitzahl auf Plattformebene verfügbar zu machen, können Sie Ihren kundendefinierten ZIP-Code-Schlüssel (z. B. c_zip
) einem plattformdefinierten Schlüssel zuordnen, wie unten dargestellt.
Codebeispiel
Ihr Code könnte in etwa wie folgt aussehen:
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
Richten Sie DIL mit einem GTM-Tag ein und bedienen Sie es.
Dabei wird davon ausgegangen, dass Sie über ein Google Tag Manager -Konto, einige Kenntnisse über dieses Produkt und Ihre Audience Manager dil.js
-Datei verfügen.
Traffic der dil.js
-Datei in GTM:
-
Erstellen Sie einen neuen Container oder öffnen Sie einen vorhandenen Container.
-
Fügen Sie dem Container ein neues Tag hinzu.
-
Öffnen Sie das Tag, um es zu bearbeiten, und:
- Benennen Sie das Tag.
- Wählen Sie Custom HTML Tag aus der Dropdownliste Tag Type aus.
- Platzieren Sie im Feld HTML den Code DIL (Bibliothek und den benutzerdefinierten Code) innerhalb der Skript-Tags
<script>DIL code</script>
. - Klicken Sie auf Save.
-
Publish den Container.
-
Generieren Sie Container-Tag-Code und platzieren Sie ihn in Ihrem Inventar.