DIL建立方法 dil-create
DIL 建立 dil-create-new
建立合作夥伴特定的 DIL 執行個體。
函式簽章: DIL.create: function (initConfig) {}
initConfig元素
visitorService
屬性為 一直 必填。 除非另有指示,否則此處列出的其他屬性是選用的。initConfig
接受下列元素:
containerNSID
該屬性會設定 Audience Manager 所使用的容器 ID 以供 ID 同步之用。您可以設定 containerNSID
若您擁有 DIL 跨多個網站部署。 每個網站都有各自的容器ID和ID同步。 當您只有1個網站時,容器ID預設為0,您不需要正確設定。 請聯絡您的顧問,以取得您的網站清單及其容器ID。
在 Adobe Experience Platform Identity服務,屬性 idSyncContainerID
對應至 containerNSID
在 DIL . 如果您使用 DIL 和 跨多個網站的ID服務:
- 針對每個網站,在設定相同的容器ID
containerNSID
和idSyncContainerID
. - 兩者 DIL 而且ID服務會嘗試將ID同步傳送至我們的資料收集iFrame。 不過,iFrame可確保 DIL 將不會引發ID同步。 如此可防止重複。
- 僅限 DIL 將資料傳送至 URL目的地.
另請參閱 idSyncContainerID.
declaredId
declaredId
用於傳入:
dpid
:資料合作夥伴ID由指派給您 Audience Manager .dpuuid
:您的使用者唯一ID。
重要:請僅將未編碼的值用於ID。 編碼將會建立雙重編碼的識別碼。
附註:如果您使用 Adobe Experience Platform Identity服務,使用設定客戶ID setCustomerIDs
方法而非 DIL . 另請參閱 客戶ID和驗證狀態.
delayAllUntilWindowLoad
Page Load
事件會引發。 預設為 false
.disableDeclaredUUIDCookie
disableDestinationPublishingIframe
重要:此元素已過時 DIL 8.0版(2018年8月發行)。 使用 visitor.disableIdSyncs
函式改用Adobe Experience Platform Identity Service。
如果 true
,不會將目的地發佈IFRAME附加至DOM或引發目的地。 預設為 false
.
disableIDSyncs
重要:此元素已過時 DIL 8.0版(2018年8月發行)。 使用 visitor.disableIdSyncs
函式改用Adobe Experience Platform Identity Service。
停用 ID 同步。使用DILv6.2+和訪客ID服務時,您必須停用ID同步。 此 visitorService
函式(請參閱下面的範常式式碼)會負責此作業。
enableErrorReporting
true
啟用所有錯誤報告 DIL 頁面上的例項。 與布林值搭配使用 true
僅限。iframeAkamaiHTTPS
重要:此元素已過時 DIL 8.0版(2018年8月發行)。 使用 visitor.idSyncSSLUseAkamai
函式改用Adobe Experience Platform Identity Service。
指定目標發佈範本是否應該針對 HTTPS 連線使用 Akamai。每位合作夥伴皆啟用。
namespace
必填.
此 namespace
機碼值組包含您的 Experience Cloud 組織ID。 如果您沒有此ID,可以在 管理 的區段 Experience Cloud 儀表板。 您需要管理員許可權才能檢視此儀表板。 請參閱 產品特色與功能常見問題集和 管理 — 使用者管理與常見問題.
partner
必填.
提供的合作夥伴名稱 Audience Manager .
removeFinishedScriptsAndCallbacks
False
. 套用至目前 DIL 僅限執行個體。 隨v3.3發行。visitorService
必填: DIL 6.2或更新版本。
DIL仰賴 setCustomerIDs
中的函式 Adobe Experience Platform Identity服務 將已宣告ID傳遞至 Audience Manager . 另請參閱 客戶ID和驗證狀態以取得詳細資訊。
程式碼範例
範例 DIL 呼叫可能類似於以下內容:
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
});
成功的回應會傳回 DIL 執行個體。 如果您的程式碼設定不正確或發生錯誤,失敗的嘗試會傳回錯誤物件(未擲回)。
uuidCookie屬性 uuidcookie-props
定義使用的屬性 uuidCookie
變數中。 此變數屬於 DIL.create
方法。
uuidCookie
具有以下屬性:
name
aam_did
為預設值)。days
path
'/test'
( /
為預設值)。domain
'adobe.com'
( '.'+document.domain
為預設值)。secure
visitorService屬性 visitor-service-props
定義使用的屬性 visitorService
變數中。 此變數屬於 DIL.create
方法。
visitorService
具有以下屬性:
namespace
程式碼範例:
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});