DIL-Anwendungsfälle und Code-Beispiele

Codebeispiele und Beschreibungen für bestimmte DIL-Anwendungsfälle.

Senden von Datenelementen an den Audience Manager mit 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 mit DIL an den Audience Manager gesendet werden. 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 c_ -Präfix vor dem -Schlüssel im Schlüssel-Wert-Paar. Dieses erforderliche Präfix identifiziert Informationen als benutzerdefinierte Daten. Im ersten Beispiel müssen Sie c_ manuell an den Schlüssel anhängen. Im zweiten Beispiel führt DIL dies automatisch für Sie aus.

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. Wenn Sie beispielsweise color:blue und color:red übergeben, 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 signals()-Methode ü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

Erfassen und Senden einer verweisenden URL an Audience Manager.

HINWEIS

Diese Methode funktioniert nur, wenn Benutzer zwischen Seiten mit ähnlichen Protokollen (HTTP vs. HTTPS) wechseln. Beispielsweise behält der Browser eine verweisende URL bei, wenn Sie von einer sicheren Site zu einer anderen sicheren Site navigieren. Browser behalten die verweisende URL nicht bei, wenn Sie zwischen sicheren und unsicheren Sites wechseln. Dieses Verhalten ist eine normale Browserfunktionalität und kann nicht durch DIL umgangen werden.

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

Senden Sie Informationen zum Suchmaschinentyp und zu Suchbegriffsuchen an Audience Manager.

WICHTIG

In diesem Abschnitt wird die alte Funktionalität beschrieben, die in den neuesten Versionen von DIL nicht unterstützt wird.

Unterstützte Suchmaschinen

Standardmäßig erkennt DIL.getSearchReferrer Suchen aus diesen Suchmaschinen (einschließlich internationaler Varianten):

  • AOL
  • Ask
  • Bing
  • Google
  • 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_ für Suchmaschinen ( c_se) und Suchbegriffe ( 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(); 
}

Schlüsselwerte anderen Schlüsseln zuordnen

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. Zuordnen des Werts in einem c_ Schlüssel-Wert-Paar zu einem Schlüssel auf Plattformebene. Ein Schlüssel auf Plattformebene ist d_ vorangestellt 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 von der 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)

Richten Sie DIL mit einem GTM-Tag ein und bedienen Sie es.

Bei diesem Verfahren wird davon ausgegangen, dass Sie über ein Google Tag Manager-Konto, einige Kenntnisse über dieses Produkt und Ihre Audience Manager-Datei dil.js verfügen.

Um die dil.js-Datei in GTM zu übertragen:

  1. Erstellen Sie einen neuen Container oder öffnen Sie einen vorhandenen Container.

  2. Fügen Sie dem Container ein neues Tag hinzu.

  3. Ö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 HTML-Feld den DIL-Code (Bibliothek und den benutzerdefinierten Code) innerhalb der Skript-Tags <script>DIL code</script>.
    • Klicken Save.
  4. Veröffentlichen Sie den Container.

  5. Generieren Sie Container-Tag-Code und platzieren Sie ihn in Ihrem Inventar.

Auf dieser Seite