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

WARNING
Ab Juli 2023 hat Adobe die Entwicklung der Erweiterung Data Integration Library (DIL) und der Erweiterung DIL eingestellt.
Bestehende Kunden können weiterhin ihre DIL -Implementierung verwenden. Adobe wird jedoch nicht mehr DIL als bisher entwickeln. Kunden wird empfohlen, das Experience Platform Web SDK für ihre langfristige Datenerfassungsstrategie zu bewerten.
Kunden, die nach Juli 2023 neue Datenerfassungs-Integrationen implementieren möchten, sollten stattdessen das Experience Platform Web SDK verwenden.

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.

NOTE
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.

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.

IMPORTANT
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 Suchvorgänge 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_ 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:

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

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695