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" 
    } 
});

本頁內容