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身份服务中,属性 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身份服务,请使用 setCustomerIDs 方法设置客户ID,而不是使用DIL。 请参阅客户ID和身份验证状态

delayAllUntilWindowLoad

布尔值

如果为true,则将所有请求(IFRAME、事件调用、ID同步和目标)从执行中删除,直到 Page Load 事件触发。 默认值为 false .

disableDeclaredUUIDCookie

布尔值

false 默认情况下,这意味着Audience Manager在合作伙伴的域中设置cookie(设置第一方cookie)。

disableDestinationPublishingIframe

布尔值

重要: DIL版本8.0(2018年8月发布)已弃用此元素。 请改用Adobe Experience Platform标识服务中的 visitor.disableIdSyncs 函数

如果 true ,则不会将目标发布IFRAME连接到DOM或触发目标。 默认值为 false .

disableIDSyncs

布尔值

重要: DIL版本8.0(2018年8月发布)已弃用此元素。 请改用Adobe Experience Platform标识服务中的 visitor.disableIdSyncs 函数

禁用 ID 同步。在使用DILv6.2+和访客ID服务时,必须禁用ID同步。 visitorService 函数(请参见下面的示例代码)负责此操作。

enableErrorReporting

布尔值

设置为 true 可为页面上的所有DIL实例启用错误报告。 仅可用于布尔值 true

iframeAkamaiHTTPS

布尔值

重要: DIL版本8.0(2018年8月发布)已弃用此元素。 请改用Adobe Experience Platform标识服务中的 visitor.idSyncSSLUseAkamai 函数

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

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标识服务中的 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" 
    } 
});

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now