Show Menu
THEMEN×

DIL-Erstellungsmethode

Erstellen einer DIL

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 Platformen 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 .
Siehe auch idSyncContainerID .
declaredId
Objekt
delcaredId 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 Identitätsdienst für Adobe Experience Platformen 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, 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 visitor.disableIdSyncs Funktion im Identitätsdienst der 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 im Identitätsdienst der 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 im Identitätsdienst der 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 vom 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 im Identitätsdienst für Adobe Experience Platformen , 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 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" 
    } 
});