DIL-Anwendungsfälle und Code-Beispiele 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 Seitendaten erfasst und an den Audience Manager gesendet werden, mit dem DIL. 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üsselwertpaare. Beachten Sie außerdem die c_ -Präfix vor dem -Schlüssel im Schlüssel-Wert-Paar. Diese erforderliches Präfix identifiziert Informationen als benutzerdefinierte Daten. Im ersten Beispiel müssen Sie manuell anhängen c_ zum Schlüssel hinzu. Im zweiten Beispiel DIL führt dies automatisch für Sie durch.

Konsistente Werteigenschaften beibehalten

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. Beispiel: Übergeben von color:blue und color:red setzt den zurückgegebenen Wert auf Rot (überschreibt Blau).

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. Wenn Sie mit dieser Methode arbeiten, DIL ermöglicht die Übergabe eines Objekts als Funktionsparameter in die signals() -Methode. 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 wird die Variable my_object verwendet ein Array zum Speichern von Daten. 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.

Code-Beispiel

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 ist DIL.getSearchReferrer erkennt 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). Mit diesem Code können Sie diese Suchbegriffe erfassen und an den Audience Manager senden.

Einfacher Code

Grundlegender Code für den Abruf der verweisenden Stelle (aus google.com(z. B.) 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"von gesucht hat Google Kanada ( www.google.ca). Beachten Sie, wie der Code die erforderlichen c_ Parameter an Suchmaschine ( c_se) und Suchbegriff ( c_st). c_ ist erforderliches Präfix , der diese als kundendefinierte Variablen für den Audience Manager identifiziert.

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 gesucht hat dogpile.com. weil Dogpile nicht standardmäßig unterstützt, 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 wird die c_ an den Schlüssel angehängtes Präfix kennzeichnet 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. Zuordnen des Werts zu diesem Zweck in einer c_ Schlüssel-Wert-Paar zu einem Schlüssel auf Plattformebene. Ein Schlüssel auf Plattformebene ist mit dem Präfix d_ und stellt das Signal für das Targeting in allen Eigenschaften in Ihrem Konto zur Verfügung.

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) zu einem für die Plattform definierten Schlüssel hinzu, wie unten dargestellt.

Code-Beispiel

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.

Diese Vorgehensweise setzt voraus, dass Sie über Google Tag Manager -Konto, einige Kenntnisse über dieses Produkt und Ihren Audience Manager dil.js -Datei.

Um den Traffic der dil.js -Datei in GTM: