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 festlegen, containerNSID wenn DIL auf mehreren Sites bereitgestellt wird. 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 Identitätsdienst für Adobe Experience Platform entspricht die Eigenschaft idSyncContainerID in containerNSID DIL . Beachten Sie Folgendes, wenn Sie DIL und den ID-Dienst über mehrere Sites hinweg verwenden:
  • Stellen Sie für jede Site dieselben Container-IDs ein containerNSID und idSyncContainerID .
  • 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 .
declaredId
Objekt
delcaredId wird verwendet, um
  • 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 Identitätsdienst für Adobe Experience Platform verwenden, stellen Sie Kunden-IDs mit der setCustomerIDs Methode anstelle von DIL ein . See Customer IDs and Authentication States .
delayAllUntilWindowLoad
Boolesch
Wenn "true", werden alle Anforderungen (IFRAME, Ereignis-Aufrufe, ID-Synchronisierung und Ziel) erst ausgeführt, wenn das Page Load Ereignis ausgelöst wird. Standardwert ist false .
disableDeclaredUUIDCookie
Boolesch
Standardmäßig ist "false"festgelegt. Das bedeutet, dass Audience Manager ein Cookie in der Domäne des Partners setzt (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 visitor.disableIdSyncs Funktion mcvid-disableidsync.html im Identitätsdienst für Adobe Experience Platform.
Wenn true dies der Fall ist, wird das Ziel für die Veröffentlichung von IFRAME nicht an das DOM- oder Feuerlöschziel 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 visitor.disableIdSyncs Funktion mcvid-disableidsync.html im Identitätsdienst für Adobe Experience Platform.
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) kümmert sich um diesen Vorgang.
enableErrorReporting
Boolesch
Auf true die Aktivierung des Berichte für Fehler für alle DIL- Instanzen auf der Seite einstellen. Funktioniert true nur mit Booleschem Wert.
iframeAkamaiHTTPS
Boolesch
Wichtig: Dieses Element wurde mit DIL Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die visitor.idSyncSSLUseAkamai Funktion mcvid-idSyncSSLUseAkamai.html im Identitätsdienst für Adobe Experience Platform.
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 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 Ansicht. 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 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 uidCookie-Eigenschaften .
visitorService
Objekt
Erforderlich mit DIL 6.2 oder höher.
DIL nutzt die setCustomerIDs Funktion des Adobe Experience Platform Identity Service , um deklarierte IDs an den 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" 
    } 
});