DIL-Erstellungsmethode dil-create
Erstellen einer DIL dil-create-new
Erstellt eine partner-spezifische DIL -Instanz.
Funktionssignatur: DIL.create: function (initConfig) {}
initConfig-Elemente
visitorService
Eigenschaft ist always erforderlich. Andere hier aufgelistete Eigenschaften sind optional, sofern nicht anders angegeben.initConfig
akzeptiert die folgenden Elemente:
containerNSID
Durch diese Eigenschaft wird die Container-ID festgelegt, die von Audience Manager für ID-Synchronisationen verwendet wird. Sie würden containerNSID
wenn Sie DIL über mehrere Sites hinweg bereitgestellt werden. Jede dieser Sites verfügt über eine eigene Container-ID und ID-Synchronisierungen. Wenn Sie nur eine Site haben, ist die Container-ID standardmäßig 0 und Sie müssen dies nicht ordnungsgemäß festlegen. Wenden Sie sich an Ihren Berater, um eine Liste Ihrer Sites und deren Container-IDs zu erhalten.
Im Adobe Experience Platform Identity-Dienst, die Eigenschaft idSyncContainerID
entspricht containerNSID
in DIL . Beachten Sie Folgendes, wenn Sie DIL und den ID-Dienst über mehrere Sites hinweg:
- Setzen Sie für jede Site dieselben Container-IDs auf
containerNSID
undidSyncContainerID
. - Beide DIL und der ID-Dienst versucht, ID-Synchronisationen an unseren Datenerfassungs-iFrame zu senden. Der iFrame stellt jedoch sicher, dass DIL löst keine ID-Synchronisierung aus. Dies verhindert Duplizierung.
- Nur DIL sendet Daten an eine URL-Ziel.
Siehe auch idSyncContainerID.
declaredId
declaredId
wird verwendet, um Folgendes zu übergeben:
dpid
: Von der Ihnen zugewiesene Datenpartner-ID Audience Manager .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 die Adobe Experience Platform Identity-Dienst, legen Sie Kunden-IDs mit der setCustomerIDs
-Methode anstelle von DIL . Siehe Kunden-IDs und Authentifizierungsstatus.
delayAllUntilWindowLoad
Page Load
-Ereignis ausgelöst. Standardwert ist false
.disableDeclaredUUIDCookie
disableDestinationPublishingIframe
Wichtig: Dieses Element ist veraltet mit DIL Version 8.0 (veröffentlicht im August 2018). Verwenden Sie die visitor.disableIdSyncs
functionim Adobe Experience Platform Identity-Dienst.
Wenn true
, hängt den Ziel-Publishing-IFRAME nicht an das DOM an oder löst Ziele aus. Standardwert ist false
.
disableIDSyncs
Wichtig: Dieses Element ist veraltet mit DIL Version 8.0 (veröffentlicht im August 2018). Verwenden Sie die visitor.disableIdSyncs
functionim Adobe Experience Platform Identity-Dienst.
Deaktiviert die ID-Synchronisierung. Sie müssen die ID-Synchronisierung bei der Verwendung von DIL v6.2+ und dem Besucher-ID-Dienst deaktivieren. Die visitorService
-Funktion (siehe Beispielcode unten) übernimmt diesen Vorgang.
enableErrorReporting
true
zur Aktivierung der Fehlerberichterstellung für alle DIL Instanzen auf der Seite. Funktioniert mit Boolesch true
nur.iframeAkamaiHTTPS
Wichtig: Dieses Element ist veraltet mit DIL Version 8.0 (veröffentlicht im August 2018). Verwenden Sie die visitor.idSyncSSLUseAkamai
functionim Adobe Experience Platform Identity-Dienst.
Legt fest, ob die Vorlage für die Zielveröffentlichung bei HTTPS-Verbindungen mit Akamai ausgeführt werden soll. Aktivierung pro Partner.
mappings
namespace
Erforderlich.
Die namespace
Schlüssel-Wert-Paar enthält Ihr Experience Cloud Organisations-ID. Wenn Sie diese ID nicht haben, finden Sie sie im Administration Abschnitt Experience Cloud Dashboard. Sie benötigen Administratorberechtigungen, um dieses Dashboard anzuzeigen. Siehe Häufig gestellte Fragen zu Produktfunktionenund Administration - Benutzerverwaltung und häufig gestellte Fragen.
partner
Erforderlich.
Name des Partners gemäß Audience Manager .
removeFinishedScriptsAndCallbacks
False
. Gilt für die aktuelle DIL nur -Instanz. Veröffentlicht mit Version 3.3.uuidCookie
visitorService
Erforderlich für DIL 6.2 oder höher.
DIL verlässt sich auf die setCustomerIDs
-Funktion in Adobe Experience Platform Identity-Dienst , um deklarierte IDs an zu übergeben. Audience Manager . Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungszustände.
Beispielcode
Beispiel DIL -Aufruf könnte in etwa 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. Bei einem fehlgeschlagenen Versuch wird ein Fehlerobjekt (nicht ausgegeben) zurückgegeben, wenn der Code falsch konfiguriert ist oder wenn ein Fehler auftritt.
uuidCookie-Eigenschaften uuidcookie-props
Definiert die Eigenschaften, die vom uuidCookie
-Variable. Diese Variable ist Teil der DIL.create
-Methode.
uuidCookie
weist die folgenden Eigenschaften auf:
name
aam_did
ist Standard).days
path
'/test'
( /
ist Standard).domain
'adobe.com'
( '.'+document.domain
ist Standard).secure
visitorService-Eigenschaften visitor-service-props
Definiert die Eigenschaften, die vom visitorService
-Variable. Diese Variable ist Teil der DIL.create
-Methode.
visitorService
weist die folgenden Eigenschaften auf:
namespace
Code-Beispiel:
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});