首页 AI Codex 協助把 TikTok 舊版手動廣告遷移到 Upgraded Smart+(2027-01-01 變更):受影響介面、盤點腳本與遷移清單

Codex 協助把 TikTok 舊版手動廣告遷移到 Upgraded Smart+(2027-01-01 變更):受影響介面、盤點腳本與遷移清單

TikTok 宣布 2027-01-01 起舊版建立介面不再支援銷售、應用推廣與名單蒐集目標的非搜尋 Legacy Manual 廣告活動。本文說明受影響範圍,並示範用 Codex 盤點程式碼、產生遷移清單與 Smart+ 改寫。

最後更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文件皆於當天查閱)

TikTok API for Business 文件頂部有一則重要公告:自 2027 年 1 月 1 日起,/campaign/create/、/campaign/copy/task/create/、/adgroup/create/、/ad/create/ 與 /ad/aco/create/ 將不再支援為銷售、應用推廣與名單蒐集目標建立或複製非搜尋的舊版手動(Legacy Manual)廣告活動,也不能在其下建立廣告組或廣告,請盡快遷移到 Upgraded Smart+ API(TikTok 公告)。

如果你的團隊有自建工具、排程腳本或第三方系統在用這些介面,現在就該盤點。這正是 Codex 擅長的工作:讀程式碼、找呼叫點、提出改寫並補測試。

受影響的介面

介面2027-01-01 起的變化
/campaign/create/不再建立非搜尋 Legacy Manual 廣告活動(銷售、應用推廣、名單蒐集)
/campaign/copy/task/create/不再複製上述廣告活動
/adgroup/create/不再於上述廣告活動下建立廣告組
/ad/create/不再於上述廣告活動下建立廣告
/ad/aco/create/不再於上述廣告活動下建立 ACO 廣告
建議替代Upgraded Smart+ 介面(/smart_plus/…)
TikTok 2027-01-01 起受影響的舊版建立介面表

另外,Smart+ 建立文件也提到:自 2026 年 9 月底起,API 不再支援建立非 CBO 的 App Install 價值最佳化(VBO)廣告活動(Create an Upgraded Smart+ campaign)。

用 Codex 盤點

盤點項目Codex 怎麼找遷移做法
直接呼叫舊介面搜尋程式碼中的路徑字串改用 smart_plus 對應介面
目標類型找 objective_type 為銷售、應用推廣、名單蒐集對照 Smart+ 的 WEB_CONVERSIONS/APP_PROMOTION/LEAD_GENERATION
搜尋廣告區分 Search 與非 Search搜尋廣告不在此次限制內,仍需確認
預設狀態檢查是否依賴 ENABLE 預設明確傳 operation_status = DISABLE
重試邏輯檢查是否有 request_id加入 request_id 冪等
Codex 盤點 TikTok 舊版廣告程式碼的項目與遷移做法表
# 給 Codex 的任務(在 workspace-write 沙盒、關閉網路下執行)
讀 AGENTS.md。在本倉庫中:
1. 找出所有呼叫 /campaign/create/、/campaign/copy/task/create/、/adgroup/create/、
   /ad/create/、/ad/aco/create/ 的位置,列出檔案、函式與 objective_type。
2. 標記哪些屬於非搜尋的銷售、應用推廣、名單蒐集(2027-01-01 起受影響)。
3. 產生 MIGRATION.md:每個呼叫點的 Smart+ 對應介面、需要補的欄位、風險。
4. 先不要改程式碼。

codex exec 預設在唯讀沙盒中執行,適合這類盤點;需要修改時改用 workspace-write 並保持網路關閉(Codex 審批與安全)。

改寫成 Smart+

Smart+ 建立廣告活動的必填欄位與預設值:operation_status 預設 ENABLE(請傳 DISABLE)、request_id 為 64 位整數字串、WEB_CONVERSIONS 需要 sales_destination。Python 範例:

# create_smart_plus.py - Upgraded Smart+ campaign, created switched OFF
import os, random, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
H = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"], "Content-Type": "application/json"}

def new_request_id():
    return str(random.getrandbits(63))       # string of a 64-bit int; reuse on retry

def create_campaign(advertiser_id, name, daily_budget, request_id=None):
    body = {
        "advertiser_id": advertiser_id,
        "request_id": request_id or new_request_id(),
        "objective_type": "WEB_CONVERSIONS",
        "sales_destination": "WEBSITE",       # required for WEB_CONVERSIONS
        "campaign_name": name,
        "operation_status": "DISABLE",        # default is ENABLE - never rely on it
        "budget_optimize_on": True,
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "budget": float(daily_budget),        # account currency units
    }
    r = requests.post(f"{BASE}/smart_plus/campaign/create/", headers=H, json=body, timeout=60).json()
    if r["code"] != 0:
        raise RuntimeError(f'{r["code"]} {r["message"]} request_id={body["request_id"]}')
    return r["data"]

