DIL-Erstellungsmethode dil-create
DIL erstellen dil-create-new
Erstellt eine Partner-spezifische DIL -Instanz.
Funktionssignatur: DIL.create: function (initConfig) {}
initConfig-Elemente
visitorService ist always erforderlich. Andere hier aufgelistete Eigenschaften sind optional, sofern nicht anders angegeben.initConfig akzeptiert die folgenden Elemente:
containerNSIDDiese Eigenschaft legt die Container-ID fest, die von Audience Manager für ID-Synchronisierungen verwendet wird. Sie würden containerNSID festlegen, wenn DIL auf mehreren Sites bereitgestellt wird. 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 Serviceentspricht 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 auf
containerNSIDundidSyncContainerIDfest. - Sowohl DIL als auch der ID-Dienst versuchen, ID-Synchronisationen an unseren Datenerfassungs-iFrame zu senden. Der iFrame stellt jedoch sicher, dass DIL keine ID-Synchronisierung auslöst. Dies verhindert Duplizierung.
- Nur DIL sendet Daten an ein URL-Ziel.
Siehe auch idSyncContainerID.
declaredIddeclaredId wird verwendet, um Folgendes einzugeben:
dpid: Die 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. Durch die Kodierung werden doppelt kodierte IDs erstellt.
Hinweis: Wenn Sie den Adobe Experience Platform Identity Serviceverwenden, legen Sie Kunden-IDs mit der setCustomerIDs -Methode anstelle von DIL fest. Siehe Kunden-IDs und Authentifizierungsstatus.
delayAllUntilWindowLoadPage Load -Ereignis ausgelöst wird. Der Standardwert ist false .disableDeclaredUUIDCookiedisableDestinationPublishingIframeWichtig: Dieses Element wird mit der DIL -Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im Adobe Experience Platform Identity-Dienst.
Wenn true ist, hängt den Ziel-Publishing-IFRAME nicht an das DOM an oder löst Ziele aus. Der Standardwert ist false .
disableIDSyncsWichtig: Dieses Element wird mit der DIL -Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.disableIdSyncs im 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 Funktion visitorService (siehe Beispielcode unten) übernimmt diesen Vorgang.
enableErrorReportingtrue , um die Fehlerberichterstellung für alle DIL -Instanzen auf der Seite zu aktivieren. Funktioniert nur mit Booleschem Wert true .iframeAkamaiHTTPSWichtig: Dieses Element wird mit der DIL -Version 8.0 (veröffentlicht im August 2018) nicht mehr unterstützt. Verwenden Sie stattdessen die Funktion visitor.idSyncSSLUseAkamai im Adobe Experience Platform Identity-Dienst.
Gibt an, ob die Vorlage für die Zielveröffentlichung Akamai für HTTPS-Verbindungen verwenden soll. Aktivierung pro Partner.
mappingsnamespaceErforderlich.
Das Schlüssel-Wert-Paar namespace enthält Ihre Experience Cloud Organisations-ID. Wenn Sie diese ID nicht haben, finden Sie sie im Bereich Administration des Dashboards Experience Cloud . Sie benötigen Administratorberechtigungen, um dieses Dashboard anzuzeigen. Weitere Informationen finden Sie in den FAQ zu Produktfunktionenund Administration - Benutzerverwaltung und FAQ.
partnerErforderlich.
Partnername gemäß Audience Manager .
removeFinishedScriptsAndCallbacksFalse . Gilt nur für die aktuelle Instanz DIL . Veröffentlicht mit Version 3.3.uuidCookievisitorServiceErforderlich mit DIL 6.2 oder höher.
DIL verlässt sich auf die Funktion setCustomerIDs im Adobe Experience Platform Identity Service , um deklarierte IDs an Audience Manager zu übergeben. Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungsstatus.
Beispielcode
Ein Beispiel für einen 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 (nicht ausgegeben) zurückgegeben, wenn der Code falsch konfiguriert ist oder wenn ein Fehler auftritt.
uuidCookie-Eigenschaften uuidcookie-props
Definiert die Eigenschaften, die von der Variable uuidCookie verwendet werden. Diese Variable ist Teil der DIL.create -Methode.
uuidCookie verfügt über die folgenden Eigenschaften:
nameaam_did ist Standard).dayspath'/test' ( / ist Standard).domain'adobe.com' ( '.'+document.domain ist Standard).securevisitorService-Eigenschaften visitor-service-props
Definiert die Eigenschaften, die von der Variable visitorService verwendet werden. Diese Variable ist Teil der DIL.create -Methode.
visitorService verfügt über die folgenden Eigenschaften:
namespaceCodebeispiel:
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});