DIL create method

Erstellen einer DIL

Erstellt eine partner-spezifische DIL-Instanz.

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

initConfig-Elemente

WICHTIG

Die visitorService-Eigenschaft ist immer immer 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 ist. Jede dieser Sites verfügt über eine eigene Container-ID und ID-Synchronisierung. Wenn Sie nur eine Site haben, ist die Container-ID standardmäßig 0, und Sie müssen dies nicht korrekt festlegen. Wenden Sie sich an Ihren Berater, um eine Liste Ihrer Sites und ihrer Container-IDs zu erhalten.

Im Adobe Experience Platform Identity Service entspricht die Eigenschaft idSyncContainerID containerNSID in 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-Synchronisierungen an unseren Datenerfassungs-iFrame zu senden. Der iFrame stellt jedoch sicher, dass DIL keine ID-Synchronisierung auslöst. Dadurch wird Doppelarbeit vermieden.
  • Nur DIL sendet Daten an ein -URL-Ziel .

Siehe auch idSyncContainerID .

declaredId

Objekt

declaredId wird verwendet, um

  • 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-Identitätsdienst verwenden, stellen Sie Kunden-IDs mit der -Methode anstelle von setCustomerIDs DIL ein. Siehe Kunden-IDs und Authentifizierungsstatus .

delayAllUntilWindowLoad

Boolesch

Wenn "true", wird die Ausführung aller Anforderungen (IFRAME, Ereignis-Aufrufe, ID-Synchronisierung und Ziel) bis zum Auslösen des Page Load -Ereignisses verzögert. Standardwert ist false .

disableDeclaredUUIDCookie

Boolesch

False (Standardeinstellung), d. h. Audience Manager setzt ein Cookie in der Domäne des Partners (setzt ein Erstanbieter-Cookie).

disableDestinationPublishingIframe

Boolesch

Wichtig: Dieses Element wurde mit DIL Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im Adobe Experience Platform-Identitätsdienst.

Wenn true , wird das Ziel der Veröffentlichung IFRAME nicht an die DOM- oder Feuer-Ziele angehängt. Standardwert ist false .

disableIDSyncs

Boolesch

Wichtig: Dieses Element wurde mit DIL Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im Adobe Experience Platform-Identitätsdienst.

Deaktiviert die ID-Synchronisierung. Sie müssen die ID-Synchronisierung deaktivieren, wenn Sie DIL v6.2+ und den Besucher-ID-Dienst verwenden. Die Funktion visitorService (siehe Beispielcode unten) übernimmt diesen Vorgang.

enableErrorReporting

Boolesch

Auf true setzen, um den Berichte für Fehler für alle -DIL -Instanzen auf der Seite zu aktivieren. Funktioniert nur mit Boolean true .

iframeAkamaiHTTPS

Boolesch

Wichtig: Dieses Element wurde mit DIL Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.idSyncSSLUseAkamai im Adobe Experience Platform-Identitätsdienst.

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 . Herausgegeben mit v2.4.

namespace

Zeichenfolge

Erforderlich.

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

partner

Zeichenfolge

Erforderlich.

Name des Partners, wie von Audience Manager angegeben.

removeFinishedScriptsAndCallbacks

Boolesch

Entfernt Skripten und Rückrufe. Standardwert ist False . Gilt nur für die aktuelle -DIL -Instanz. Herausgegeben mit Version 3.3.

uuidCookie

Objekt

Legt ein Cookie mit der eindeutigen Benutzer-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-Identitätsdienst , um deklarierte IDs an -Audience Manager weiterzugeben. Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungszustände.

Beispielcode

Ein Beispiel 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 zurückgegeben (nicht ausgegeben), wenn Ihr 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 hat die folgenden Eigenschaften:

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 wird, z. B. 'adobe.com' ( '.'+document.domain ist Standard).
secure Legt ein Flag 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 hat die folgenden Eigenschaften:

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, mit dem die Besucher-ID-Funktion instanziiert wird.

Code-Beispiel:

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

Auf dieser Seite