Show Menu
主題×

DIL建立方法

DIL建立

建立特定於合作夥伴的 DIL 實例。
函式簽名: DIL.create: function (initConfig) {}
initConfig元素
visitorService 性永 遠為 必要。 此處列出的其他屬性是可選的,除非另有說明。
initConfig 接受下列元素:
名稱 類型 說明
containerNSID
整數
該屬性會設定 Audience Manager 所使用的容器 ID 以供 ID 同步之用。如果您已在多 個網站 上部署 DIL, 則可設定容器NSID。 這些網站都會有其專屬的容器ID和ID同步。 當您只有1個網站時,容器ID預設為0,您不需要正確設定。 請連絡您的顧問,以取得網站及其容器ID的清單。
Experience Cloud ID中,屬性 idSyncContainer ID與 DIL 中的 NSID容器相 對應。 如果您在多個網站上使用 DIL ID服務 ,請注意下列事項:
  • 對於每個網站,請在容器NSID和 idSyncContainerID上設 定相 同的容器ID
  • DIL 和ID 服務都會嘗試將ID同步傳送至我們的資料收集iFrame。 不過,iFrame可確保 DIL 不會觸發ID同步。 這可防止重複。
  • 只有 DIL 會傳送資料至 URL目的地
另請參閱 idSyncContainerID
declaredId
物件
delcandId 用於傳遞以下任一項:
  • dpid :Audience manager指派給您的資料合作 夥伴ID
  • dpuuid :您的使用者唯一ID。
重要: 僅對您的ID使用未編碼值。 編碼會建立雙重編碼識別碼。
注意: 如果您使用 Experience Cloud ID服務, 請使用setCustomerIDs方法來設定客戶ID, 而非 DIL 。 See Customer IDs and Authentication States .
delayAllUntilWindowLoad
布林值
如果為true,則會將所有請求(IFRAME、事件呼叫、ID同步和目的地)從執行中刪除,直到觸發 頁面載入 事件。 Default is false .
disableDeclaredUUIDCookie
布林值
False 依預設,這表示 Audience Manager會 在合作夥伴的網域中設定Cookie(設定第一方Cookie)。
disableDestinationPublishingIframe
布林值
重要: DIL 8.0版( 2018年8月 發行)已淘汰此元素。 請改 用Experience Cloud ID服務 mcvid-disableidsync.html 中的visitor.disableIdSyncs函式。
如果 真,將不會將目標發佈IFRAME附加至DOM或引發目標。 Default is false .
disableIDSyncs
布林值
重要: DIL 8.0版( 2018年8月 發行)已淘汰此元素。 請改 用Experience Cloud ID服務 mcvid-disableidsync.html 中的visitor.disableIdSyncs函式。
停用 ID 同步。使用DIL v6.2+和訪客ID服務時,您必須停用ID同步。 訪客 服務 功能(請參閱下面的范常式式碼)負責此作業。
enableErrorReporting
布林值
設為 true 可啟用頁面上所有 DIL 例項的錯誤報告。 僅適用於布爾 true。
iframeAkamaiHTTPS
布林值
重要: DIL 8.0版( 2018年8月 發行)已淘汰此元素。 請改 用Experience Cloud ID服務中的visitor.idSyncSSLUseAkamai mcvid-idSyncSSLUseAkamai.html 函式。
指定目標發佈範本是否應該針對 HTTPS 連線使用 Akamai。每位合作夥伴皆啟用。
映射
物件
將一個鍵值對的值關聯到另一個鍵值對。 請參 閱將索引鍵值映射至其他索引鍵 。 隨2.4版發行。
namespace
字串
必填.
命名 空間 金鑰值配對包含您的 Experience cloud組織 ID。 如果您沒有此ID,可在Experience cloud控制面板的「管 理」 區段中找 到該 ID。 您需要管理員權限才能檢視此控制面板。 請參閱產 品功能常見問答集 與管 理——使用者管理與常見問答集
合作夥伴
字串
必填.
Audience manager提供的合 作夥伴名 稱。
removeFinishedScriptsAndCallbacks
布林值
刪除指令碼和回呼。 Default is False . 僅適用於目前 的DIL 例項。 隨v3.3發行。
uuidCookie
物件
使用從 Audience Manager傳回的唯一使用者ID來設定Cookie 。 請參閱 uuidCookie屬 性。
visitorService
物件
DIL 6.2或 更新版本必需。
DIL依賴 Experience Cloud ID服務中的setCustomerIDs功能, 將宣告的ID傳遞至 Audience Manager 。 See Customer IDs and Authentication States for more information.
程式碼範例
範例呼 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 屬性。 此變數是方法的一 DIL.create 部分。
uuidCookie 具有以下屬性:
名稱
說明
name
The cookie name ( aam_did is default).
days
Cookie存留期(預設為100天)。
path
Cookie路徑,例如 '/test' ( / 預設)。
domain
Cookie設定所在的網域,例如 'adobe.com' ( '.'+document.domain 預設)。
secure
設定標幟,僅透過HTTPS連線傳送資料。

visitorService屬性

定義變數使用的 visitorService 屬性。 此變數是方法的一 DIL.create 部分。
visitorService 具有以下屬性:
名稱
類型
說明
namespace
字串
必填。代表Experience cloud組織ID。 Experience cloud核心服務功能需要此項功能。 用於執行個體化訪客ID功能的參數相同。
程式碼範例:
var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});