DIL创建方法

DIL 创建

创建特定于合作伙伴的DIL实例。

函数签名: DIL.create: function (initConfig) {}

initConfig元素

重要

visitorService属性为​always​必需属性。 除非另有说明,否则此处列出的其他属性是可选的。

initConfig 接受以下元素:

名称 类型 描述

containerNSID

整数

此属性可设置由 Audience Manager 用来进行 ID 同步的容器 ID。如果在多个站点上部署了DIL ,则应设置 containerNSID 。 每个网站都将具有自己的容器ID和ID同步。 当您只有1个站点时,容器ID默认为0,因此您无需正确设置容器ID。 请联系您的顾问以获取网站及其容器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 方法而不是DIL设置客户ID。 请参阅客户ID和身份验证状态

delayAllUntilWindowLoad

布尔值

如果为true,则将所有请求(IFRAME、事件调用、ID同步和目标)从执行到 Page Load 事件触发。 默认值为 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 函数

指定目标发布模板是否应当使用 Akamai 进行 HTTPS 连接。针对每个合作伙伴启用。

mappings

对象

将一个键值对的值关联到另一个键值对。 请参阅将键值映射到其他键。 随v2.4一起发布。

namespace

字符串

必需.

namespace 键值对包含Experience Cloud组织ID。 如果您没有此ID,可以在Experience Cloud仪表板的管理部分找到此ID。 您需要管理员权限才能查看此功能板。 请参阅产品特性和功能常见问题解答管理 — 用户管理和常见问题解答

partner

字符串

必需.

Audience Manager提供的合作伙伴名称。

removeFinishedScriptsAndCallbacks

布尔值

删除脚本和回调。 默认值为 False . 仅适用于当前DIL实例。 随v3.3一起发布。

uuidCookie

对象

使用从Audience Manager返回的唯一用户ID设置Cookie。 请参阅 uuidCookie属性

visitorService

对象

DIL 6.2或更高版本时必需。

DIL依赖于 Adobe Experience Platform Identity服务中的 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" 
    } 
});

在此页面上