Show Menu
主题×

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 Identity Service中,该属 性对应于 idSyncContainerID DIL中的 containerNSID 属性 。 如果您在多个站点上使用 DIL ID服务 ,请注意以下事项:
  • 对于每个站点,在和上设置相同的容 containerNSID 器ID idSyncContainerID
  • DIL和 ID服 务都将尝试将ID同步发送到我们的数据收集iFrame。 但是,iFrame可确保 DIL 不会触发ID同步。 这可以防止重复。
  • 只有 DIL才 会将数据发送到 URL目标
declaredId
对象
delcaredId 用于传递:
  • dpid :Audience Manager分配给您的数据合作伙伴 ID
  • dpuuid :您的用户唯一ID。
重要说明: 仅对您的ID使用未编码的值。 编码将创建双重编码标识符。
注意: 如果您使用 Adobe Experience Platform Identity Service,请 使用方法而不是DIL设置客 setCustomerIDs 户ID 。 See Customer IDs and Authentication States .
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 同步。在使用DIL v6.2+和访客ID服务时,必须禁用ID同步。 函 visitorService 数(请参阅下面的示例代码)负责此操作。
enableErrorReporting
布尔值
设置为 true 可为页面上的所有 DIL实 例启用错误报告。 仅适用于布 true 尔。
iframeAkamaiHTTPS
布尔值
重要说明: DIL版本8.0(2018年8月发 布) 已弃用此元素。 请改用 visitor.idSyncSSLUseAkamai Adobe Experience Platform Identity Service中的功能。
指定目标发布模板是否应当使用 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依靠 setCustomerIDs Adobe Experience Platform Identity Service中的功 能将声明的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" 
    } 
});