完整的英文管線(含重試與測試)見 Codex + TikTok Marketing API pipeline(英文)。

遷移步驟

  1. 盤點:Codex 產出 MIGRATION.md,人工確認範圍。
  2. 改寫:逐一改成 Smart+ 介面,補單元測試(模擬 API,不打正式環境)。
  3. 試點:在單一自有帳戶以 DISABLE 建立,投手在後台檢查設定。
  4. 切換:確認無誤後全面切換,舊程式碼保留到 2027 年初再移除。
  5. 監控:上線後兩週每天比對報表,必要時調整。

Smart+ 新功能(例如流量廣告的促銷優惠)見 TikTok Smart+ 流量广告「促销优惠」上线;GMV Max 的自動化見 GMV Max「Growth Autopilot」怎么用。

熊貓出海如何用 Claude、Codex 與 TikTok 廣告帳戶幫客戶提升投放效率

本文主角是 Codex,但在實際服務中,熊貓出海會把 Claude、Codex 與 TikTok 廣告帳戶組合使用,協助出海企業更快跑完「開戶與像素/事件 → 建立 Smart+ 廣告活動 → 素材上傳與預審 → 看報表與診斷 → 調整預算與規則」這套重複工作,讓投手把時間留給素材策略、出價判斷與放量節奏。

  • 廣告帳戶:使用企業自有的 TikTok 海外戶;需要產業准入(如遊戲、金融等)時依 TikTok 政策申請加白戶;也可透過授權代理商開通海外代理戶。所有帳戶以企業真實主體開通、歸企業使用,不出租、不共享,多帳戶透過企業自己的商務中心(BC)管理。
  • Claude:透過 TikTok 官方 TikTok for Business MCP Server 以自然語言查報表、呼叫官方診斷代理、整理素材與 Smart+ 建立方案,寫入類工具一律先確認再執行。
  • Codex:撰寫與維護 Marketing API v1.3 的 Python 腳本(報表拉取、限流重試、以 DISABLE 狀態批次建立 Smart+、request_id 冪等),在沙盒中執行並接入排程。
  • 人工把關:開啟投放、提高預算、變更出價皆由投手審核後執行;素材與到達網頁是否符合 TikTok 廣告政策由人工最終確認。

這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 TikTok、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 TikTok 廣告開戶與代操(熊貓出海服務頁)。

常見問題

搜尋廣告也受影響嗎?

公告針對非搜尋(non-Search)的舊版手動廣告活動;搜尋廣告不在此範圍,但仍建議關注官方後續公告。

已經在跑的舊版廣告活動會被關掉嗎?

公告說明的是建立與複製的限制;既有廣告活動的處理請以 TikTok 官方後續說明為準。

用 MCP 的話也要遷移嗎?

MCP 工具也是封裝同一批 API;請讓 AI 直接使用 smart_plus_* 工具建立。

熊貓出海能幫忙遷移嗎?

我們可以協助盤點與規劃,並提供 Claude/Codex 自動化流程設計;程式碼由你的團隊審核後上線。

合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的 TikTok 廣告帳戶(含商務中心 BC 中指派給你的帳戶),透過 TikTok 官方 TikTok API for Business、TikTok for Business MCP Server 或 TikTok 廣告管理平台接入,遵守 TikTok 廣告政策、產業准入要求與 API 限流,並在任何會產生花費的動作前保留人工審核。TikTok 海外戶、加白戶、海外代理戶都應由廣告主以真實主體與資格開通、歸廣告主使用;熊貓出海不販售、出租、共享或轉讓廣告帳戶、BC 或 API 憑證,不協助規避廣告審查、產業准入、地區限制或身分驗證,也不是 TikTok、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。

延伸閱讀

聯絡熊貓出海:TikTok 廣告開戶 + AI 自動化投放

請告訴我們公司登記地、產業(是否需要產業准入/加白)、目標國家、到達網頁/App/TikTok Shop 連結與預估月預算,以及想先自動化哪一段(報表、素材、Smart+ 建立廣告活動或規則)。我們先做資格與素材預審,再協助企業合規開通 TikTok 海外戶、加白戶或海外代理戶,並把 Claude / Codex 接入你的投放流程。

WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

熊貓出海 WeChat QR 微信:szcwh99

官方來源

以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/codex-tiktok-legacy-to-smart-plus-migration-2027-zh-tw.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部