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):

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: