DIL-Erstellungsmethode

Erstellen einer DIL

Erstellt eine Partner-spezifische DIL-Instanz.

Funktionssignatur: DIL.create: function (initConfig) {}

initConfig-Elemente

WICHTIG

Die visitorService-Eigenschaft ist always erforderlich. Andere hier aufgelistete Eigenschaften sind optional, sofern nicht anders angegeben.

initConfig akzeptiert die folgenden Elemente:

Name Typ Beschreibung

containerNSID

Ganzzahl

Durch diese Eigenschaft wird die Container-ID festgelegt, die von Audience Manager für ID-Synchronisationen verwendet wird. Sie würden containerNSID festlegen, wenn DIL auf mehreren Sites bereitgestellt wird. Jede dieser Sites verfügt über eine eigene Container-ID und ID-Synchronisierungen. Wenn Sie nur eine Site haben, ist die Container-ID standardmäßig 0 und Sie müssen dies nicht ordnungsgemäß festlegen. Wenden Sie sich an Ihren Berater, um eine Liste Ihrer Sites und deren Container-IDs zu erhalten.

Im Adobe Experience Platform Identity-Dienst entspricht die Eigenschaft idSyncContainerID containerNSID der Eigenschaft in der DIL . Beachten Sie Folgendes, wenn Sie DIL und den ID-Dienst über mehrere Sites hinweg verwenden:

  • Legen Sie für jede Site dieselben Container-IDs für containerNSID und idSyncContainerID fest.
  • Sowohl DIL als auch der ID-Dienst versuchen, ID-Synchronisationen an unseren Datenerfassungs-iFrame zu senden. Der iFrame stellt jedoch sicher, dass DIL keine ID-Synchronisierung auslöst. Dies verhindert Duplizierung.
  • Nur DIL sendet Daten an ein URL-Ziel .

Siehe auch idSyncContainerID .

declaredId

Objekt

declaredId wird verwendet, um Folgendes zu übergeben:

  • dpid : Ihnen vom Audience Manager zugewiesene Datenpartner-ID .
  • dpuuid : Ihre eindeutige ID für einen Benutzer.

Wichtig: Verwenden Sie nur nicht kodierte Werte für Ihre IDs. Ein Codieren der führt zu doppelt codierten Identifikatoren.

Hinweis: Wenn Sie den Adobe Experience Platform Identity-Dienst verwenden, legen Sie Kunden-IDs mit der Methode setCustomerIDs anstelle von DIL fest. Siehe Kunden-IDs und Authentifizierungsstatus .

delayAllUntilWindowLoad

Boolesch

Wenn "true", wird die Ausführung aller Anforderungen (IFRAME, Ereignisaufrufe, ID-Synchronisierung und Ziel) verzögert, bis das Ereignis Page Load ausgelöst wird. Standardwert ist false .

disableDeclaredUUIDCookie

Boolesch

Standardmäßig "False", was bedeutet, dass der Audience Manager ein Cookie in der Domäne des Partners setzt (setzt ein Erstanbieter-Cookie).

disableDestinationPublishingIframe

Boolesch

Wichtig: Dieses Element ist mit DIL Version 8.0 (veröffentlicht im August 2018) veraltet. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im Adobe Experience Platform Identity-Dienst.

Wenn true , hängt den Ziel-Publishing-IFRAME nicht an das DOM oder die Auslöserziele an. Standardwert ist false .

disableIDSyncs

Boolesch

Wichtig: Dieses Element ist mit DIL Version 8.0 (veröffentlicht im August 2018) veraltet. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im Adobe Experience Platform Identity-Dienst.

Deaktiviert die ID-Synchronisierung. Sie müssen die ID-Synchronisierung bei der Verwendung von DIL v6.2+ und dem Besucher-ID-Dienst deaktivieren. Die Funktion visitorService (siehe Beispielcode unten) übernimmt diesen Vorgang.

enableErrorReporting

Boolesch

Setzen Sie dies auf true , um die Fehlerberichterstellung für alle DIL -Instanzen auf der Seite zu aktivieren. Funktioniert nur mit Boolesch true .

iframeAkamaiHTTPS

Boolesch

Wichtig: Dieses Element ist mit DIL Version 8.0 (veröffentlicht im August 2018) veraltet. Verwenden Sie stattdessen die Funktion visitor.idSyncSSLUseAkamai im Adobe Experience Platform Identity-Dienst.

Legt fest, ob die Vorlage für die Zielveröffentlichung bei HTTPS-Verbindungen mit Akamai ausgeführt werden soll. Aktivierung pro Partner.

mappings

Objekt

Verbindet den Wert zwischen einem Schlüssel-Wert-Paar und einem anderen. Siehe Zuordnen von Schlüsselwerten zu anderen Schlüsseln . Veröffentlicht mit v2.4.

namespace

Zeichenfolge

Erforderlich.

Das namespace Schlüssel-Wert-Paar enthält Ihre Experience Cloud Organisations-ID. Wenn Sie diese Kennung nicht haben, finden Sie sie im Bereich Administration des Dashboards Experience Cloud . Sie benötigen Administratorberechtigungen, um dieses Dashboard anzuzeigen. Weitere Informationen finden Sie in den FAQ zu Produktfunktionen und Administration - Benutzerverwaltung und FAQ .

partner

Zeichenfolge

Erforderlich.

Name des Partners, wie von Audience Manager angegeben.

removeFinishedScriptsAndCallbacks

Boolesch

Entfernt Skripte und Rückrufe. Standardwert ist False . Gilt nur für die aktuelle Instanz DIL . Veröffentlicht mit Version 3.3.

uuidCookie

Objekt

Legt ein Cookie mit der Unique User-ID fest, die von Audience Manager zurückgegeben wird. Siehe uuidCookie-Eigenschaften .

visitorService

Objekt

Erforderlich mit DIL 6.2 oder höher.

DIL verlässt sich auf die Funktion setCustomerIDs im Adobe Experience Platform Identity Service , um deklarierte IDs an den Audience Manager zu übergeben. Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungszustände.

Beispielcode

Ein Beispiel für einen DIL-Aufruf könnte wie folgt aussehen:

var partnerObject1 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-ORGANIZATION-ID-HERE" 
  }, 
  containerNSID: 3, 
  uuidCookie:{ 
    name:'ad_uuid', 
    days:200, 
    path:'/test', 
    domain:'adobe.com', 
    secure:true 
  } 
}); 
 
var partnerObject2 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-MCORG-ID-HERE" 
  }, 
  containerNSID: 3 
}); 

Eine erfolgreiche Antwort gibt die DIL-Instanz zurück. Bei einem fehlgeschlagenen Versuch wird ein Fehlerobjekt (nicht ausgegeben) zurückgegeben, wenn der Code falsch konfiguriert ist oder wenn ein Fehler auftritt.

uuidCookie-Eigenschaften

Definiert die Eigenschaften, die von der Variablen uuidCookie verwendet werden. Diese Variable ist Teil der DIL.create-Methode.

uuidCookie weist die folgenden Eigenschaften auf:

Name Beschreibung
name Der Cookie-Name ( aam_did ist Standard).
days Cookie-Lebensdauer (standardmäßig 100 Tage).
path Cookie-Pfad, z. B. '/test' ( / ist Standard).
domain Die Domäne, in der das Cookie gesetzt ist, z. B. 'adobe.com' ( '.'+document.domain ist Standard).
secure Legt eine Markierung fest, um nur Daten über eine HTTPS-Verbindung zu senden.

visitorService-Eigenschaften

Definiert die Eigenschaften, die von der Variablen visitorService verwendet werden. Diese Variable ist Teil der DIL.create-Methode.

visitorService weist die folgenden Eigenschaften auf:

Name Typ Beschreibung
namespace Zeichenfolge Erforderlich. Stellt die Experience Cloud-Organisations-ID dar. Dies ist für die Experience Cloud Core Service-Funktionalität erforderlich. Derselbe Parameter, der zur Instanziierung der Besucher-ID-Funktion verwendet wird.

Code-Beispiel:

var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});

Auf dieser Seite