DIL建立方法

DIL 建立

建立特定於合作夥伴的DIL實例。

函式簽名: DIL.create: function (initConfig) {}

initConfig元素

重要

visitorService屬性為​always​必要。 此處列出的其他屬性為選用屬性,除非另有說明。

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指派給您的資料合作夥伴 ID
  • dpuuid :您的使用者唯一ID。

重要: 請僅對ID使用未編碼的值。 編碼將建立雙重編碼的識別碼。

注意: 若您使用 Adobe Experience Platform Identity Service ,請使用 setCustomerIDs 方法設定客戶ID,而非使用DIL。 請參閱客戶ID和驗證狀態

delayAllUntilWindowLoad

布林值

若為true,則會在 Page Load 事件引發之前,將所有請求(IFRAME、事件呼叫、ID同步和目的地)從執行中刪除。 預設為 false .

disableDeclaredUUIDCookie

布林值

False 依預設,這表示Audience Manager會在合作夥伴的網域中設定Cookie(設定第一方Cookie)。

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。每位合作夥伴皆啟用。

mappings

物件

將值從一個索引鍵值組關聯至另一個。 請參閱將索引鍵值映射至其他索引鍵。 隨v2.4發行。

namespace

字串

必填.

namespace 機碼值組包含您的Experience Cloud組織ID。 如果您沒有此ID,可以在Experience Cloud控制面板的管理區段中找到。 您需要管理員權限才能檢視此控制面板。 請參閱產品特色與功能常見問題集管理 — 使用者管理和常見問題集

partner

字串

必填.

Audience Manager提供的合作夥伴名稱。

removeFinishedScriptsAndCallbacks

布林值

移除指令碼和回呼。 預設為 False . 僅適用於當前DIL實例。 隨v3.3發行。

uuidCookie

物件

使用從Audience Manager傳回的不重複使用者ID設定Cookie。 請參閱 uuidCookie屬性

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變數使用的屬性。 此變數是DIL.create方法的一部分。

uuidCookie 具有下列屬性:

名稱 說明
name Cookie名稱(預設為aam_did)。
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" 
    } 
});

本頁內容