TikTok非中國(guó)區(qū)OpenAPI常見(jiàn)問(wèn)題

公共問(wèn)題

請(qǐng)求接口，報(bào)錯(cuò)：XXXX：Missing data for required field

答：必填字段“XXXX” 沒(méi)有被傳入請(qǐng)求參數(shù)，導(dǎo)致報(bào)錯(cuò)。需要您檢查自己的代碼問(wèn)題，調(diào)整代碼，重新調(diào)用接口。

請(qǐng)求接口，報(bào)錯(cuò)：Access token is invalid, when you call access_token or refresh_token api, old token will become invalid.

答：access token 過(guò)期或者是不存在的，需要您使用最新的正確的access token,調(diào)用接口。

請(qǐng)求接口，報(bào)錯(cuò)：Advertiser XXXXX doesn't exist or has been deleted

答：需要用戶(hù)檢查填寫(xiě)的advertiser_id是否正確

請(qǐng)求接口，報(bào)錯(cuò)：No permission to operate advertiser XXXXXXXXX

答：無(wú)權(quán)限操作對(duì)應(yīng)的advertiser_id, 即使用錯(cuò)了access token，需要填寫(xiě)與廣告主對(duì)應(yīng)的access token.

請(qǐng)求接口，報(bào)錯(cuò)：advertiser does no grant you XXXX permission

答：XXXX表示權(quán)限點(diǎn)，也就接口權(quán)限。遇到此問(wèn)題時(shí)需要。需要先確認(rèn) ，開(kāi)發(fā)者的應(yīng)用APPID是否包括此接口權(quán)限，如果沒(méi)有，您需要在雅典娜上提應(yīng)用申請(qǐng)權(quán)限的工單（https://ads.tiktok.com/athena/index.html?key=b25033ef7782d41050cbac74f751d547e9d8ad35a39a541a0f0efbbd51fe722f#/），申請(qǐng)通過(guò)后，然后讓廣告主重新授權(quán)，且授權(quán)鏈接的scope中包括XXXX權(quán)限。如果開(kāi)發(fā)者應(yīng)用有此接口權(quán)限，可以直接讓廣告主重新授權(quán)，且授權(quán)鏈接的scope中包括XXXX權(quán)限。

請(qǐng)求接口，報(bào)錯(cuò)：App has been blocked or app is not exist

答：填寫(xiě)app id有誤，需要重新檢查，填寫(xiě)正確的app id

oauth授權(quán)

訪問(wèn)授權(quán)鏈接URL, 頁(yè)面報(bào)：RedirectUrlNotMatch

答：授權(quán)鏈接中的redirect_uri與對(duì)應(yīng)的APP回調(diào)地址不一致，需要將前者重置為后者相同。

同意授權(quán)后，跳轉(zhuǎn)到回調(diào)地址頁(yè)面，頁(yè)面顯示報(bào)錯(cuò)

答：回調(diào)地址頁(yè)面的報(bào)錯(cuò)，屬于回調(diào)地址代碼的問(wèn)題，需要用戶(hù)確認(rèn)自身代碼問(wèn)題

調(diào)用獲取access token接口，報(bào)錯(cuò)：Invalid auth code

答：auth code過(guò)期了，需要重新授權(quán)獲取新的auth code

調(diào)用接口，報(bào)錯(cuò)：Illegal access partner

答：app_id 與secret 兩者對(duì)應(yīng)關(guān)系不一致，比如填寫(xiě)的secret錯(cuò)誤

調(diào)用刷新 access token 接口，報(bào)錯(cuò)：The refresh token has expired.

答： refresh token過(guò)期，需要使用最新的refresh token，或者重新授權(quán)

調(diào)用刷新 access token 接口，報(bào)錯(cuò)：Invalid refresh_token：XXXXXXXXX

答：填寫(xiě)的refresh token無(wú)效

廣告管理

推廣系列

獲取campaign列表，返回的數(shù)據(jù)不全

答：campaign/get 接口默認(rèn)不查詢(xún)刪除的數(shù)據(jù)，如果想要獲取刪除的數(shù)據(jù)，可以在filtering中傳primary_status為STATUS_DELETE。

廣告組

獲取adgroup列表，返回的數(shù)據(jù)不全

答：adgroup/get 接口默認(rèn)不查詢(xún)刪除的數(shù)據(jù)，如果想要獲取刪除的數(shù)據(jù)，可以在filtering中傳primary_status為STATUS_DELETE。

創(chuàng)建adgroup時(shí)，報(bào)錯(cuò)：The selected placement does not support the current region targeting.

答： 所選的廣告位不支持當(dāng)前的選擇的location定向，需要重新調(diào)整。

創(chuàng)建adgroup時(shí)，報(bào)錯(cuò)：Please select a Pixel.

答：對(duì)于推廣目的選擇CONVERSIONS或者TRAFFIC，且推廣目的為落地頁(yè)時(shí)，需要傳 Pixel id，具體可以查看 Pixel 管理模塊的文檔。

創(chuàng)建adgroup時(shí)，報(bào)錯(cuò)：The selected App does not have a tracking link to track events

