DIL建立方法 dil-create

WARNING
自2023年7月起,Adobe已停止開發 Data Integration Library (DIL) 和 DIL 副檔名。
現有客戶可繼續使用其 DIL 實作。 不過,Adobe將不會開發 DIL 超出此點。 建議客戶評估 Experience PlatformWeb SDK 長期資料收集策略的影響。
如果客戶希望在2023年7月之後實作新的資料收集整合,則應使用 Experience PlatformWeb SDK 而非。

DIL 建立 dil-create-new

建立合作夥伴特定的 DIL 執行個體。

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

initConfig元素

IMPORTANT
visitorService 屬性為 一直 必填。 除非另有指示,否則此處列出的其他屬性是選用的。

initConfig 接受下列元素:

名稱
類型
說明
containerNSID
整數

該屬性會設定 Audience Manager 所使用的容器 ID 以供 ID 同步之用。您可以設定 containerNSID 若您擁有 DIL 跨多個網站部署。 每個網站都有各自的容器ID和ID同步。 當您只有1個網站時,容器ID預設為0,您不需要正確設定。 請聯絡您的顧問,以取得您的網站清單及其容器ID。

Adobe Experience Platform Identity服務,屬性 idSyncContainerID 對應至 containerNSID 在 DIL . 如果您使用 DIL 跨多個網站的ID服務:

  • 針對每個網站,在設定相同的容器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 Identity服務,使用設定客戶ID 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 Identity Service。

如果 true ,不會將目的地發佈IFRAME附加至DOM或引發目的地。 預設為 false .

disableIDSyncs
布林值

重要:此元素已過時 DIL 8.0版(2018年8月發行)。 使用 visitor.disableIdSyncs 函式改用Adobe Experience Platform Identity Service。

停用 ID 同步。使用DILv6.2+和訪客ID服務時,您必須停用ID同步。 此 visitorService 函式(請參閱下面的範常式式碼)會負責此作業。

enableErrorReporting
布林值
將設為 true 啟用所有錯誤報告 DIL 頁面上的例項。 與布林值搭配使用 true 僅限。
iframeAkamaiHTTPS
布林值

重要:此元素已過時 DIL 8.0版(2018年8月發行)。 使用 visitor.idSyncSSLUseAkamai 函式改用Adobe Experience Platform Identity Service。

指定目標發佈範本是否應該針對 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 Identity服務 將已宣告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-props

定義使用的屬性 uuidCookie 變數中。 此變數屬於 DIL.create 方法。

uuidCookie 具有以下屬性:

名稱
說明
name
Cookie名稱( aam_did 為預設值)。
days
Cookie期限(預設為100天)。
path
Cookie路徑,例如 '/test' ( / 為預設值)。
domain
Cookie設定所在的網域,例如 'adobe.com' ( '.'+document.domain 為預設值)。
secure
設定旗標以僅透過HTTPS連線傳送資料。

visitorService屬性 visitor-service-props

定義使用的屬性 visitorService 變數中。 此變數屬於 DIL.create 方法。

visitorService 具有以下屬性:

名稱
類型
說明
namespace
字串
必填。代表Experience Cloud組織ID。 這是Experience Cloud核心服務功能所需的專案。 用來例項化訪客ID功能的相同引數。

程式碼範例:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695