DIL建立方法

DIL 建立

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

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

initConfig元素

重要

的 visitorService 屬性 總是 。 此處列出的其他屬性是可選的，除非另有說明。

initConfig 接受以下元素：

名稱 類型 說明

containerNSID

整數

該屬性會設定 Audience Manager 所使用的容器 ID 以供 ID 同步之用。你可以 containerNSID 如果你 DIL 跨多個站點部署。 這些站點中的每個站點都將具有自己的容器ID和ID同步。 當您只有1個站點時，預設情況下容器ID為0，您無需正確設定。 請與咨詢人聯繫，以獲取您的站點及其容器ID的清單。

在 Adobe Experience Platform身份服務 ，屬性 idSyncContainerID 對應 containerNSID 在 DIL 。 如果使用 DIL 和 跨多個站點的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身份服務 ，使用 setCustomerIDs 方法代替 DIL 。 請參閱 客戶ID和身份驗證狀態 。

delayAllUntilWindowLoad

布林值

如果為true，則將所有請求（IFRAME、事件調用、ID同步和目標）從執行到 Page Load 事件觸發。 預設為 false .

disableDeclaredUUIDCookie

布林值

False 預設情況下，這意味著 Audience Manager 在夥伴的域中設定cookie（設定第一方cookie）。

disableDestinationPublishingIframe

布林值

重要提示：此元素已棄用 DIL 8.0版（2018年8月發佈）。 使用 visitor.disableIdSyncs 函式 在Adobe Experience Platform身份服務。

如果 true ，不會將目標發佈IFRAME附加到DOM或觸發目標。 預設為 false .

disableIDSyncs

布林值

重要提示：此元素已棄用 DIL 8.0版（2018年8月發佈）。 使用 visitor.disableIdSyncs 函式 在Adobe Experience Platform身份服務。

停用 ID 同步。使用DILv6.2+和訪問者ID服務時，必須禁用ID同步。 的 visitorService 函式（請參閱下面的示例代碼）將處理此操作。

enableErrorReporting

布林值

設定為 true 啟用錯誤報告 DIL 實例。 使用布爾值 true 只是。

iframeAkamaiHTTPS

布林值

重要提示：此元素已棄用 DIL 8.0版（2018年8月發佈）。 使用 visitor.idSyncSSLUseAkamai 函式 在Adobe Experience Platform身份服務。

指定目標發佈範本是否應該針對 HTTPS 連線使用 Akamai。每位合作夥伴皆啟用。

mappings

物件

將值從一個鍵值對關聯到另一個鍵值對。 請參閱 將鍵值映射到其他鍵 。 隨v2.4發佈。

namespace

字串

必填.

的 namespace 鍵值對包含 Experience Cloud 組織ID。 如果您沒有此ID，可以在 管理 的下界 Experience Cloud 控制項欄。 您需要管理員權限才能查看此儀表板。 查看 產品功能和常見問題 和 管理 — 用戶管理和常見問題 。

partner

字串

必填.

合作夥伴名稱，由提供 Audience Manager 。

removeFinishedScriptsAndCallbacks

布林值

刪除指令碼和回調。 預設為 False . 應用於當前 DIL 僅實例。 隨v3.3發佈。

uuidCookie

物件

使用從返回的唯一用戶ID設定Cookie Audience Manager 。 請參閱 UUIDCookie屬性 。

visitorService

物件

必填項 DIL 6.2或更高版本。

DIL依靠 setCustomerIDs 函式 Adobe Experience Platform身份服務 將聲明的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 變數。 此變數是 DIL.create 的雙曲餘切值。

visitorService 具有以下屬性：

名稱 類型 說明
namespace 字串 必填。表示Experience Cloud組織ID。 這是Experience Cloud核心服務功能所需的。 用於實例化訪問者ID功能的參數相同。

程式碼範例:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});

本頁內容