← 返回目录
📁 Marketing API › Ad Measurement › Guides › Events API 2.0

支持的事件

事件是指访客在你的网站上执行的操作,例如将一件商品加入购物车、填写一份表单或完成一次购买。

TikTok 支持两类事件: - 标准事件:具有 TikTok 创建的预定义名称的操作。标准事件在所有 TikTok 集成工具中均受支持,可用于报告、针对转化量进行优化和创建受众。有关支持的标准事件列表,请继续阅读下文。 - 自定义事件:TikTok 合作伙伴可以在预定义的标准事件列表之外自行定义的操作。自定义事件可以通过事件管理平台上的事件生成器进行设置,或直接通过 Pixel 和网站事件 API 报告。 自定义事件(目前仅支持自定义网站、应用事件和 CRM 事件)可用于报告和受众创建。目前不支持用于优化。 若想了解如何使用自定义事件,请查看标准事件和自定义事件。

网站标准事件

下表列出了所有的网站标准事件 (包括 event_source 设置为web时的线下事件),以及每种网站事件在properties对象中的推荐参数。需注意事件名区分大小写,因此请务必在/event/track/中的event参数使用事件列中显示的确切名称。

| 事件{25%} | 描述{20%}| <code>properties</code>对象中的推荐参数{55%} |
|---|---|---|
| `AddPaymentInfo` | 添加支付信息   | |
| `AddToCart` | 加入购物车 |`content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |
| `AddToWishlist` | 加入心愿单   |  |
| `ApplicationApproval` | 批准申请  |  |
| `CompleteRegistration` | 完成注册   | |
| `Contact` | 联系   | |
| `CustomizeProduct` | 定制商品   ||
| `Download` | 下载   | |
| `FindLocation` | 寻找位置   ||
| `InitiateCheckout`| 开始结账   | |
| `Lead` | 提交表单   | |
| `Purchase` | 支付完成 | `content_type`, `quantity`, `description`, `content_id`, `currency`, `value`  |
| `Schedule` | 预约   ||
| `Search` | 搜索   |  |
| `StartTrial` | 开始试用 | `currency`, `value`  |
| `SubmitApplication` | 提交申请 |  |
| `Subscribe` | 订阅   |  |
| `ViewContent` | 查看内容 | `content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |

线下标准事件

线下标准事件包含的事件与网站标准事件完全相同。

| 事件{25%} | 描述{20%}| <code>properties</code>对象中的推荐参数{55%} |
|---|---|---|
| `AddPaymentInfo` | 添加支付信息   | |
| `AddToCart` | 加入购物车 |`content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |
| `AddToWishlist` | 加入心愿单   |  |
| `ApplicationApproval` | 批准申请  |  |
| `CompleteRegistration` | 完成注册   | |
| `Contact` | 联系   | |
| `CustomizeProduct` | 定制商品   ||
| `Download` | 下载   | |
| `FindLocation` | 寻找位置   ||
| `InitiateCheckout`| 开始结账   | |
| `Lead` | 提交表单   | |
| `Purchase` | 支付完成 | `content_type`, `quantity`, `description`, `content_id`, `currency`, `value`  |
| `Schedule` | 预约   ||
| `Search` | 搜索   |  |
| `StartTrial` | 开始试用 | `currency`, `value`  |
| `SubmitApplication` | 提交申请 |  |
| `Subscribe` | 订阅   |  |
| `ViewContent` | 查看内容 | `content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |

应用标准事件

注意
用于事件追踪的事件名称(event字段)和广告组创建时使用的事件名称 (optimization_event字段)是不同的,请通过相应的列来获取正确的值。

| 用于事件追踪的事件名<br> (<code>event</code>字段的值) {20%}| 描述{20%} | <code>properties</code>字段中的推荐值 {30%} | 对应广告组创建时使用的事件<br>(<code>optimization_event</code>字段的值){30%} |
|---|---|---|---|
| `AchieveLevel` | 达到级别   |  | `UPDATE_LEVEL` |
| `AddPaymentInfo` | 添加支付信息     |  | `ADD_PAYMENT_INFO` |
| `AddToCart` | 加入购物车    |`content_type`, `content_id`, `description`, `currency`, `value` | `IN_APP_CART` |
| `AddToWishlist` | 加入心愿单 | `content_type`, `content_id`, `description`, `currency`, `value` | `ADD_TO_WISHLIST` |
| `Checkout` | 结账 | `content_type`, `content_id`, `description`, `currency`, `value` | `IN_APP_ORDER` |
| `CompleteTutorial` | 完成教程   |  | `COMPLETE_TUTORIAL` |
| `CreateGroup` | 创建组   |  | `CREATE_GROUP` |
| `CreateRole` | 创建角色   | |  `CREATE_GAMEROLE` |
| `GenerateLead` | 收集线索   |  | `SALES_LEAD` |
| `InAppADClick` | 应用内广告点击  |   | `IN_APP_AD_CLICK` |
| `InAppADImpr` | 应用内广告展示  |   | `IN_APP_AD_IMPR` |
| `InstallApp` | 应用安装  |  | `ACTIVE` |
| `JoinGroup` | 加入组  |   | `JOIN_GROUP` |
| `LaunchAPP` | 启动应用  |  | `LAUNCH_APP` |
| `LoanApplication` | 贷款申请  |   | `LOAN_APPLY` |
| `LoanApproval` | 贷款批准  |   | `LOAN_CREDIT` |
| `LoanDisbursal` | 贷款发放|    | `LOAN_COMPLETION` |
| `Login` | 登陆  |   | `LOGIN` |
| `Purchase` | 购买 | `content_type`, `content_id`, `description`, `currency`, `value` | `ACTIVE_PAY` |
| `Rate` | 评分|    | `RATE` |
| `Registration` | 注册  |   | `ACTIVE_REGISTER` |
| `Search` | 搜索  |   | `SEARCH` |
| `SpendCredits` | 花费点数  |   | `SPEND_CREDITS` |
| `StartTrial` | 开始试用|    | `START_TRIAL` |
| `Subscribe` | 订阅  |   | `SUBSCRIBE` |
| `UnlockAchievement` | 解锁关卡  |  | `UNLOCK_ACHIEVEMENT` |
| `ViewContent` | 查看内容 | `content_type`, `content_id`, `description`, `currency`, `value` | `IN_APP_DETAIL_UV` |

CRM 标准事件

支持的 CRM 标准事件与支持的网站标准事件相同。

| 事件{25%} | 描述{20%}| <code>properties</code>对象中的推荐参数{55%} |
|---|---|---|
| `AddPaymentInfo` | 添加支付信息   | |
| `AddToCart` | 加入购物车 |`content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |
| `AddToWishlist` | 加入心愿单   |  |
| `ApplicationApproval` | 批准申请  |  |
| `CompleteRegistration` | 完成注册   | |
| `Contact` | 联系   | |
| `CustomizeProduct` | 定制商品   ||
| `Download` | 下载   | |
| `FindLocation` | 寻找位置   ||
| `InitiateCheckout`| 开始结账   | |
| `Lead` | 提交表单   | |
| `Purchase` | 支付完成 | `content_type`, `quantity`, `description`, `content_id`, `currency`, `value`  |
| `Schedule` | 预约   ||
| `Search` | 搜索   |  |
| `StartTrial` | 开始试用 | `currency`, `value`  |
| `SubmitApplication` | 提交申请 |  |
| `Subscribe` | 订阅   |  |
| `ViewContent` | 查看内容 | `content_type`, `quantity`,`description`,`content_id`,`currency`,`value` |

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →