TikTok非中國區(qū)OpenAPI常見問題

公共問題

請求接口，報錯：XXXX：Missing data for required field

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

請求接口，報錯：Access token is invalid, when you call access_token or refresh_token api, old token will become invalid.

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

請求接口，報錯：Advertiser XXXXX doesn't exist or has been deleted

答：需要用戶檢查填寫的advertiser_id是否正確

請求接口，報錯：No permission to operate advertiser XXXXXXXXX

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

請求接口，報錯：advertiser does no grant you XXXX permission

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

請求接口，報錯：App has been blocked or app is not exist

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

oauth授權(quán)

訪問授權(quán)鏈接URL, 頁面報：RedirectUrlNotMatch

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

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

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

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

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

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

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

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

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

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

答：填寫的refresh token無效

廣告管理

推廣系列

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

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

廣告組

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

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

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

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

創(chuàng)建adgroup時，報錯：Please select a Pixel.

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

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

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

創(chuàng)建adgroup時，報錯：The optimization goal cannot be empty

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

創(chuàng)建adgroup時，報錯：Secondary goal only supports the standard bid.

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

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

廣告

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

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

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

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

修改ad時，報錯：These Ads do not support to pause because the status is In Review

答：新建審核中的ad,不能進行disabe 操作

DMP 人群管理

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

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

廣告報表管理

報表公共問題

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

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

campaign data

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

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

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

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

ad group data

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

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

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

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

ad data

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

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

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

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

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