使用诊断数据排查商品库问题
本文介绍了使用诊断数据排查商品库商品和数据源问题（包括商品库匹配率）的详细步骤。商品库诊断功能可帮助您识别并解决商品库中商品的问题，以及与商品库绑定的事件源的问题。
若想了解商品库管理工具中商品库商品和事件源的诊断功能在 API 中的对应配置，请查看商品库管理工具的商品库诊断功能与 API 配置间的映射。
排查商品库商品问题
前提条件
确保您已在商品库中添加了商品。若想了解相关步骤，请查看创建商品库并添加商品。
步骤
- 使用以下任意模式获取商品库商品的诊断信息：
- 同步模式：使用/diagnostic/catalog/同步获取详细的商品库诊断信息。
- 异步模式：
- 使用/diagnostic/catalog/product/task/create/创建较笼统的商品库诊断信息的异步下载任务。
- 随后使用/diagnostic/catalog/product/task/get/下载包含诊断信息的 CSV 文件。
- 若商品库诊断信息显示商品库中存在问题，您可使用/catalog/product/update/更新商品，从而解决这些问题。
排查商品库商品问题及商品库匹配率
商品库匹配率指的是能用内容 ID 属性与您的商品库中 SKU ID 相匹配的共享信号事件的百分比。我们建议您将匹配率保持在 90% 以上，以确保视频购物广告获得理想的投放效果。如果系统无法在内容 ID 和 SKU ID 之间进行精确匹配，就会依据其他商品库属性来决定广告内容的投放。
前提条件
确保您已通过/catalog/eventsource/bind/或在 TikTok 广告管理平台将事件源与商务中心中的商品库绑定。若想了解在 TikTok 广告管理平台将事件源与商品库绑定的步骤，请查看如何创建和管理目录 - 关联事件源。
若想确认商品库是否绑定了事件源，可使用 /catalog/eventsource_bind/get/。
步骤
- 使用/diagnostic/catalog/eventsource/issue/获取与商品库绑定的事件源（App 或 Pixel）的诊断信息。
- 检测到的事件源的问题将通过
diagnostic_result字段返回。您可根据diagnostic_solution字段中提供的建议以及指南如何排查目录匹配率问题解决这些问题。 - 使用/diagnostic/catalog/eventsource/metric/获取商品库匹配率。
-
available_type为EVENT_WITH_CONTENT_ID_MATCHING_INVENTORY时返回的percentage字段的值即为商品库匹配率。需注意首次关联商品库和事件源时，匹配率可能需要数天时间才能趋于稳定。 - 此外，您还可识别从事件源接收到的应用事件或 Pixel 事件的趋势。 - 若未检测到事件源的问题，且商品库匹配率高于 90%，您可以使用该商品库创建视频购物广告，对与商品互动过的用户进行再营销。