Show Menu
主题×

DIL用例和代码示例

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

使用DIL将受众元素发送到数据管理器

创建一个对象变量,将有关页面元素的信息发送到受众管理器。 这对于一般数据收集或使用Analytics变量收集数据的替代方法非常有用。
描述
下面的代码演示如何收集页面数据并将其发送给受众管理器 DIL。 这些示例使用变量将数据元素存放在平面列表或数组中。 记住,将变量作 为键值对传递 。 另外,请注 c_ 意键值对中键前的前缀。 此必 需前缀 ,将信息标识为用户定义的数据。 在第一个示例中,您需要手动附 c_ 加到键。 在第二个示例中, DIL 自动为您执行此操作。
使值属性保持一致
在传入数据时,请记住保持值属性相同。 例如,如果您有两个具有相同值的键,则最后一个键值对的值优先于前一个值对象。 例如,传入并 color:blue 将返 color:red 回的值设置为红色(覆盖蓝色)。
示例1: 将数据作为键值对发送
此基本示例以键值对的形式向受众经理发送颜色和价格数据。 您的代码可能如下所示:
var sample_dil = DIL.create({partner:"

partner name

"}); 
sample_dil.api.signals({ 
   c_color:"blue", 
   c_price:"900" 
}); 
sample_dil.api.submit();


示例2: 在对象中发送数据
此高级示例演示如何将对象中的数据发送到受众管理器。 使用此方法时, 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并将其发送给受众管理器。
仅当用户在具有相似协议(HTTP与HTTPS)的页面之间移动时,此方法才有效。 例如,当您从安全站点导航到另一个安全站点时,浏览器会保留引用URL。 当您在安全站点和不安全站点之间移动时,浏览器不会保留引用URL。 此行为是正常的浏览器功能,不能被规避 DIL。
代码示例
您的代码可能如下所示:
var adobe_dil = DIL.create({ partner : "

partner name

" }); 
adobe_dil.api.signals({ d_referer : document.referrer }).submit();


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

将有关搜索引擎类型和关键字搜索的信息发送到受众管理器。
本节介绍最新版DIL不支持的旧版功能。
支持的搜索引擎
默认情况下, DIL.getSearchReferrer 可以识别来自这些搜索引擎(包括国际变量)的搜索:
  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!
描述
下面的代码演示如何获取任何支持的搜索引擎的搜索推荐人。 在本例中,假定用户搜索了来自加拿大的“ Google homes”( www.google.ca )。 此代码将帮助您捕获这些搜索词并将它们发送给受众经理。
基本代码
获取搜索推荐人(例如,从 google.com )的基本代码如下所示:
var search_referrer = DIL.tools.getSearchReferrer();

列出的搜索引擎代码示例
在本例中,假设用户从加拿大搜索了“ Google homes”( www.google.ca )。 请注意代码如何将所 c_ 需参数作为搜索引擎( c_se )和搜索词( c_st )的前缀。 c_ 是必 需的前缀 ,它将这些变量标识为受众管理器的客户定义变量。
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以识别此搜索引擎,并将搜索词返回给受众管理器。 您的代码可能如下所示:
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_ 的前缀将信号标识为客户定义的数据。 客户定义的数据用于定位在事件呼叫中传递数据的特定站点。 但是,有时您希望此信息在受众管理器帐户的所有属性中都可用。 为此,请将键值对中的 c_ 值映射到平台级别键。 平台级别键前缀 d_ 有,可在帐户中的所有属性中定位。
例如,您从特定站点收集ZIP代码数据,但希望将其目标到所有受众管理器属性。 要使邮政编码在平台级别可用,您可以映射客户定义的邮政编码密钥(例如, 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 户、有关该产品的一些工作知识以及受众经理 dil.js 文件。
要在GTM中传 dil.js 输文件,请执行以下操作:
  1. 创建新容器或打开现有容器。
  2. 向容器添加新标记。
  3. 打开标记进行编辑,并:
    • 命名标记。
    • Select Custom HTML Tag from the Tag Type drop-down list.
    • 在HTML字段中,将代 DIL 码(库+自定义代码)放在脚本标记内 <script>DIL code</script>
    • 单击 Save .
  4. 发布容器。
  5. 生成容器标记代码并将其放在您的库存中。