Adobe 插件：addProductEvent

addProductEvent 插件会向 products 变量添加数值或货币事件。如果您希望向 products 变量添加数值或货币事件而无需担心产品字符串格式，Adobe 建议使用此插件。如果不在 products 变量中使用数值或货币事件，则无需使用此插件。

在Adobe Experience Platform中使用标记安装插件

Adobe 提供了一个扩展，通过该扩展，您可以使用一些最常用的插件。

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

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

如果您不想使用插件扩展，则可以使用自定义代码编辑器。

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

使用 AppMeasurement 安装此插件

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

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: addProductEvent v2.0 */
function addProductEvent(en,ev,ap){var f=en,g=ev,c=ap;if("-v"===f)return{plugin:"addProductEvent",version:"2.0"};var d=function(){if("undefined"!==typeof window.s_c_il)for(var b=0,e;b<window.s_c_il.length;b++)if(e=window.s_c_il[b],e._c&&"s_c"===e._c)return e}();if("undefined"!==typeof d&&(d.contextData.addProductEvent="2.0",window.apl=window.apl||function(b,e,c,d,f){function g(b,d,c,e){if("string"!==typeof d)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==e&&d===b[c]||d.toLowerCase()===b[c].toLowerCase())return!0;return!1}if(!b||"string"===typeof b){if("string"!==typeof e||""===e)return b;c=c||",";d=d||c;1==d&&(d=c,f||(f=1));2==d&&1!=f&&(d=c);e=e.split(",");k=e.length;for(var h=0;h<k;h++)g(b,e[h],c,f)||(b=b?b+d+e[h]:e[h])}return b},"string"===typeof f))if(g=isNaN(g)?"1":String(g),c=c||!1,d.events=window.apl(d.events,f),d.products){var l=d.products.split(","),m=l.length;c=c?0:m-1;for(var b;c<m;c++)b=l[c].split(";"),b[4]&&-1<b[4].indexOf("event")?b[4]=b[4]+"|"+f+"="+g:b[5]?b[4]=f+"="+g:b[4]||(b[3]||(b[3]=""),b[2]||(b[2]=""),b[1]||(b[1]=""),b[4]=f+"="+g),l[c]=b.join(";");d.products=l.join(",")}else d.products=";;;;"+f+"="+g};
/******************************************** END CODE TO DEPLOY ********************************************/

使用此插件

addProductEvent 方法使用以下参数：

• en（必需，字符串）：要添加到 products 变量中最后一个条目的事件。如果 products 变量为空，则会创建一个“空白”产品条目，并附加事件（及其值）。
• ev（必需，字符串）：分配给 en 参数中的数值或货币事件的值。如果未设置，则默认为 1。
• ap（可选，布尔值）：如果产品变量当前包含多个产品条目，则值为 true（或 1）会将事件添加到所有产品条目。如果未设置，则默认为 false。

addProductEvent 不会返回任何结果。而是将事件及其值添加到 products 变量。该插件还会自动将事件添加到 events 变量中，因为此变量也需要该事件。

Cookie

addProductEvent 插件不会创建或使用任何 Cookie

示例调用

示例 1

以下代码会将 s.products 变量设置为 ";product1;3;300,;product2;2;122,;product3;1;25;event35=25"。

s.products=";product1;3;300,;product2;2;122,;product3;1;25"
s.events="purchase";
s.addProductEvent("event35", "25");

上述代码还会将 s.events 变量设置为 "purchase,event35"

示例 2

以下代码会将 s.products 变量设置为 ";product1;3;300;event35=25,;product2;2;122;event35=25,;product3;1;25;event35=25"

s.products=";product1;3;300,;product2;2;122,;product3;1;25";
s.addProductEvent("event35", 25, 1);

如果 addProductEvent 调用中的第三个参数是 true（或 1），则每个产品条目会将调用中指定的事件添加到其值中。

示例 3

以下代码会将 s.products 变量设置为 ";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25;event33= 12|event34=10|event35=15"

s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25";
s.events="purchase,event2";
s.addProductEvent("event33", "12");
s.addProductEvent("event34", "10");
s.addProductEvent("event35", "15");

上述代码还会将 s.events 变量设置为 "purchase,event2,event33,event34,event35"

示例 4

以下代码会将 s.products 变量设置为 ";product1;3;300;event2=10|event33=12|event34=10|event35=15;eVar33=large|eVar34=men|eVar35=blue, ;product2;2;122;event33=12|event34=10|event35=15,;product3;1;25;event33=12|event34=10|event35=15"

s.products=";product1;3;300;event2=10;eVar33=large|eVar34=men|eVar35=blue,;product2;2;122,;product3;1;25"
s.events="purchase,event2"
s.addProductEvent("event33", "12", 1);
s.addProductEvent("event34", 10, 1);
s.addProductEvent("event35", "15", 1);

上述代码还会将 s.events 变量设置为 "purchase,event2,event33,event34,event35"。

示例 5

如果尚未设置 s.products，以下代码会将其设置为 ";;;;event35=25"

s.addProductEvent("event35", "25");

上述代码还会将 "event35" 附加到 s.events 末尾，或者，如果尚未设置 s.events，上述代码会将 s.events 设置为 "event35"

版本历史记录

2.0（2021 年 3 月 19 日）

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

1.0（2019 年 10 月 7 日）

• 第一版。