Show Menu
THEMEN×

DIL-Erstellungsmethode

DIL erstellen

Erstellt eine partner-spezifische DIL Instanz.
**** Funktionssignatur: DIL.create: function (initConfig) {}
initConfig-Elemente
Die visitorService Eigenschaft ist 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 Sie DIL auf mehreren Sites bereitgestellt haben. 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 deren Behälter-IDs zu erhalten.
Im Experience Cloud ID-Dienst entspricht die Eigenschaft idSyncContainerID der Eigenschaft 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 werden 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 .
specifiedId
Objekt
delcaredId wird verwendet, um Folgendes einzugeben:
  • dpid : Ihnen von 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 Experience Cloud ID-Dienst verwenden, stellen Sie Kunden-IDs mit der Methode setCustomerIDs anstelle von DIL ein . See Customer IDs and Authentication States .
delayAllBeforeWindowLoad
Boolesch
Wenn "true", wird die Ausführung aller Anforderungen (IFRAME, Ereignisaufrufe, ID-Synchronisierung und Ziel) so lange verschoben, bis das Seitenladeereignis ausgelöst wird. Default is false .
disableDeclaredUIDCookie
Boolesch
Standardmäßig ist "false"festgelegt, 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 mcvid-disableidsync.html im Experience Cloud ID-Dienst.
Wenn "true" , wird das Ziel für die Veröffentlichung von IFRAME nicht an das DOM- oder Feuerlöschziel angehängt. Default is 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 mcvid-disableidsync.html im Experience Cloud ID-Dienst.
Deaktiviert die ID-Synchronisierung. Sie müssen die ID-Synchronisierung deaktivieren, wenn Sie DIL v6.2+ und den Besucher-ID-Dienst verwenden. Die visitorService- Funktion (siehe Beispielcode unten) übernimmt diesen Vorgang.
enableErrorReporting
Boolesch
Auf "true"einstellen, um die Fehlermeldung für alle DIL- Instanzen auf der Seite zu aktivieren. Funktioniert nur mit Boolescher Richtigkeit.
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 Experience Cloud ID-Dienst mcvid-idSyncSSLUseAkamai.html .
Legt fest, ob die Vorlage für die Zielveröffentlichung bei HTTPS-Verbindungen mit Akamai ausgeführt werden soll. Aktivierung pro Partner.
Zuordnungen
Objekt
Verbindet den Wert zwischen einem Schlüssel-Wert-Paar und einem anderen. Siehe Schlüsselwerte anderen Schlüsseln zuordnen . 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 Administrationsbereich des Experience Cloud- Dashboards. Sie benötigen Administratorrechte, um dieses Dashboard anzuzeigen. Weitere Informationen finden Sie in den häufig gestellten Fragen zu Produktfunktionen und Administration - Benutzerverwaltung und häufig gestellte Fragen .
partner
Zeichenfolge
Erforderlich.
Name des Partners, wie von Audience Manager bereitgestellt .
removeFinishedScriptsAndCallbacks
Boolesch
Entfernt Skripten und Rückrufe. Default is False . Gilt nur für die aktuelle DIL- Instanz. Version 3.3
uuidCookie
Objekt
Legt ein Cookie mit der eindeutigen Benutzer-ID fest, die von Audience Manager zurückgegeben wird . Siehe uidCookie-Eigenschaften .
visitorService
Objekt
Erforderlich mit DIL 6.2 oder höher.
DIL nutzt die Funktion setCustomerIDs im Experience Cloud ID-Dienst, um deklarierte IDs an Audience Manager weiterzuleiten . Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungszustände.
Beispielcode
Ein Beispielaufruf DIL 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 von der uuidCookie Variablen verwendeten Eigenschaften. Diese Variable ist Teil der DIL.create Methode.
uuidCookie hat die folgenden Eigenschaften:
Name
Beschreibung
name
The cookie name ( aam_did is default).
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 Standard).
secure
Legt ein Flag fest, um nur Daten über eine HTTPS-Verbindung zu senden.

visitorService-Eigenschaften

Definiert die von der visitorService Variablen verwendeten Eigenschaften. 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 Funktionalität des Experience Cloud-Hauptdienstes erforderlich. Derselbe Parameter, mit dem die Besucher-ID-Funktion instanziiert wird.
Codebeispiel:
var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});