自定义事件

任务：找出最常被加入收藏的商品类别。

事件：product_added_to_favorites。

何时发送：在商品成功加入收藏后发送一次。 如果添加失败或商品已在收藏中，则不发送事件。

参数：

• product_id — 商品标识符，字符串。 例如，sneakers_042。
• category — 商品类别，字符串。 例如，shoes、clothing 或 accessories。
• source — 商品添加来源，字符串：catalog — 从目录或 product_card — 从商品卡片。

如何检查：从商品卡片将运动鞋加入收藏。 预期结果是一个 product_added_to_favorites 事件，参数为 product_id: sneakers_042、category: shoes 和 source: product_card。

custom-developer-zh.txt

如何通过 SDK 发送

开发者在发生所选操作的代码位置添加 SDK 方法调用。 使用平台的说明：

• Android
• iOS
• Flutter
• React Native
• Unity

如何从服务器发送

如果操作信息在服务器上可用，请使用通过 Post API 上传事件。 数据通过 HTTP 请求传输，并与之前通过 SDK 传输的个人资料或设备标识符关联。

在配置之前，请检查上传限制。 Post API 数据每四小时同步一次 — 检查时请考虑这一点。

事件嵌套级别

要发送包含嵌套参数的事件，请传递 key:value 对。 在界面中，key 和 value 被视为嵌套级别。

以 JSON 格式传递参数时，值中的每个新对象表示一个新的嵌套级别，例如：

{
"param1":"1",  // 嵌套级别 1
"param2":"abc",
"param3": { 
	"paramLevel2": "2", // 嵌套级别 2
	"param2Level2": {
		"paramLevel3": "3", // 嵌套级别 3
		"param2Level3":{
			"level": "4" // 嵌套级别 4
      }
    }
  }
}

AppMetrica 网页界面显示事件最多五级嵌套。 如果事件有六级或更高级别，报告中只显示前五级。

数值和字符串值的解释

在AppMetrica界面中，值{"count" : 3}和{"count" : "3"}被以相同方式解释。 但是，在使用报告 API或日志 API导出数据时，参数会以发送到服务器时的相同形式导出。

如果同一个事件多次传递不同的数值参数，网页界面不会对参数值进行聚合。 每个值都单独记录和计算。

部分匹配的嵌套事件

您可以为同一事件传递不同的参数值。

如果服务器接收到具有重复参数的事件，其值会被累积，报告中会显示每个传递变体的数量。

如果服务器接收到参数重复但嵌套深度不同的事件，则会根据重复的参数将它们的值相加。

例如，第一个事件有两个嵌套级别：

{
    "param1": "param2"
}

第二个有三级嵌套：

{
    "param1": {
        "param2": "value"
    }
}

在网页界面中，这些事件以树形结构显示：

事件按以下算法进行计数：

1. 事件已被记录，包括其两个子级。 每个参数都加上1。
2. 事件名称和其三个子级别中添加了1。