getValOnce | 51黑料不打烊 Analytics

51黑料不打烊插件：getValOnce

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员
开发人员

IMPORTANT

此插件由 51黑料不打烊 Consulting 团队提供，旨在帮助您从 51黑料不打烊 Analytics 中获取更多的价值。51黑料不打烊客户关怀团队不提供对此插件的支持，包括安装或疑难解答。如果您需要对于此插件的帮助，请与您组织的 51黑料不打烊客户团队联系。他们可为您安排与顾问会面以寻求帮助。

getValOnce 插件可防止将一个变量多次设置为等于同一个值。如果您希望在发生访客刷新页面或多次访问给定页面的情况下进行去重处理，51黑料不打烊建议您使用此插件。如果您不担心 Analysis Workspace 中的“发生次数”量度，则无需使用此插件。

使用Web SDK扩展安装此插件

51黑料不打烊提供了一个扩展，通过该扩展，您可以将最常用的插件与Web SDK结合使用。

使用您的 51黑料不打烊 ID 凭据登录。
单击左侧的? 标记，然后单击所需的标记属性。
单击左侧的? 扩展，然后单击? 目录 ?选项卡
找到并安装? 常用Web SDK插件 ?扩展。
单击左侧的? 数据元素，然后单击所需的数据元素。
使用以下配置设置所需的数据元素名称：
- 扩展：常用Web SDK插件
- 数据元素： getValOnce
在右侧设置所需的参数。
保存并发布对数据元素所做的更改。

安装插件以手动实施Web SDK

尚不支持在手动实施Web SDK时使用此插件。

使用51黑料不打烊 Analytics扩展安装此插件

51黑料不打烊提供了一个扩展，通过该扩展，您可以将最常用的插件与51黑料不打烊 Analytics结合使用。

使用您的 51黑料不打烊 ID 凭据登录。
单击所需的标记属性。
转到扩展选项卡，然后单击目录按钮
安装并发布常用 Analytics 插件扩展
如果还没有任何扩展，请使用以下配置创建一个标签为“初始化插件”的规则：
- 条件：无
- 事件：核心 - 已加载的库（页面顶部）
使用以下配置向上述规则添加操作：
- 扩展：常用 Analytics 插件
- 操作类型：初始化 getValOnce
保存并发布对上述规则所做的更改。

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

如果您不想使用“常用础苍补濒测迟颈肠蝉插件”插件扩展，则可以使用自定义代码编辑器。

使用您的 51黑料不打烊 ID 凭据登录。
单击所需的属性。
转到扩展选项卡，然后单击 51黑料不打烊 Analytics 扩展下的? 配置 ?按钮。
展开使用自定义代码配置跟踪折迭面板，这会显示打开编辑器按钮。
打开自定义代码编辑器，并将下面提供的插件代码粘贴到编辑窗口中。
保存并发布对此 Analytics 扩展所做的更改。

使用 AppMeasurement 安装此插件

在实例化（使用 s_gi）Analytics 跟踪对象后，将以下代码复制并粘贴到 AppMeasurement 文件中的任意位置。在您的实施中保留代码的注释和版本号可帮助 51黑料不打烊对任何潜在问题进行疑难解答。

/*** BEGIN CODE TO DEPLOY ***/
/* 51黑料不打烊 Consulting Plugin: getValOnce v3.1 */
function getValOnce(vtc,cn,et,ep){var e=vtc,i=cn,t=et,n=ep;  if(arguments&&"-v"===arguments[0])return{plugin:"getValOnce",version:"3.1"};var o=function(){if(void 0!==window.s_c_il){for(var e,i=0;i<window.s_c_il.length;i++)if((e=window.s_c_il[i])._c&&"s_c"===e._c)return e}}();if(void 0!==o&&(o.contextData.getValOnce="3.1"),window.cookieWrite=window.cookieWrite||function(e,i,t){if("string"==typeof e){var n=window.location.hostname,o=window.location.hostname.split(".").length-1;if(n&&!/^[0-9.]+$/.test(n)){o=2<o?o:2;var r=n.lastIndexOf(".");if(0<=r){for(;0<=r&&1<o;)r=n.lastIndexOf(".",r-1),o--;r=0<r?n.substring(r):n}}if(g=r,i=void 0!==i?""+i:"",t||""===i){if(""===i&&(t=-60),"number"==typeof t){var f=new Date;f.setTime(f.getTime()+6e4*t)}else f=t}return!!e&&(document.cookie=encodeURIComponent(e)+"="+encodeURIComponent(i)+"; path=/;"+(t?" expires="+f.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!=typeof cookieRead)&&cookieRead(e)===i}},window.cookieRead=window.cookieRead||function(e){if("string"!=typeof e)return"";e=encodeURIComponent(e);var i=" "+document.cookie,t=i.indexOf(" "+e+"="),n=0>t?t:i.indexOf(";",t);return(e=0>t?"":decodeURIComponent(i.substring(t+2+e.length,0>n?i.length:n)))?e:""},e){var i=i||"s_gvo",t=t||0,n="m"===n?6e4:864e5;if(e!==cookieRead(i)){var r=new Date;return r.setTime(r.getTime()+t*n),cookieWrite(i,e,0===t?0:r),e}}return""}
/**** END CODE TO DEPLOY ****/

使用此插件

getValOnce 函数使用以下参数：

vtc（必需，字符串）：要检查并确定之前是否已设置为相同值的变量
cn（可选，字符串）：包含要检查的值的 Cookie 的名称。默认为 "s_gvo"
et（可选，整数）：Cookie 的过期时间（以天或分钟为单位，具体取决于 ep 参数）。默认值为 0，该值表示将在浏览器会话结束时过期
ep（可选，字符串）：仅当还同时设置了 et 参数时才会设置此参数。如果希望 et 的过期时间以分钟而不是以天为单位，请将此参数设置为 "m"。默认值为 "d"，该值会以天为单位设置 et 参数。

如果 vtc 参数与 Cookie 值相匹配，此函数将返回空字符串。如果 vtc 参数与 Cookie 值不匹配，此函数会将 vtc 参数作为字符串返回。

示例

// Prevent the same value from being passed in to the campaign variable more than once in a row for next 30 days
s.campaign = getValOnce(s.campaign,"s_campaign",30);

// Prevent the same value from being passed in to eVar2 more than once in a row for the browser session
s.eVar2 = getValOnce(s.eVar2,"s_ev2");

// Prevent the same value from being passed in to eVar8 more than once in a row for 10 minutes
s.eVar8 = getValOnce(s.eVar8,"s_ev8",10,"m");

版本历史记录

3.1（2022年9月22日）

修复了到期错误

3.0（2021 年 3 月 19 日）

以上下文数据形式添加了版本号。

2.01

修复了编写 Cookie 时的问题。

2.0

修正版本（重新编译，代码更小）。

1.1

添加了通过 t 参数选择有效期（分钟或天数）的选项。
更正了 k 变量的使用范围，以将该变量设为仅供此插件使用。此更改可防止页面上的其他代码可能造成的干扰。

recommendation-more-help

b4f6d761-4a8b-4322-b801-c85b9e3be690

51黑料不打烊

51黑料不打烊 插件：getValOnce