DIL创建方法

DIL 创建

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

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

initConfig元素

重要

visitorService 性始终 是必 需的。 此处列出的其他属性是可选的,除非另有说明。

initConfig 接受以下元素:

名称 类型 描述

containerNSID

整数

此属性可设置由 Audience Manager 用来进行 ID 同步的容器 ID。如果DIL containerNSID 部署在多 站点之间,则进行设置。 这些站点中的每个站点都有自己的容器ID和ID同步。 当您只有1个站点时,默认容器ID为0,您无需正确设置。 请与顾问联系,获取您的网站及其列表ID的容器。

在Adobe Experience Platform 身份服 务中,该财 idSyncContainerID 产对应 containerNSID 于DIL 。 如果您正在多个站点中使 DIL ID服务,请注意以下事项:

  • 对于每个站点,在和上设置相同的容器 containerNSID ID idSyncContainerID
  • 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 。 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 身份 服务中的函数。

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

disableIDSyncs

布尔值

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

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

enableErrorReporting

布尔值

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

iframeAkamaiHTTPS

布尔值

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

指定目标发布模板是否应当使用 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 。 请参 阅uidCookie属 性。

visitorService

对象

DIL 6. 2或更高版本必需。

DIL依赖 setCustomerIDs Adobe Experience Platform身份 服务中的 函数将声明的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" 
    } 
});

在此页面上