TikTok非中国区OpenAPI常见问题
公共问题
请求接口，报错：XXXX：Missing data for required field
答：必填字段“XXXX” 没有被传入请求参数，导致报错。需要您检查自己的代码问题，调整代码，重新调用接口。
请求接口，报错：Access token is invalid, when you call access_token or refresh_token api, old token will become invalid.
请求接口，报错：Access token is invalid, when you call access_token or refresh_token api, old token will become invalid.
答：access token 过期或者是不存在的，需要您使用 新的正确的access token,调用接口。
请求接口，报错：Advertiser XXXXX doesn't exist or has been deleted
答：需要用户检查填写的advertiser_id是否正确
请求接口，报错：No permission to operate advertiser XXXXXXXXX
答：无权限操作对应的advertiser_id, 即使用错了access token，需要填写与广告主对应的access token.
请求接口，报错：advertiser does no grant you XXXX permission
请求接口，报错：App has been blocked or app is not exist
答：填写app id有误，需要重新检查，填写正确的app id
oauth授权
访问授权链接URL, 页面报：RedirectUrlNotMatch
同意授权后，跳转到回调地址页面，页面显示报错
答：回调地址页面的报错，属于回调地址代码的问题，需要用户确认自身代码问题
调用获取access token接口，报错：Invalid auth code
答：auth code过期了，需要重新授权获取新的auth code
调用接口，报错：Illegal access partner
答：app_id 与secret 两者对应关系不一致，比如填写的secret错误
调用刷新 access token 接口，报错：The refresh token has expired.
答： refresh token过期，需要使用 新的refresh token，或者重新授权
调用刷新 access token 接口，报错：Invalid refresh_token：XXXXXXXXX
答：填写的refresh token无效
广告管理
推广系列
获取campaign列表，返回的数据不全
答：campaign/get 接口默认不查询删除的数据，如果想要获取删除的数据，可以在filtering中传primary_status为STATUS_DELETE。
广告组
获取adgroup列表，返回的数据不全
答：adgroup/get 接口默认不查询删除的数据，如果想要获取删除的数据，可以在filtering中传primary_status为STATUS_DELETE。
创建adgroup时，报错：The selected placement does not support the current region targeting.
答： 所选的广告位不支持当前的选择的location定向，需要重新调整。
创建adgroup时，报错：Please select a Pixel.
答：对于推广目的选择CONVERSIONS或者TRAFFIC，且推广目的为落地页时，需要传 Pixel id，具体可以查看 Pixel 管理模块的文档。
创建adgroup时，报错：The selected App does not have a tracking link to track events
答：当优化目标optimize_goal为非click时，需要设置app 需要设置检测链接以及相关事件。
创建adgroup时，报错：The optimization goal cannot be empty
答：optimize_goal 优化目标要求必传
创建adgroup时，报错：Secondary goal only supports the standard bid.
答：深度优化只支持标准出价
修改adgroup预算，单次修改的金额幅度不能少于10。
广告
获取ad列表，返回的数据不全
答：ad/get 接口默认不查询删除的数据，如果想要获取删除的数据，可以在filtering中传primary_status为STATUS_DELETE。
创建ad, 报错：The creative type is not consistent with the Ad Group type.
答：当adgroup 的creative_material_mode 为custom时，只能创建自定义ad，反则创建程序化ad.
修改ad时，报错：These Ads do not support to pause because the status is In Review
答：新建审核中的ad,不能进行disabe 操作
DMP 人群管理
上传数据源文件，报错：file_signature error or file size exceeds limit
文件的实际的md5与传入的file_signature不相同，需要重新传入正确的文件的file_signature。注：每个开发语言都有自己的MD5库，可以直接用于获取文件的md5。
广告报表管理
报表公共问题
拉去报表数据，能否获得当天的消耗数据
答：数据20分钟更新一次，在于查看数据的时候时间如果不同可能刚好跨10分钟更新的切片也不同，正常情况 8点——9点之间 的数据 ，10点可以稳定。在晚高峰的时候，可能需要3个小时能稳定，即正常情况2小时，晚高峰3个小时。一般历史数据查询都不会变，除了数据有问题有校对的情况会更新历史数据，能保证7天数据不再变化。
campaign data
获取的campaign 报表数据，返回字段中campaign_id以及campaign_name为null
答：group_by中需要传STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].
获取的消耗数据不全/不对
回答：report/campaign/get，这个界面默认不查删除数据，如果想查询删除数据，可以在filteirng中查询相应的primarystatus值，即“filtering”：{"primary_status"："STATUS_DELETE"}
ad group data
获取的adgroup 报表数据，返回字段中adgroup_id以及adgroup_name为null
答：group_by中需要传STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].
获取的消耗数据不全/不对
回答：report/adgroup/get，这个界面默认不查删除数据，如果想查询删除数据，可以在filteirng中查询相应的primarystatus中的值，即“filtering”：{"primary_status"："STATUS_DELETE"}
ad data
获取的ad 报表数据，返回字段中ad_id以及ad_name为null
答：group_by中需要传STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].
获取的消耗数据不全/不对
report/ad/get、报告界面默认不查删除的数据，如果想查询删除的数据，可以在filteirng中对应的primarystatus值，即“filtering”:{"primary_status":"STATUS_DELETE"}
此接口存在一个5000个ad id截断问题 ：当一次查询的ad个数超过5000时，会只取前5000个ads，然后获取这5000个ads的相关数据。然后通过聚合条件把聚合后的数据返回会给用户。 目前建议通过过滤条件（比如通过campaign_id或者adgroup_id）使得一次查询的ad个数少于5000个，循环累加消耗或者通过ad/get 列表接口获取所有的ad id,然后一次传100个ads,进行累加获取数据。
This interface has a truncation problem of 5000 ad IDS: when the number of ads in a query exceeds 5000, only the first 5000 ads will be taken, and then the relevant data of the 5000 ads will be obtained. Then the aggregated data is returned to the user through the aggregation condition. At present, it is recommended to use the filter conditions (for example, through campaign)_ ID or ad group_ Make the number of ads in a query less than 5000, cycle accumulation consumption or get all the ad IDS through the ad / get list interface, and then transfer 100 ads at a time for accumulation to get data.
