Show Menu
主题×

DIL创建方法

DIL创建

创建特定于合作伙伴的 DIL 实例。
函数签名: DIL.create: function (initConfig) {}
initConfig元素
该属 visitorService 性始终 是必需 。 除非另有指明,此处列出的其他属性是可选的。
initConfig 接受以下元素:
名称 类型 描述
containerNSID
整数
此属性可设置由 Audience Manager 用来进行 ID 同步的容器 ID。如果已跨多个 站点部 署DIL,则应设 置容 器NSID。 每个站点都将具有自己的容器ID和ID同步。 当您只有1个站点时,默认情况下容器ID为0,您无需正确设置它。 请联系您的顾问以获取站点及其容器ID的列表。
Experience Cloud ID服务中,属性 idSyncContainerID与 DIL 中的容器 NSID相对应 。 如果您在多个站点上使用 DIL ID服务 ,请注意以下事项:
  • 对于每个站点,在容器NSID和idSyncContainerID上设 置相同的 容器 ID
  • DIL和 ID服 务都将尝试将ID同步发送到我们的数据收集iFrame。 但是,iFrame可确保 DIL 不会触发ID同步。 这可以防止重复。
  • 只有 DIL才 会将数据发送到 URL目标
declaredId
对象
delcandedId 用于传递以下任一项:
  • dpid :Audience manager分配给您的数据合作伙伴 ID
  • dpuuid :您的用户唯一ID。
重要说明: 仅对您的ID使用未编码的值。 编码将创建双重编码标识符。
注意: 如果您使用 Experience Cloud ID服务, 请使用setCustomerIDs方法设置客户ID,而不 是使用 DIL 。 See Customer IDs and Authentication States .
delayAllUntilWindowLoad
布尔值
如果为true,则将执行所有请求(IFRAME、事件调用、ID同步和目标),直到“页面加载”事 触发。 Default is false .
disableDeclaredUUIDCookie
布尔值
false 默认情况下,这意味 着Audience Manager 在合作伙伴的域中设置Cookie(设置第一方Cookie)。
disableDestinationPublishingIframe
布尔值
重要说明: DIL版本8.0(2018年8月发 布) 已弃用此元素。 请改用 Experience Cloud ID服 务中 mcvid-disableidsync.html 的visitor.disableIdSyncs函数。
果为 true,则不会将目标发布IFRAME附加到DOM或触发目标。 Default is false .
disableIDSyncs
布尔值
重要说明: DIL版本8.0(2018年8月发 布) 已弃用此元素。 请改用 Experience Cloud ID服 务中 mcvid-disableidsync.html 的visitor.disableIdSyncs函数。
禁用 ID 同步。在使用DIL v6.2+和访客ID服务时,必须禁用ID同步。 visitor Service 函数(请参阅下面的示例代码)负责此操作。
enableErrorReporting
布尔值
设置为 true可 为页面上的所有 DIL实 例启用错误报告。 仅与Boolean true 一起使用。
iframeAkamaiHTTPS
布尔值
重要说明: DIL版本8.0(2018年8月发 布) 已弃用此元素。 请改用 Experience Cloud ID服务中的visitor.idSyncSSLUseAkamai mcvid-idSyncSSLUseAkamai.html 数。
指定目标发布模板是否应当使用 Akamai 进行 HTTPS 连接。针对每个合作伙伴启用。
映射
对象
将值从一个键值对关联到另一个键值对。 请参 阅将键值映射到其他键 。 随v2.4一起发布。
namespace
字符串
必需.
命名 空间 键值对包含您的 Experience Cloud组 织ID。 如果您没有此ID,则可以在Experience cloud仪表板的“管 理” 部分找到 该ID 。 您需要管理员权限才能查看此功能板。 请参阅产 品功能常见问题解答和 管理- 用户管理和常见问题解答
合作伙伴
字符串
必需.
Audience manager提供的合作伙伴名 称。
removeFinishedScriptsAndCallbacks
布尔值
删除脚本和回调。 Default is False . 仅适用于当 前DIL 实例。 随v3.3一起发布。
uuidCookie
对象
使用从 Audience Manager返回的唯一用户ID设置Cookie 。 请参阅 uuidCookie属 性。
visitorService
对象
DIL 6.2或 更高版 本必需。
DIL依靠 Experience Cloud ID服务 中的setCustomerID功能 将声明的ID传递到 Audience Manager 中。 See Customer IDs and Authentication States for more information.
示例代码
示例调 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
The cookie name ( aam_did is default).
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" 
    } 
});