常见问题

本文总结了使用推广系列管理API时的常见问题。

广告组

Q1: 我在创建推广系列的接口（例如，/adgroup/create/）中规定了app_id，但得到报错 "DB record not found"。为什么会发生这种情况？
请检查您所使用的app_id。您在请求中指定的app_id应为移动应用ID，而不是您在开发者门户网站上可以找到的API应用ID。移动应用ID被添加至您计划推广的事件管理平台下的广告账户中。

Q2: 如何为价值优化创建广告组？
请参考价值优化，了解如何开启价值优化。

Q3: 如何通过API设置兴趣和行为定向？
请使用以下接口来设置兴趣和行为的定向选项。 - 兴趣定向： - /tool/interest_category/ : 获取可用的兴趣分类。 - /tool/interest_keyword/recommend/: 获取推荐兴趣关键词。 - /tool/interest_keyword/get/ : 通过ID获取可用的兴趣关键词。 - 与视频互动： - /tool/action_category/ : 获取可用的与视频互动的分类（返回中action_scene = VIDEO_RELATED）。 - /tool/targeting_category/recommend/ : 获取推荐的与视频互动的分类（返回中scene = VIDEO_RELATED）。 - 与创作者互动： - /tool/action_category/ : 获取可用的与创作者互动的分类（返回中action_scene = CREATOR_RELATED）。 - /tool/targeting_category/recommend/ : 获取推荐的与创作者互动的分类（返回中scene = CREATOR_RELATED）。 - 标签互动： - /tool/hashtag/recommend/ : 获得推荐的标签。 - /tool/hashtag/get/ : 通过关键词ID获取话题标签。

Q1: 在调用/ad/create/接口时，我收到一条报错信息 "The creative type is not consistent with your ad group settings. Please change the creative type in your ad group settings."。
收到该报错信息的原因是您的广告组已启用程序化创意（ACO）（creative_material_mode = DYNAMIC），但您使用了/ad/create/这一常规的广告创建接口来创建ACO广告。要解决这个问题，您应该使用/ad/aco/create/来创建ACO广告。

Q2: 在调用/ad/create/接口时，我收到一条报错信息 "Unsupported image size. Please upload another image"。为什么会出现这个报错？
您的图片不符合我们的要求。请参考图片广告规格或视频广告规格了解更详细规格。

Q3: 在调用/identity/video/get/接口时，我收到一条报错信息 "Invalid identity type"。为什么会出现这个报错？
这可能是由于传入了CUSTOMIZED_USER作为identity_type。/identity/video/get/接口不支持CUSTOMIZED_USER，支持的身份类型是AUTH_CODE、TT_USER和BC_AUTH_TT。
目前有四种类型的认证身份。AUTH_CODE、TT_USER和BC_AUTH_TT这三种身份类型没有video_id，但有与之关联的tiktok_item_id。若您想创建Spark Ads，您应该使用这三种类型。第四种身份类型CUSTOMIZED_USER有video_id，这意味着您的广告正使用上传到广告管理平台创意库的视频。请参考认证身份了解更多信息。

其他

Q1: 我注意到一些参数没有出现在返回中，或者被请求忽略，为什么会发生这种情况？
其中一个可能的原因是您使用的是v1.2版本的语法，但调用的是v1.3版本的API接口。
在v1.3版本API中，我们已经更新了参数名称和类型，使其更加清晰并符合行业标准。例如，在v1.3版本中，placement 被重新命名为placements，若您在/v1.3/adgroup/create/接口中仍然使用placement作为请求参数，该参数将被忽略。请参考每篇API接口文档中的 "v1.2与v1.3版本对比 "表格，查看详细的变化。