DIL 用例和代码示例 dil-use-cases-and-code-samples

特定DIL用例的代码示例和描述。

将数据元素发送到DIL的Audience Manager send-data-elements-dil

创建一个对象变量，以将有关页面元素的信息发送到Audience Manager。 这对常规数据收集或用Analytics变量收集数据的替代方法非常有用。

描述

以下代码演示了如何收集页面数据并将其发送到Audience Manager，其中 DIL. 这些示例使用变量将数据元素保存在平面列表或数组中。 请记住，将变量作为 键值对. 此外，请注意以下事项 c_ 键值对中键的前缀。 此 必需的前缀 将信息标识为用户定义的数据。 在第一个示例中，您需要手动附加 c_ 到钥匙里。 在第二个示例中， DIL 自动为您完成此操作。

保持值属性一致

传入数据时，请记住保持值属性相同。 例如，如果您有两个值不同的相同键，则最后一个键 — 值对的值优先于前面的值对象。 例如，传入 color:blue 和 color:red 将返回值设置为红色（覆盖蓝色）。

示例1：以键值对的形式发送数据

此基本示例将颜色和价格数据以键值对的形式发送到Audience Manager。 您的代码可能类似于以下内容：

var sample_dil = DIL.create({partner:"partner name"});
sample_dil.api.signals({
   c_color:"blue",
   c_price:"900"
});
sample_dil.api.submit();

示例2：在对象中发送数据

此高级示例演示了如何将对象中的数据发送到Audience Manager。 使用此方法时， DIL 允许您将对象作为函数参数传递到 signals() 方法。 DIL 您的代码可能类似于以下内容：

var my_object = {
   color : "blue",
   price : "900"
};

var sample_dil = DIL.create({ partner : "partner name" });
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager.
sample_dil.api.signals(my_object,"c_").submit();

示例3：在数组中发送页面数据

在本例中，变量为 my_object 使用数组来保存数据。 此示例以上述推荐方法传递的信息为基础，但添加了额外的层以适应产品类型和模型。 您的代码可能类似于以下内容：

var my_objects = [{
   color : "blue",
   price : "900"
}, {
   type : "acura",
   model : "tl"
}];

var sample_dil = DIL.create({ partner : "partner name" });

for (var i = 0; i < my_objects.length; i++)
//Load the object and append "c_" to all the keys in the key-value pairs.
{
    sample_dil.api.signals(my_objects[i], "c_");
}
sample_dil.api.submit();

捕获反向链接URL capture-referring-url

捕获反向链接URL并将其发送给Audience Manager。

代码示例

您的代码可能类似于以下内容：

var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

捕获搜索引擎类型和关键词搜索词 capture-search-engine-types

将有关搜索引擎类型和关键词搜索的信息发送到Audience Manager。

支持的搜索引擎

默认情况下， DIL.getSearchReferrer 识别来自这些搜索引擎的搜索（包括国际变体）：

描述

以下代码演示了如何获取任何受支持的搜索引擎的搜索反向链接。 在本例中，我们假设一位用户在搜索术语“homes”时， Google 加拿大( www.google.ca)。 此代码将帮助您捕获这些搜索词并将它们发送到Audience Manager。

基本代码

用于获取搜索反向链接的基本代码(从 google.com例如)如下所示：

var search_referrer = DIL.tools.getSearchReferrer();

列出的搜索引擎代码示例

在本例中，假设用户从以下位置搜索术语“homes”： Google 加拿大( www.google.ca)。 请注意代码如何为必填字段添加前缀 c_ 参数到搜索引擎( c_se)和搜索词( c_st)。 c_ 是 必需的前缀 可将这些变量标识为客户定义的变量以进行Audience Manager。

var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer();

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

未列出的搜索引擎代码示例

在本例中，假设用户从以下位置搜索术语“homes”： dogpile.com. 因为 Dogpile 默认情况下不支持，您可以配置DIL以识别此搜索引擎并将搜索词返回给Audience Manager。 您的代码可能类似于以下内容：

var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {
    hostPattern:/dogpile\./,
    queryParam:"q"
});

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

将键值映射到其他键 map-key-values

将键值对中的值关联到另一个键。

描述

在键值对中， c_ 附加到键的前缀将信号标识为客户定义的数据。 客户定义的数据用于定位在事件调用中传入数据的特定网站。 但是，有时您会希望此信息在Audience Manager帐户中的所有资产中均可用。 为此，请将值映射到 c_ 键值对到平台级别键。 平台级别密钥的前缀为 d_ 并使得信号可用于在帐户中的所有属性中进行定位。

例如，您从特定网站收集邮政编码数据，但希望将其定位到所有Audience Manager资产。 要使邮政编码在平台级别可用，您可以映射客户定义的邮政编码密钥(例如， c_zip)到平台定义的键，如下所示。

代码示例

您的代码可能类似于以下内容：

var adobe_dil = DIL.create({
    partner : "adobe",
    mappings : {
        c_zip : 'd_zip',
        d_key2 : 'h_dil_key2'
    }
});
adobe_dil.api.signals({c_zip : '10010'}).submit();
// Request will look like /event?c_zip=10010&d_zip=10010

Google Tag Manager (GTM)中的流量DIL traffic-dil-gtm

使用GTM标记设置并提供DIL。

此过程假定您拥有 Google Tag Manager 帐户、该产品的一些工作知识以及您的Audience Manager dil.js 文件。

要通信 dil.js GTM中的文件：