DIL 用例和代码示例

特定DIL用例的代码示例和说明。

将Audience Manager元素发送到DIL

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

描述

下面的代码演示如何收集页面数据并将其发送到具有DIL的Audience Manager。 这些示例使用变量将数据元素存放在平面列表或数组中。 请记住，将变量作为键值对进行传递。 另外，请注意键值对中键前的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

捕获引用URL并将其发送给Audience Manager。

代码示例

您的代码可能如下所示：

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

捕获搜索引擎类型和关键字搜索词

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

支持的搜索引擎

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

• AOL
• Ask
• Bing
• Google
• Yahoo!

描述

下面的代码演示如何获取任何支持的搜索引擎的搜索推荐人。 在这种情况下，假定用户从加拿大的Google (www.google.ca)搜索了“homes”一词。 此代码将帮助您捕获这些搜索词并将它们发送到Audience Manager。

基本代码

获取搜索推荐人（例如，从google.com）的基本代码如下所示：

var search_referrer = DIL.tools.getSearchReferrer();

列出的搜索引擎代码示例

在这种情况下，假设用户从加拿大Google (www.google.ca)搜索“homes”一词。 请注意代码如何将所需的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(); 
}

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

在这种情况下，假设用户从dogpile.com搜索词“homes”。 由于默认不支持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(); 
}

将键值映射到其他键

将值从键值对关联到另一个键。

描述

在键值对中，键附加的c_前缀将信号标识为客户定义的数据。 客户定义的数据用于定位在事件呼叫中传递数据的特定站点。 但是，有时您希望此信息在Audience Manager帐户中的所有属性中都可用。 为此，请将c_键值对中的值映射到平台级别键。 平台级别键前缀为d_，使该信号可用于在帐户中的所有属性中进行定位。

例如，您从特定站点收集ZIP代码数据，但希望将其目标到您的所有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标签管理器(GTM)中的流量DIL

使用GTM标签设置和提供DIL。

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

要在GTM中传输dil.js文件，请执行以下操作：

1. 创建新容器或打开现有容器。

2. 向容器添加新标记。

3. 打开标记进行编辑，并：

   • 命名标记。
   • 从​Tag Type​下拉列表中选择​Custom HTML Tag。
   • 在HTML字段中，将DIL代码（库+自定义代码）放在脚本标记<script>DIL code</script>中。
   • 单击 Save.

4. 发布容器。

5. 生成容器标记代码并将其放在您的库存中。