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