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

本頁內容