DIL-Anwendungsfälle und Code-Beispiele dil-use-cases-and-code-samples

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

Senden von Datenelementen an Audience Manager mit DIL send-data-elements-dil

Erstellen Sie eine Objektvariable, die Informationen zu Seitenelementen an den Audience Manager sendet. Dies ist für die allgemeine Datenerfassung oder als Alternative zur Datenerfassung mit Analytics-Variablen nützlich.

Beschreibung

Der folgende Code veranschaulicht, 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 einem Array zu speichern. Denken Sie daran, Variablen als „SchlüsselWert-Paare“. Beachten Sie außerdem das c_ Präfix vor dem Schlüssel im Schlüssel-Wert-Paar. Dieses erforderliche Präfix kennzeichnet Informationen als benutzerdefinierte Daten. Im ersten Beispiel müssen Sie c_ manuell an den Schlüssel anhängen. Im zweiten Beispiel erledigt DIL dies automatisch für Sie.

Werteigenschaften konsistent halten

Denken Sie daran, die Werteigenschaften beim Übergeben von Daten unverändert zu lassen. Wenn Sie beispielsweise zwei identische Schlüssel mit unterschiedlichen Werten haben, hat der Wert des letzten Schlüssel-Wert-Paares Vorrang vor den vorangehenden Wert-Objekten. Wenn Sie beispielsweise color:blue und color:red übergeben, wird der zurückgegebene Wert auf rot gesetzt (Blau wird überschrieben).

Beispiel 1: Senden von Daten als Schlüssel-Wert-Paare

Dieses Grundbeispiel sendet Farb- und Preisdaten in Form von Schlüssel-Wert-Paaren an den 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

Dieses erweiterte Beispiel zeigt, wie Daten in einem -Objekt an den -Audience Manager gesendet werden. Bei der Arbeit mit dieser Methode können Sie DIL ein -Objekt als Funktionsparameter in 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 zum Speichern von Daten. Dieses Beispiel baut auf den Informationen auf, die von der oben empfohlenen Methode übergeben werden, 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 Sie eine verweisende URL und senden Sie sie an den 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();

Erfassen von Suchmaschinentypen und Keyword-Suchbegriffen capture-search-engine-types

Senden Sie Informationen über den Suchmaschinentyp und die Keyword-Suche an den Audience Manager.

Unterstützte Suchmaschinen

Standardmäßig erkennt DIL.getSearchReferrer die Suche über diese Suchmaschinen (einschließlich internationaler Varianten):

Beschreibung

Der folgende Code zeigt, wie Sie den Such-Referrer für eine der unterstützten Suchmaschinen erhalten. Nehmen wir in diesem Fall an, ein Benutzer sucht nach dem Begriff „Wohnungen“ aus Google Canada ( www.google.ca). Dieser Code hilft Ihnen, diese Suchbegriffe zu erfassen und an den Audience Manager zu senden.

Basis-Code

Der Basis-Code zum Abrufen des Such-Referrers (z. B. aus google.com) sieht wie folgt aus:

var search_referrer = DIL.tools.getSearchReferrer();

Listed Search Engine Code Sample

Nehmen wir in diesem Fall an, dass ein Benutzer nach dem Begriff „Wohnungen“ aus Google Canada (www.google.ca) gesucht hat. Beachten Sie, dass der Code den erforderlichen c_-Parameter Suchmaschine ( c_se) und Suchbegriff ( c_st) voranstellt. c_ ist ein erforderliches Präfix das 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();
}

Code-Beispiel für nicht aufgeführte Suchmaschinen

Nehmen wir in diesem Fall an, dass ein Benutzer in dogpile.com nach dem Begriff „Heime“ gesucht hat. Da Dogpile standardmäßig nicht unterstützt wird, können Sie DIL so konfigurieren, dass diese Suchmaschine erkannt wird und die Suchbegriffe an den 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 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 die Zielgruppenbestimmung auf der spezifischen Site verwendet, die Daten bei einem Ereignisaufruf übergeben hat. Manchmal möchten Sie jedoch, dass diese Informationen für alle Eigenschaften in Ihrem Audience Manager-Konto verfügbar sind. Ordnen Sie dazu den Wert in einem Schlüssel-Wert-Paar auf c_ einem Schlüssel auf Plattformebene zu. Ein Schlüssel auf Plattformebene hat das Präfix d_ und stellt das Signal für das Targeting für alle Eigenschaften in Ihrem Konto zur Verfügung.

Beispielsweise erfassen Sie Postleitzahldaten von einer bestimmten Website, möchten sie jedoch auf alle Audience Manager-Eigenschaften ausrichten. Um die Postleitzahl auf Plattformebene verfügbar zu machen, können Sie Ihren kundendefinierten Postleitzahlschlüssel (z. B. c_zip) einem von Platform definierten 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

Einrichten und Bereitstellen von DIL mit einem GTM-Tag.

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

Traffic der dil.js in GTM: