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 setCustomerIDs -Methode anstelle von 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now