答：當(dāng)優(yōu)化目標(biāo)optimize_goal為非click時(shí)，需要設(shè)置app 需要設(shè)置檢測(cè)鏈接以及相關(guān)事件。

創(chuàng)建adgroup時(shí)，報(bào)錯(cuò)：The optimization goal cannot be empty

答：optimize_goal 優(yōu)化目標(biāo)要求必傳

創(chuàng)建adgroup時(shí)，報(bào)錯(cuò)：Secondary goal only supports the standard bid.

答：深度優(yōu)化只支持標(biāo)準(zhǔn)出價(jià)

修改adgroup預(yù)算，單次修改的金額幅度不能少于10。

廣告

獲取ad列表，返回的數(shù)據(jù)不全

答：ad/get 接口默認(rèn)不查詢(xún)刪除的數(shù)據(jù)，如果想要獲取刪除的數(shù)據(jù)，可以在filtering中傳primary_status為STATUS_DELETE。

創(chuàng)建ad, 報(bào)錯(cuò)：The creative type is not consistent with the Ad Group type.

答：當(dāng)adgroup 的creative_material_mode 為custom時(shí)，只能創(chuàng)建自定義ad，反則創(chuàng)建程序化ad.

修改ad時(shí)，報(bào)錯(cuò)：These Ads do not support to pause because the status is In Review

答：新建審核中的ad,不能進(jìn)行disabe 操作

DMP 人群管理

上傳數(shù)據(jù)源文件，報(bào)錯(cuò)：file_signature error or file size exceeds limit

文件的實(shí)際的md5與傳入的file_signature不相同，需要重新傳入正確的文件的file_signature。注：每個(gè)開(kāi)發(fā)語(yǔ)言都有自己的MD5庫(kù)，可以直接用于獲取文件的md5。

廣告報(bào)表管理

報(bào)表公共問(wèn)題

拉去報(bào)表數(shù)據(jù)，能否獲得當(dāng)天的消耗數(shù)據(jù)

答：數(shù)據(jù)20分鐘更新一次，在于查看數(shù)據(jù)的時(shí)候時(shí)間如果不同可能剛好跨10分鐘更新的切片也不同，正常情況  8點(diǎn)——9點(diǎn)之間 的數(shù)據(jù) ，10點(diǎn)可以穩(wěn)定。在晚高峰的時(shí)候，可能需要3個(gè)小時(shí)能穩(wěn)定，即正常情況2小時(shí)，晚高峰3個(gè)小時(shí)。一般歷史數(shù)據(jù)查詢(xún)都不會(huì)變，除了數(shù)據(jù)有問(wèn)題有校對(duì)的情況會(huì)更新歷史數(shù)據(jù)，能保證7天數(shù)據(jù)不再變化。

campaign data

獲取的campaign 報(bào)表數(shù)據(jù)，返回字段中campaign_id以及campaign_name為null

答：group_by中需要傳STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].

獲取的消耗數(shù)據(jù)不全/不對(duì)

答：report/campaign/get,此接口默認(rèn)不查刪除的數(shù)據(jù)，如果想要查詢(xún)刪除的數(shù)據(jù)，可以在filteirng中相應(yīng)的primary status中的值，即"filtering":{"primary_status":"STATUS_DELETE"}

ad group data

獲取的adgroup 報(bào)表數(shù)據(jù)，返回字段中adgroup_id以及adgroup_name為null

答：group_by中需要傳STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].

獲取的消耗數(shù)據(jù)不全/不對(duì)

答：report/adgroup/get，此接口默認(rèn)不查刪除的數(shù)據(jù)，如果想要查詢(xún)刪除的數(shù)據(jù)，可以在filteirng中相應(yīng)的primary status中的值，即"filtering":{"primary_status":"STATUS_DELETE"}

ad data

獲取的ad 報(bào)表數(shù)據(jù)，返回字段中ad_id以及ad_name為null

答：group_by中需要傳STAT_GROUP_BY_FIELD_ID，即"group_by":["STAT_GROUP_BY_FIELD_ID"].

獲取的消耗數(shù)據(jù)不全/不對(duì)

report/ad/get， 報(bào)表接口默認(rèn)不查刪除的數(shù)據(jù)，如果想要查詢(xún)刪除的數(shù)據(jù)，可以在filteirng中相應(yīng)的primary status中的值，即"filtering":{"primary_status":"STATUS_DELETE"}

此接口存在一個(gè)5000個(gè)ad id截?cái)鄦?wèn)題 ：當(dāng)一次查詢(xún)的ad個(gè)數(shù)超過(guò)5000時(shí)，會(huì)只取前5000個(gè)ads，然后獲取這5000個(gè)ads的相關(guān)數(shù)據(jù)。然后通過(guò)聚合條件把聚合后的數(shù)據(jù)返回會(huì)給用戶(hù)。 目前建議通過(guò)過(guò)濾條件（比如通過(guò)campaign_id或者adgroup_id）使得一次查詢(xún)的ad個(gè)數(shù)少于5000個(gè)，循環(huán)累加消耗或者通過(guò)ad/get 列表接口獲取所有的ad id,然后一次傳100個(gè)ads,進(jìn)行累加獲取數(shù)據(jù)。