Adobe 插件:Numbers Suite

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

Numbers Suite 包含一系列 JavaScript 函数。具体包含以下插件:

  • zeroPad:在数字的开头处添加特定数量的零。如果变量需要达到特定的位数,例如您要使用 JavaScript 日期对象,并且希望用两位数(而不是只用一位数)来格式化某个日期对应的月和日,则可以使用此插件。例如,采用 01/09/2020 格式而不是 1/9/2020 格式。
  • randomNumber:生成具有特定位数的随机数。如果您部署第三方标签并希望获取用于搜索缓存的随机数,此插件非常有用。
  • twoDecimals:将数字四舍五入到其最接近的百分位值。此插件可用于处理货币,允许您将数字四舍五入为有效货币值。

使用Web SDK或Web SDK扩展安装此插件

尚不支持使用此插件在Web SDK中使用。

使用Adobe Analytics扩展安装此插件

Adobe提供了一个扩展,通过该扩展,您可以将最常用的插件与Adobe Analytics结合使用。

  1. 使用您的 Adobe ID 凭据登录 Adobe Experience Platform 数据收集

  2. 单击所需的标记属性。

  3. 转到扩展选项卡,然后单击目录按钮

  4. 安装并发布常用 Analytics 插件扩展

  5. 如果还没有任何扩展,请使用以下配置创建一个标签为“初始化插件”的规则:

    • 条件:无
    • 事件:核心 - 已加载的库(页面顶部)
  6. 使用以下配置向上述规则添加操作:

    • 扩展:常用 Analytics 插件
    • 操作类型:初始化 Numbers Suite
  7. 保存并发布对上述规则所做的更改。

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

如果您不想使用“常用Analytics插件”插件扩展,则可以使用自定义代码编辑器。

  1. 使用您的 Adobe ID 凭据登录 Adobe Experience Platform 数据收集
  2. 单击所需的属性。
  3. 转到扩展选项卡,然后单击 Adobe Analytics 扩展下的​ 配置 ​按钮。
  4. 展开使用自定义代码配置跟踪折叠面板,这会显示打开编辑器按钮。
  5. 打开自定义代码编辑器,并将下面提供的插件代码粘贴到编辑窗口中。
  6. 保存并发布对此 Analytics 扩展所做的更改。

使用 AppMeasurement 安装此插件

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

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: zeroPad v1.0 */
function zeroPad(num,nod){num=parseInt(num);nod=parseInt(nod);if(isNaN(num)||isNaN(nod))return"";var c=nod-num.toString().length+ 1;return Array(+(0<c&&c)).join("0")+num};

/* Adobe Consulting Plugin: randomNumber v2.0 (zeroPad plug-in optional)*/
function randomNumber(nod){nod="number"===typeof nod?17>Math.abs(nod)?Math.round(Math.abs(nod)):17:10;for(var a="1",c=0;c<nod;c++) a+="0";a=Number(a);a=Math.floor(Math.random().toFixed(nod)*a)+"";a.length!==nod&&"undefined"!==typeof zeroPad&&(a=zeroPad(a,nod)); return a};

/* Adobe Consulting Plugin: twoDecimals v1.0 */
function twoDecimals(v){return"undefined"===typeof v||void 0===v||isNaN(v)?0:Number(Number(v).toFixed(2))};
/******************************************** END CODE TO DEPLOY ********************************************/

使用插件

zeroPad 函数使用以下参数:

  • num(必需,整数):要填充的数字。如果此参数的值含小数,则此函数会对该值进行四舍五入。
  • nod(必需,整数):最终返回值的位数。如果要填充的数字的位数少于要填充的位数,则此插件会在 num 参数的开头处添加相应数量的零。

randomNumber 函数使用以下参数:

  • nod(可选,整数):要生成的随机数的位数。最大值为 17 位。默认值为 10 位。

twoDecimals 函数使用以下参数:

  • val(必需,数字):要将其四舍五入到最接近的百分位值的数字(由字符串或数字对象表示)。

返回结果

  • zeroPad 函数会返回一个等于 num 参数的字符串,但会在其值的开头处添加特定数量的零,以确保返回值具有正确位数。
  • randomNumber 函数会返回一个等于具有所需位数的随机数的字符串。
  • twoDecimals 函数会返回一个已四舍五入到最接近的百分位值的数字对象。

示例调用

zeroPad 示例

s.eVar25 = zeroPad(25.5562, 5) //sets eVar25 equal to "00025"

s.prop1 = zeroPad(25, 1) //sets prop1 equal to "25"

s.prop1 = zeroPad(232425235,23) //sets prop1 equal to "00000000000000232425235"

randomNumber 示例

s.eVar65 = randomNumber(15) //sets eVar65 equal to "721759731750342" or some other random 15-digit number

randomNumber() //returns a random 10-digit number but is useless since this isn't used in an expression

var j = randomNumber(35) //sets a variable named j equal to "15476068651810060" or another random 17-digit number

twoDecimals 示例

s.events = "event10=" + twoDecimals("85.4827128694") //sets s.events="event10=85.48"

var fivehundredthirtytwo = twoDecimals(532.000000001) //sets the variable fivehundredthirtytwo equal to 532

s.eVar65 = twoDecimals("672132.9699736457") //sets s.eVar65 equal to 672132.97

版本历史记录

1.0(2019 年 5 月 25 日)

  • 第一版。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690