Show Menu
主题×

Adobe插件:getValOnce

此插件由Adobe Consulting提供,旨在帮助您从Adobe Analytics中获得更多价值。 Adobe客户关怀部门不提供此插件的支持,包括安装或疑难解答。 如果您需要此插件的帮助,请与贵组织的客户经理联系。 他们可以安排与顾问的会议寻求帮助。
getValOnce 件可防止将变量设置为等于同一值多次。 当您希望删除访客刷新页面或以其他方式多次访问给定页面的重复出现时,Adobe建议使用此插件。 如果您不担心Analysis Workspace中的“发生次数”量度,则不必使用此插件。

使用Adobe Experience Platform Launch扩展安装插件

Adobe提供了一个扩展,允许您使用最常用的插件。
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. 单击所需的属性。
  3. 转到选 Extensions 项卡,然后单击按 Catalog 钮
  4. 安装和发布扩 Common Analytics Plugins 展
  5. 如果尚未创建,请使用以下配置创建标有“初始化插件”的规则:
    • 条件:无
    • 事件:核心——载入的库(页面顶部)
  6. 使用以下配置向上述规则添加操作:
    • 扩展:常见分析插件
    • 操作类型:初始化getValOnce
  7. 保存更改并发布到规则。

使用Launch自定义代码编辑器安装插件

如果您不想使用插件扩展,则可以使用自定义代码编辑器。
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. 单击所需的属性。
  3. 转到选项卡, Extensions 然后单击Adobe Analytics扩 Configure 展下的按钮。
  4. 展开折 Configure tracking using custom code 叠面板,以显示按 Open Editor 钮。
  5. 打开自定义代码编辑器,并将下面提供的插件代码粘贴到编辑窗口中。
  6. 保存更改并将其发布到Analytics扩展。

使用AppMeasurement安装插件

在实例化(使用)Analytics跟踪对象后,复制并粘贴AppMeasurement文件中的任意位置的以下代 s_gi 码。 在您的实施中保留代码的注释和版本号可帮助Adobe解决任何潜在问题。
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getValOnce v2.0 */
s.getValOnce=function(vtc,cn,et,ep){if(vtc&&(cn=cn||"s_gvo",et=et||0,ep="m"===ep?6E4:864E5,vtc!==this.c_r(cn))){var e=new Date;e.setTime(e.getTime()+et*ep);this.c_w(cn,vtc,0===et?0:ep);return vtc}return""};
/******************************************** END CODE TO DEPLOY ********************************************/

使用插件

该方 getValOnce 法使用以下参数:
  • vtc (必需,字符串):要检查并查看它之前是否设置为相同值的变量
  • cn (可选,字符串):包含要检查的值的Cookie的名称。 默认值为 "s_gvo"
  • et (可选,整数):cookie的到期时间(以天为单位,或以分钟为单位,具体取决于 ep 参数)。 默认为 0 ,浏览器会话结束时过期
  • ep (可选,字符串):仅当参数也被设置时 et 才设置此参数。 如果希望该参 "m" 数在数分钟(而 et 不是数天)后过期,请将此参数设置为。 默认为 "d" ,以天为单位 et 设置参数。
如果参 vtc 数与cookie值匹配,则此方法返回空字符串。 如果参 vtc 数与cookie值不匹配,则该方法将参数作为 vtc 字符串返回。

示例调用

示例#1

使用此调用可防止在接下来30天内连续多次将相同值传入s.campaign:
s.campaign=s.getValOnce(s.campaign,"s_campaign",30);

在上述调用中,插件将首先比较s_campaign cookie中已包含的值与当前s.campaign变量中的值。 如果未匹配,插件会将s_campaign Cookie设置为与s.campaign中的新值相等,然后返回新值。 这种比较将在接下来的30天内进行

示例#2

使用此调用可防止在整个会话中设置相同的值:
s.eVar2=s.getValOnce(s.eVar2,"s_ev2",0,"m");

此代码可防止同一值在用户整个会话中连续多次传入s.eVar2。 由于到期时间设置为等于0,因此它还会忽略参数中的“m”值(在呼叫结束时)。 该代码还将比较值存储在s_ev2 cookie中。

版本历史

2.0

  • 点发行版(重新编译后,代码尺寸更小)。

1.1

  • 添加了通过参数选择到期时间的分钟数或天 t 数。
  • 更正了用于 k 仅限插件的变量的范围。 此更改可防止页面上其他代码的可能干扰。