Get MCP Ads
官方將Google Ads、Meta Ads、TikTok Ads、Pinterest Ads、Snapchat Ads、Search Console和GA4連接到您的AI助手,透過託管的MCP URL。選擇授權帳戶,免費方案提供唯讀存取,付費方案支援寫入操作的預覽與確認。
你可以用 Get Ads MCP 做什麼?
- 檢視 ChatGPT Ads 帳戶 — 使用
openai_ads_get_account讀取所選帳戶的名稱、貨幣、時區與審核狀態。 - 列出廣告活動與廣告群組 — 分頁瀏覽所選帳戶中的廣告活動或廣告群組,保留
has_more與last_id以供分頁。 - 提取成效洞察 — 依帳戶、廣告活動、廣告群組或廣告讀取投放指標,並可選擇依國家、裝置與平台細分。
- 預覽建立暫停中的廣告活動 — 草擬一個 ChatGPT Ads 廣告活動,該活動會保持暫停,直到另行啟用,並在套用任何變更前預覽。
- 比較 Adjust 期間 — 針對所選的單一 Adjust 應用程式,使用相同的指標與篩選條件比較兩個等長的期間。
- 執行 Adjust 報表 — 為所選的單一 Adjust 應用程式讀取歸因或成效報表,保留原生總計與警告。
託管 MCP 伺服器
npx add-mcp 'https://mcp.getmcpads.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
工具目錄
16 個已記錄來源中共有 696 個已實作工具。下方的來源存取說明決定了哪些工具可透過 https://mcp.getmcpads.com/mcp. 呼叫。
標記為 (write) 的工具會變更線上帳戶的內容。這些工具預設僅進行預覽:
若未提供 confirm: true,工具只會描述變更內容,不會實際套用。在 Free 方案上,寫入操作
會完全遭到拒絕。
工具僅會針對組織已勾選的帳戶作出回應。任何其他識別碼都會 遭到拒絕,包括底層連線原本可觸及的帳戶。
ChatGPT Ads(58 個工具,28 個寫入)
使用 Ads Manager 設定中的 Ads Management API 金鑰進行連線,然後選取已驗證的廣告帳戶。原生帳戶權限與功能資格適用。
openai_ads_activate_ad(寫入):預覽並確認原生 ChatGPT Ads 啟用廣告合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_activate_ad_group(寫入):預覽並確認原生 ChatGPT Ads 啟用廣告群組合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_activate_campaign(寫入):預覽並確認原生 ChatGPT Ads 啟用行銷活動合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_archive_ad(寫入):預覽並確認原生 ChatGPT Ads 封存廣告合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_archive_ad_group(寫入):預覽並確認原生 ChatGPT Ads 封存廣告群組合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_archive_campaign(寫入):預覽並確認原生 ChatGPT Ads 封存行銷活動合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_archive_feed(寫入):預覽並確認原生 ChatGPT Ads 封存動態饋送合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_ad(寫入):預覽並確認原生 ChatGPT Ads 建立廣告合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_ad_group(寫入):預覽並確認原生 ChatGPT Ads 建立廣告群組合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_ad_preview(寫入):預覽並確認原生 ChatGPT Ads 建立廣告預覽合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_campaign(寫入):預覽並確認原生 ChatGPT Ads 建立行銷活動合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_conversion_pixel(寫入):預覽並確認原生 ChatGPT Ads 建立轉換像素合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_conversion_setting(寫入):預覽並確認原生 ChatGPT Ads 建立轉換設定合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_create_feed(寫入):預覽並確認原生 ChatGPT Ads 建立動態饋送合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_account:讀取所選 ChatGPT Ads 帳戶的名稱、幣別、時區和審查狀態。這是 Ads Management 金鑰,與 OpenAI Platform API 金鑰不同。openai_ads_get_ad:讀取所選帳戶內的一則 ChatGPT Ads 廣告、素材和審查狀態。不會要求廣告預覽或變更。openai_ads_get_ad_group:讀取一個 ChatGPT Ads 廣告群組,包括其原生出價、情境提示和設定,且不變更放送。openai_ads_get_ad_groups:列出行銷活動的一頁 ChatGPT Ads 廣告群組。原生廣告群組 ID 為 adgrp_ 識別碼;請保留 has_more 和 last_id。openai_ads_get_ads:列出 ChatGPT Ads 廣告群組的一頁廣告和原生素材中繼資料。請保留供應商的審查狀態和分頁資訊。openai_ads_get_audience_operation:讀取原生 ChatGPT Ads 取得目標對象作業合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_audience_operations:讀取原生 ChatGPT Ads 取得目標對象作業清單合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_audit_logs:讀取原生 ChatGPT Ads 取得稽核記錄合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_bulk_job:讀取一個有限預覽的原生批次作業。只有 completed/partially_failed/failed 為終止狀態。已完成的作業仍須逐一讀取每項作業結果和原生實體。openai_ads_get_bulk_job_operations:讀取一頁原生批次結果(created/updated/validated/failed/skipped)。僅當 has_more 為真時,才以最後一個 operation_id 作為 after 繼續。部分失敗絕不會復原先前的作業;請勿重新提交狀態不確定的作業。openai_ads_get_campaign:讀取所選 ChatGPT Ads 帳戶內的一個行銷活動及其原生狀態、預算、排程和指定目標。openai_ads_get_campaigns:列出所選 ChatGPT Ads 帳戶內的一頁行銷活動。僅當 has_more 為 true 時才依 last_id 繼續;預算金額使用微單位。openai_ads_get_conversion_events:讀取原生 ChatGPT Ads 取得轉換事件合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_conversion_insights:讀取原生 ChatGPT Ads 取得轉換洞察合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_conversion_pixels:讀取原生 ChatGPT Ads 取得轉換像素合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_conversion_settings:讀取原生 ChatGPT Ads 取得轉換設定合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_custom_audience:讀取原生 ChatGPT Ads 取得自訂目標對象合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_custom_audiences:讀取原生 ChatGPT Ads 取得自訂目標對象清單合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_feed_products:讀取原生 ChatGPT Ads 取得動態饋送商品合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_feed_settings:讀取原生 ChatGPT Ads 取得動態饋送設定合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_feed_uploads:讀取原生 ChatGPT Ads 取得動態饋送上傳合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_feeds:讀取原生 ChatGPT Ads 取得動態饋送清單合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_insights:依帳戶、行銷活動、廣告群組或廣告讀取 ChatGPT Ads 成效。選用的國家/裝置/平台細分僅支援放送指標;國家/裝置轉換請使用 openai_ads_get_conversion_insights。在 attribution 中選擇點擊/瀏覽歸因回溯期和廣告互動/轉換日期。日期為含頭尾的帳戶當地日期;CTR/CVR 為分數,金額使用帳戶幣別。分頁且不重試;截斷情形會明確標示。預設值:30 天點擊、1 天瀏覽、ad_event_time。openai_ads_get_landing_page_crawl:讀取原生 ChatGPT Ads 取得到達網頁檢索合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_mutation:讀取所選帳戶、執行者、工作區和連線的持久核准或變更收據。UNKNOWN 或 APPLYING 狀態絕不可重新提交。openai_ads_get_spend_limits:讀取原生 ChatGPT Ads 取得支出上限合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_get_write_context:在提出行銷活動提案前,讀取所選帳戶、轉換目標和動態饋送庫存。說明原生行銷活動/出價組合和缺少的必要條件,但不授予資格或建立資料。openai_ads_get_write_schema:讀取固定的官方原生請求定義、路徑和參數。列出實際支援的作業和排除項目;支援結構描述並不代表帳戶具備資格。openai_ads_list_ad_creatives:ChatGPT Ads 圖庫;重新整理過期的媒體。每頁列出 20 個,或讀取 60 個確切的 adIds。當 hasMore 為真時依 nextCursor 繼續。openai_ads_pause_ad(寫入):預覽並確認原生 ChatGPT Ads 暫停廣告合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_pause_ad_group(寫入):預覽並確認原生 ChatGPT Ads 暫停廣告群組合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_pause_campaign(寫入):預覽並確認原生 ChatGPT Ads 暫停行銷活動合約。需要已儲存的核准、穩定的 requestId 和確切的原生狀態。建立項目一律為暫停狀態;啟用則另行控管。不會自動重試寫入。預算和出價使用整數的帳戶幣別微單位。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_rename_ad(寫入):重新命名一則 ChatGPT Ads 廣告。只會變更名稱。預設為預覽。openai_ads_rename_ad_group(寫入):重新命名一個 ChatGPT Ads 廣告群組。只會變更名稱。預設為預覽。openai_ads_rename_campaign(寫入):重新命名一個 ChatGPT Ads 行銷活動。只會變更名稱。預設為預覽。openai_ads_search_locations:讀取原生 ChatGPT Ads 搜尋地點合約。使用 openai_ads_get_write_schema 取得巢狀欄位和原生資格資訊。openai_ads_submit_bulk_job(寫入):預覽並確認一個有限預覽的批次作業,最多包含 1000 個操作。必須提供已儲存的核准,以及穩定的請求鍵與操作鍵。預設為僅進行原生驗證;接受並不代表操作已完成。請讀取作業狀態與每一項結果,然後與原生實體核對。不會自動重試寫入。openai_ads_update_ad(寫入):預覽並確認原生 ChatGPT Ads 更新廣告合約。必須提供已儲存的核准、穩定的 requestId 及確切的原生狀態。建立時一律為暫停狀態;啟用需另行通過閘門。不會自動重試寫入。預算與出價使用以整數表示的帳戶幣別微單位。請使用 openai_ads_get_write_schema 取得巢狀欄位與原生資格資訊。openai_ads_update_ad_group(寫入):預覽並確認原生 ChatGPT Ads 更新廣告群組合約。必須提供已儲存的核准、穩定的 requestId 及確切的原生狀態。建立時一律為暫停狀態;啟用需另行通過閘門。不會自動重試寫入。預算與出價使用以整數表示的帳戶幣別微單位。請使用 openai_ads_get_write_schema 取得巢狀欄位與原生資格資訊。openai_ads_update_campaign(寫入):預覽並確認原生 ChatGPT Ads 更新廣告活動合約。必須提供已儲存的核准、穩定的 requestId 及確切的原生狀態。建立時一律為暫停狀態;啟用需另行通過閘門。不會自動重試寫入。預算與出價使用以整數表示的帳戶幣別微單位。請使用 openai_ads_get_write_schema 取得巢狀欄位與原生資格資訊。openai_ads_update_feed_products(寫入):預覽並確認原生 ChatGPT Ads 更新動態饋給產品合約。必須提供已儲存的核准、穩定的 requestId 及確切的原生狀態。建立時一律為暫停狀態;啟用需另行通過閘門。不會自動重試寫入。預算與出價使用以整數表示的帳戶幣別微單位。請使用 openai_ads_get_write_schema 取得巢狀欄位與原生資格資訊。openai_ads_update_feed_settings(寫入):預覽並確認原生 ChatGPT Ads 更新動態饋給設定合約。必須提供已儲存的核准、穩定的 requestId 及確切的原生狀態。建立時一律為暫停狀態;啟用需另行通過閘門。不會自動重試寫入。預算與出價使用以整數表示的帳戶幣別微單位。請使用 openai_ads_get_write_schema 取得巢狀欄位與原生資格資訊。openai_ads_upload_image(寫入):在已儲存預覽並確認後,將經驗證的 PNG/JPEG/WebP 位元組上傳至所選的 ChatGPT Ads 帳戶。最小 640 × 640,最大 5 MiB。傳回供 chat_card 使用的原生 file_id。絕不會變更帳戶 favicon。openai_ads_upload_image_url(寫入):在已儲存預覽並確認後,透過文件所述的 JSON 上傳端點匯入公開的 HTTPS 圖片。傳回原生 file_id。原生供應商會驗證該圖片;帳戶品牌設定不受影響。
調整 (5 個工具,0 個寫入)
使用您的 Adjust 報表 API 權杖連線,並選擇您的助理可讀取的應用程式。Adjust 使用者權限適用。
adjust_compare_periods:針對一個選定的 Adjust 應用程式,以相同的指標、篩選條件、作業系統與衡量設定,比較兩個長度相等的期間。預設為緊接的前一個期間。變更採用原生總計,絕不使用細分項的加總。無法取得或部分數值不會有計算出的變更;同期群成熟度與報表延遲仍會適用。adjust_get_catalog:讀取有文件記載的標準 Adjust 維度與範例指標,以及限定於一個選定應用程式的事件指標。指標與支出/收益存取仍受 Adjust 權限約束;標準指標清單並非詳盡無遺。adjust_list_apps:僅讀取此工作區中選定的 Adjust 應用程式。絕不列出其他用戶端的應用程式。adjust_list_events:探索一個選定 Adjust 應用程式的原生事件基礎 slug、一般活動計數指標 ID 與應用程式專屬事件權杖。計數請使用 activityMetric;單獨的事件基礎 slug 並非報表指標。請將 SKAdNetwork 與彙總收益定義分開保留。adjust_run_report:讀取一個選定 Adjust 應用程式的歸因/成效報表。保留原生總計、警告、歸因選項、貨幣與 UTC 位移。缺少的指標為 null;比率為原生分數。遭截斷或部分的結果並非完整的擷取。
Amazon Ads (107 個工具,77 個寫入)
連線 Amazon 並明確選擇您的助理可存取的設定檔。產品、品牌與格式資格由 Amazon 強制執行;DSP 與 AMC 為個別產品。
amazon_ads_archive_sb_ad(寫入):永久封存一個 Sponsored Brands 廣告。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_ad_group(寫入):永久封存一個 Sponsored Brands ad_group。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_campaign(寫入):永久封存一個 Sponsored Brands 廣告活動。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_keyword(寫入):永久封存一個 Sponsored Brands 關鍵字。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_negative_keyword(寫入):永久封存一個 Sponsored Brands negative_keyword。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_negative_target(寫入):永久封存一個 Sponsored Brands negative_target。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sb_target(寫入):永久封存一個 Sponsored Brands target。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sd_ad_group(寫入):永久封存一個 Sponsored Display ad_group。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sd_campaign(寫入):永久封存一個 Sponsored Display 廣告活動。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sd_negative_target(寫入):永久封存一個 Sponsored Display negative_target。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sd_product_ad(寫入):永久封存一個 Sponsored Display product_ad。不可逆。必須先預覽並明確確認此一實體。amazon_ads_archive_sd_target(寫入):永久封存一個 Sponsored Display target。不可逆。必須先預覽並明確確認此一實體。amazon_ads_create_ad_group(寫入):建立一個處於 PAUSED 狀態的 Sponsored Products 廣告群組,預設出價以個人檔案貨幣計。會檢查所選的父廣告活動。建立前請先預覽並確認;需要付費方案。amazon_ads_create_campaign(寫入):建立一個處於 PAUSED 狀態的 Sponsored Products 廣告活動。請先預覽,再確認確切名稱、目標設定、日期、每日預算與出價策略。貨幣為個人檔案貨幣。不會啟用花費;需要付費方案。amazon_ads_create_campaign_negative_keyword(寫入):建立一個 Sponsored Products 廣告活動負面關鍵字。負面條件一開始為 ENABLED,並會在其父範圍內抑制相符的流量。請先預覽並確認;需要付費方案。amazon_ads_create_campaign_negative_target(寫入):建立一個 Sponsored Products 廣告活動負面目標。負面條件一開始為 ENABLED,並會在其父範圍內抑制相符的流量。請先預覽並確認;需要付費方案。amazon_ads_create_keyword(寫入):建立一個 Sponsored Products 關鍵字。會驗證廣告活動/廣告群組的歸屬關係。正面廣告/目標/關鍵字一開始為 PAUSED;負面關鍵字一開始為 ENABLED,且可抑制流量。產品廣告必須恰好指定一個賣家 SKU 或廠商/作者 ASIN。產品目標設定接受確切的 ASIN 或原生手動的產品/類別/品牌運算式。請先預覽並確認;需要付費方案。amazon_ads_create_negative_keyword(寫入):建立一個 Sponsored Products 負面關鍵字。會驗證廣告活動/廣告群組的歸屬關係。正面廣告/目標/關鍵字一開始為 PAUSED;負面關鍵字一開始為 ENABLED,且可抑制流量。產品廣告必須恰好指定一個賣家 SKU 或廠商/作者 ASIN。產品目標設定接受確切的 ASIN 或原生手動的產品/類別/品牌運算式。請先預覽並確認;需要付費方案。amazon_ads_create_negative_target(寫入):建立一個 Sponsored Products 負面目標。負面條件一開始為 ENABLED,並會在其父範圍內抑制相符的流量。請先預覽並確認;需要付費方案。amazon_ads_create_product_ad(寫入):建立一個 Sponsored Products 產品廣告。會驗證廣告活動/廣告群組的歸屬關係。正面廣告/目標/關鍵字一開始為 PAUSED;負面關鍵字一開始為 ENABLED,且可抑制流量。產品廣告必須恰好指定一個賣家 SKU 或廠商/作者 ASIN。產品目標設定接受確切的 ASIN 或原生手動的產品/類別/品牌運算式。請先預覽並確認;需要付費方案。amazon_ads_create_report:請求一份非同步的 Amazon 成效報告:Sponsored Products 廣告活動、群組、版位、搜尋詞或廣告產品;Brands 廣告活動/搜尋詞/廣告;Display 廣告活動/產品。Brands 舊版廣告活動報告不包含多廣告群組的廣告活動。不會變更廣告或預算。請明確選擇歸因窗口;保留 jobToken,之後再呼叫 amazon_ads_get_report。不會進行輪詢迴圈,也不提供跨平台歸因或自動加總。amazon_ads_create_sb_ad_auto_collection(寫入):建立一個 Sponsored Brands 廣告自動集合。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_brand_video(寫入):建立一個 Sponsored Brands 廣告品牌影片。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_group(寫入):建立一個 Sponsored Brands 廣告群組。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_manual_collection(寫入):建立一個 Sponsored Brands 廣告手動集合。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_product_collection(寫入):建立一個 Sponsored Brands 廣告產品集合。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_product_collection_extended(寫入):建立一個 Sponsored Brands 廣告產品集合擴充版。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_store_spotlight(寫入):建立一個 Sponsored Brands 廣告商店焦點。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_ad_video(寫入):建立一個 Sponsored Brands 廣告影片。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_campaign(寫入):建立一個 Sponsored Brands 廣告活動。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_keyword(寫入):建立一個 Sponsored Brands 關鍵字。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_negative_keyword(寫入):建立一個 Sponsored Brands 負面關鍵字。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_negative_target(寫入):建立一個 Sponsored Brands 負面目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sb_target(寫入):建立一個 Sponsored Brands 目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_ad_group(寫入):建立一個 Sponsored Display 廣告群組。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_campaign(寫入):建立一個 Sponsored Display 廣告活動。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_creative(寫入):建立一個 Sponsored Display 創意素材。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_negative_target(寫入):建立一個 Sponsored Display 負面目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_product_ad(寫入):建立一個 Sponsored Display 產品廣告。原生 Amazon 合約,單一實體。帶有 state 欄位的建立作業要求 PAUSED;不帶 state 的建立作業則要求父項處於暫停狀態。適用原生品牌/產品資格與審核。預覽會綁定目前的實體與父項狀態;確認後可能變更花費。金額以個人檔案貨幣計。不會自動重試。amazon_ads_create_sd_target(寫入):建立一個 Sponsored Display 目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作必須為 PAUSED;無 state 的建立操作需要已暫停的父實體。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認後可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_create_target(寫入):建立一個 Sponsored Products 目標。驗證廣告活動/廣告群組的擁有權。正向廣告/目標/關鍵字會以 PAUSED 開始;負向關鍵字會以 ENABLED 開始,且可能抑制流量。商品廣告需要恰好一個賣家 SKU 或廠商/作者 ASIN。商品目標接受確切的 ASIN 或原生手動商品/類別/品牌表達式。先預覽再確認;需要付費方案。amazon_ads_get_ad_groups:讀取一頁 Amazon Sponsored Products 廣告群組,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_brands:列出此所選設定檔中符合 Sponsored Brands 資格的品牌。在廣告活動與創意設定中使用傳回的 brandEntityId;絕不要自行編造品牌 ID。amazon_ads_get_campaign_negative_keywords:讀取一頁 Amazon Sponsored Products 廣告活動負向關鍵字,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_campaign_negative_targets:讀取一頁 Amazon Sponsored Products 廣告活動負向目標,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_campaigns:讀取一頁 Amazon Sponsored Products 廣告活動,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_creative_asset:重新整理所選設定檔中的一個原生 Amazon 圖片/影片素材。傳回每個版本及其檔案;不提供猜測的 URL,也不進行跨設定檔的備援。請傳入來自 list_creative_assets 的原生 assetId。amazon_ads_get_keywords:讀取一頁 Amazon Sponsored Products 關鍵字,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_negative_keywords:讀取一頁 Amazon Sponsored Products 負向關鍵字,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_negative_targets:讀取一頁 Amazon Sponsored Products 負向目標,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_product_ads:讀取一頁 Amazon Sponsored Products 商品廣告,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_get_product_metadata:從廣告主的 Amazon 目錄讀取廣告商品的標題、原生圖片 URL、庫存、價格與資格。擷取 Sponsored Products 的視覺素材,無需爬取零售頁面。使用 pageIndex 或 Amazon 的 cursorToken 逐頁瀏覽;商品圖片並非完整渲染的廣告。amazon_ads_get_profile:讀取所選的 Amazon Ads 設定檔:市集、帳戶類型、貨幣與時區。API 存取權並不代表具備 Sponsored Brands、Display 或 DSP 的資格。amazon_ads_get_report:檢查一次 Amazon 報表,並在完成時讀取其原生資料列。僅使用由 create_report 為此工作區與設定檔傳回的 jobToken。下載有大小限制;分頁會傳回資料列位移,並明確標示部分結果。已過期的報表必須重新請求。amazon_ads_get_sb_ad_creatives:讀取一個廣告的原生 Sponsored Brands 創意版本:標題、ASIN、品牌標誌與圖片/影片素材參照。使用 get_creative_asset 解析素材 ID,並使用 get_product_metadata 解析 ASIN。需要 Brands 資格;不進行零售頁面爬取。amazon_ads_get_sb_ad_groups:讀取一頁 Sponsored Brands 廣告群組。需要此設定檔中的 Brands 資格。預設包含所有狀態;請依 nextToken 繼續。設定並非成效。amazon_ads_get_sb_ads:讀取一頁 Sponsored Brands 廣告。需要此設定檔中的 Brands 資格。預設包含所有狀態;請依 nextToken 繼續。設定並非成效。amazon_ads_get_sb_campaigns:讀取一頁 Sponsored Brands 廣告活動。需要此設定檔中的 Brands 資格。預設包含所有狀態;請依 nextToken 繼續。設定並非成效。amazon_ads_get_sb_keywords:列出單頁 Sponsored Brands 關鍵字,包含已封存的實體。請依傳回的游標或位移繼續;一頁並非完整清單。amazon_ads_get_sb_negative_keywords:列出單頁 Sponsored Brands 負向關鍵字,包含已封存的實體。請依傳回的游標或位移繼續;一頁並非完整清單。amazon_ads_get_sb_negative_targets:列出單頁 Sponsored Brands 負向目標,包含已封存的實體。請依傳回的游標或位移繼續;一頁並非完整清單。amazon_ads_get_sb_targets:列出單頁 Sponsored Brands 目標,包含已封存的實體。請依傳回的游標或位移繼續;一頁並非完整清單。amazon_ads_get_sd_ad_groups:讀取一頁 Sponsored Display 廣告群組。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_sd_campaigns:讀取一頁 Sponsored Display 廣告活動。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_sd_creatives:讀取一頁 Sponsored Display 創意。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_sd_negative_targets:讀取一頁 Sponsored Display 負向目標。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_sd_product_ads:讀取一頁 Sponsored Display 商品廣告。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_sd_targets:讀取一頁 Sponsored Display 目標。需要 Display 資格。分頁使用 startIndex,而非游標;整頁結果會保守地標示為部分。創意包含原生媒體參照;這些記錄並非成效指標。amazon_ads_get_targets:讀取一頁 Amazon Sponsored Products 目標,預設包含已暫停與已封存的實體。使用 nextToken 繼續,直到其不存在為止;一頁並非帳戶總量。這些是設定記錄,不是成效指標。amazon_ads_list_creative_assets:搜尋 Amazon 創意素材庫:圖片、標誌與影片、原生下載/播放 URL、尺寸與審核中繼資料。單頁;使用相同篩選條件並依 nextToken 繼續。已上傳的素材並不代表廣告已使用或已投放。Sponsored Products 圖片請改用 get_product_metadata 取得。amazon_ads_prepare_asset_upload(寫入):為此設定檔準備 Amazon 圖片/影片上傳。在預覽/確認後,傳回短效的原生 S3 URL。請在不使用 Amazon 持有人憑證的情況下,以傳回的內容類型將檔案位元組 PUT 到該確切 URL,然後使用 uploadToken 呼叫 register_uploaded_asset。這不會建立或啟用廣告。amazon_ads_register_uploaded_asset(寫入):註冊已透過 prepare_asset_upload 上傳至 Amazon URL 的位元組。將來源 URL 綁定至工作區/設定檔;不接受任意 URL。先預覽再確認。傳回原生 assetId、versionId 與規格不符的錯誤。圖片/影片仍須符合版位要求與審核。amazon_ads_rename_ad(寫入):重新命名一個 Amazon Sponsored Brands 廣告。Sponsored Products 與 Display 商品廣告沒有名稱。名稱是唯一會變更的項目。預設會先預覽。amazon_ads_rename_ad_group(寫入):重新命名一個 Amazon Sponsored Products、Brands 或 Display 廣告群組。名稱是唯一會變更的項目。預設會先預覽;已封存的實體無法重新命名。amazon_ads_rename_campaign(寫入):重新命名一個 Amazon Sponsored Products、Brands 或 Display 廣告活動。名稱是唯一會變更的項目。預設會先預覽;已封存的實體無法重新命名。amazon_ads_update_ad_group(寫入):更新一個 Sponsored Products 廣告群組:狀態與出價。啟用可能產生花費;封存無法復原。預覽會綁定目前的值,而確認會拒絕過期或已變更的請求。需要付費方案。amazon_ads_update_campaign(寫入):更新 Sponsored Products 廣告活動的名稱、狀態、日期或出價策略。ARCHIVED 無法復原。預覽會綁定目前的廣告活動;在已啟用的廣告活動上變更出價可能改變花費。每日預算請使用 update_campaign_budget。amazon_ads_update_campaign_budget(寫入):以設定檔貨幣變更一個 Sponsored Products 每日預算。可能改變已啟用廣告活動的花費。預覽會綁定先前的預算與狀態;確認會拒絕過期的預覽。需要付費方案。amazon_ads_update_campaign_negative_keyword(寫入):變更 Sponsored Products 廣告活動負向關鍵字的狀態。啟用會抑制相符的流量;封存無法復原。請預覽並確認確切的實體。amazon_ads_update_campaign_negative_target(寫入):變更 Sponsored Products 廣告活動負向目標的狀態。啟用會抑制相符的流量;封存無法復原。請預覽並確認確切的實體。amazon_ads_update_campaign_status(寫入):暫停或啟用一個 Amazon Sponsored Products 廣告活動。啟用可能花費金錢。請先預覽,再使用預覽中的 expectedStatus 確認。Amazon 會強制執行設定檔成員資格;已封存的廣告活動無法還原。需要付費方案。amazon_ads_update_keyword(寫入):更新一個 Sponsored Products 關鍵字:狀態與出價。啟用可能產生花費;封存無法復原。預覽會綁定目前的值,而確認會拒絕過期或已變更的請求。需要付費方案。amazon_ads_update_negative_keyword(寫入):變更 Sponsored Products 負向關鍵字的狀態。啟用會抑制相符的流量;封存無法復原。請預覽並確認確切的實體。amazon_ads_update_negative_target(寫入):變更 Sponsored Products 負向目標的狀態。啟用會抑制相符的流量;封存無法復原。請預覽並確認確切的實體。amazon_ads_update_product_ad(寫入):更新一個 Sponsored Products 商品廣告:狀態。啟用可能產生花費;封存無法復原。預覽會綁定目前的值,而確認會拒絕過期或已變更的請求。需要付費方案。amazon_ads_update_sb_ad(寫入):更新一個 Sponsored Brands 廣告。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作必須為 PAUSED;無 state 的建立操作需要已暫停的父實體。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認後可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_auto_collection(寫入):取代 Sponsored Brands 廣告創意的自動收集創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_brand_video(寫入):取代 Sponsored Brands 廣告創意的品牌影片創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_manual_collection(寫入):取代 Sponsored Brands 廣告創意的手動收集創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_product_collection(寫入):取代 Sponsored Brands 廣告創意的商品收集創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_product_collection_extended(寫入):取代 Sponsored Brands 廣告創意的擴充商品收集創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_store_spotlight(寫入):取代 Sponsored Brands 廣告創意的商店焦點創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_creative_video(寫入):取代 Sponsored Brands 廣告創意的影片創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_ad_group(寫入):更新一個 Sponsored Brands 廣告群組。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_campaign(寫入):更新一個 Sponsored Brands 廣告活動。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_keyword(寫入):更新一個 Sponsored Brands 關鍵字。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_negative_keyword(寫入):更新一個 Sponsored Brands 否定關鍵字。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_negative_target(寫入):更新一個 Sponsored Brands 否定目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sb_target(寫入):更新一個 Sponsored Brands 目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_ad_group(寫入):更新一個 Sponsored Display 廣告群組。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_campaign(寫入):更新一個 Sponsored Display 廣告活動。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_creative(寫入):更新一個 Sponsored Display 創意。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_negative_target(寫入):更新一個 Sponsored Display 否定目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_product_ad(寫入):更新一個 Sponsored Display 商品廣告。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_sd_target(寫入):更新一個 Sponsored Display 目標。原生 Amazon 合約,單一實體。帶有 state 欄位的建立操作要求 PAUSED;無 state 的建立操作要求父實體處於暫停狀態。適用原生品牌/商品資格與審核。預覽會綁定目前實體與父實體狀態;確認可能改變花費。金額以設定檔貨幣為單位。不會自動重試。amazon_ads_update_target(寫入):更新一個 Sponsored Products 目標:狀態與出價。啟用可能產生花費;封存無法復原。預覽會綁定目前值,且確認會拒絕過期或已變更的請求。需要付費方案。amazon_ads_upload_asset_bytes(寫入):將提供的圖片/影片位元組上傳至綁定自 prepare_asset_upload 之不透明 uploadToken 的原生 S3 URL。不會將 bearer 憑證傳送至 S3。預覽/確認會綁定位元組摘要。之後請註冊該素材;此操作不會建立廣告。
Apple Ads(19 個工具,11 個寫入)
連接 Apple Ads 並選擇你的助理可存取的組織。Apple 帳戶角色適用。
apple_ads_create_account(寫入):在授權使用者的組織中建立額外的 Apple 廣告帳戶。需要同一組織中已選取的錨點帳戶,以及 Apple 帳戶建立權限。貨幣、時區與帳單設定會繼承;不會設定任何 App 委派或投放。請在「來源」中另行選取新帳戶。apple_ads_create_adgroup(寫入):在已驗證的廣告活動下建立一個暫停的 manual-CPT Apple 廣告群組。自動關鍵字指定功能已停用。apple_ads_create_campaign(寫入):建立一個處於暫停狀態的 App Store 搜尋結果廣告活動。需要符合資格的 App、明確的貨幣、預算與國家/地區。確認前請先預覽;建立時不會啟用任何投放。apple_ads_create_keyword(寫入):在已驗證的 Apple 廣告群組中建立一個暫停的正向關鍵字。確認前請先預覽。apple_ads_get_account:讀取所選的 Apple 廣告帳戶,包括原生貨幣、時區與帳單設定。apple_ads_get_adgroups:讀取屬於某個 Apple 廣告活動的一頁廣告群組。apple_ads_get_app:讀取所選 Apple 廣告帳戶可用的 App Store App 中繼資料。apple_ads_get_app_eligibility:在建立廣告活動前,檢查 App 的廣告投放資格與可用的商店地區。apple_ads_get_campaign:讀取單一 Apple 廣告活動,並驗證其帳戶成員資格。apple_ads_get_campaigns:讀取一頁 Apple App 廣告活動,包括暫停的廣告活動。會傳回原生分頁;offset/limit 並不代表完整的帳戶匯出。apple_ads_get_keywords:讀取屬於某個 Apple 廣告群組的一頁正向關鍵字。apple_ads_get_report:讀取指定廣告活動的原生 Apple 廣告活動、廣告群組、廣告、關鍵字或搜尋字詞成效。保留花費貨幣、歸因指標、時區、原生總計與分頁。切勿加總比率,或假設單一頁面就是整個帳戶。支援每月/每週/每日歷史報表,但受 Apple 保留期限限制。省略 granularity 以取得期間總計。廣告活動報表最多接受 20 個廣告活動;其他層級每次呼叫必須恰好指定一個廣告活動。apple_ads_rename_ad(寫入):重新命名 Apple 廣告。只會變更名稱。預設為預覽。apple_ads_rename_ad_account(寫入):重新命名 Apple 廣告帳戶。只會變更名稱。預設為預覽。apple_ads_rename_adgroup(寫入):重新命名 Apple 廣告群組。只會變更名稱。預設為預覽。apple_ads_rename_campaign(寫入):重新命名 Apple 廣告活動。只會變更名稱。預設為預覽。apple_ads_update_adgroup(寫入):更新 Apple 廣告群組。預覽會傳回 expectedSnapshot;請以該快照確認,以拒絕已變更的資源或已變更的承載內容。ENABLED 可能導致廣告花費。apple_ads_update_campaign(寫入):更新 Apple 廣告活動。預覽會傳回 expectedSnapshot;請以該快照確認,以拒絕已變更的資源或已變更的承載內容。ENABLED 可能導致廣告花費。apple_ads_update_keyword(寫入):更新 Apple 關鍵字。預覽會傳回 expectedSnapshot;請以該快照確認,以拒絕已變更的資源或已變更的承載內容。ENABLED 可能導致廣告花費。
LinkedIn Ads(30 個工具,15 個寫入)
連接 LinkedIn 並選擇你的助理可存取的廣告帳戶。原生帳戶角色與組織權限適用。
linkedin_create_campaign(寫入):建立非使用中(DRAFT)的文字或贊助內容廣告活動。LinkedIn 廣告活動包含預算、指定目標與出價。原生相容性仍然適用。linkedin_create_campaign_group(寫入):在已選取的授權帳戶中建立 DRAFT 廣告活動群組。預設為預覽。linkedin_create_media_ad(寫入):建立 DRAFT 贊助圖像/影片廣告,並附帶一則暗貼文(feedDistribution NONE)。不會發佈自然動態貼文。linkedin_create_text_ad(寫入):使用帳戶媒體庫中現有的圖像建立 DRAFT 文字廣告。預設為預覽。linkedin_delete_draft_ad(寫入):刪除所選帳戶中一個擁有的 DRAFT 廣告素材。不會刪除其來源貼文或媒體。linkedin_duplicate_ad(寫入):將所選帳戶中的廣告複製到已驗證的廣告活動中作為 DRAFT,並重複使用其完全相同的內容參照。不會複製廣告活動設定或啟用投放。linkedin_finalize_upload(寫入):在所有已簽署的部分上傳完畢後完成影片。使用 linkedin_get_media 檢查處理狀態,直到狀態為 AVAILABLE;切勿以封面取代影片。linkedin_find_targeting:依名稱查詢原生指定目標 URN,例如國家/地區。linkedin_get_account_details:完整讀取單一 LinkedIn 廣告帳戶,以及在其上持有角色的成員。角色決定連線可執行的操作,因此若讀取在某個帳戶失敗、在另一個帳戶成功,通常是角色問題,而非範圍問題。linkedin_get_campaign_groups:列出 LinkedIn 廣告帳戶中的廣告活動群組,包括預算、排程與投放狀態。在 LinkedIn 上,廣告活動群組是共用預算與出價策略所在之處,因此這個層級能解釋為何同層廣告活動會一起停止。linkedin_get_campaigns:列出 LinkedIn 廣告帳戶中的廣告活動,包括狀態、目標、格式、出價策略、預算與排程。在 LinkedIn 上,廣告活動包含指定目標與出價,而其下的廣告素材就是廣告。linkedin_get_creatives:列出 LinkedIn 廣告帳戶的廣告素材,可選擇僅列出指定廣告活動的素材。廣告素材就是廣告本身,並帶有其自身的預定狀態、審查結果,以及被暫緩的原因。linkedin_get_delivery_status:說明 LinkedIn 廣告為何投放或不投放,從帳戶層級一路到廣告素材。LinkedIn 會並列保留使用者狀態與系統投放狀態,而幾乎總是後者說明為何沒有任何內容在投放。linkedin_get_demographics:依專業人口統計資料細分 LinkedIn 投放:公司、公司規模、產業、資歷、職稱、職務功能或地點。這些是購買 LinkedIn 所依據的數字,並附有工具在資料列旁說明的限制。linkedin_get_entity:讀取單一廣告活動群組、廣告活動或廣告素材,並驗證帳戶擁有權。linkedin_get_insights:執行依單一樞紐分組的 LinkedIn Ads 報表。這是分析查找器:單一樞紐、任意粒度,以及最多 20 個欄位,包括 dateRange 與 pivotValues。CTR、CPC 與 CPM 等比率不存在於 API 中,而是由此處從原始項目計算得出。linkedin_get_media:重新整理單一圖像/影片 URL,並驗證媒體庫關聯。linkedin_get_revenue_attribution:讀取 LinkedIn 營收歸因報表:來自 CRM、歸因於 LinkedIn 廣告的商機管道與已成交營收。僅能為其 Business Manager 已連接 CRM 的帳戶提供答案,且僅限 30 至 366 天的時間範圍。linkedin_get_setup_guide:在準備變更前,讀取帳戶、支援的格式與原生 LinkedIn 寫入需求。linkedin_initialize_upload(寫入):初始化圖像/影片上傳至所選的授權帳戶媒體庫。傳回用於分塊上傳/完成處理的已簽署收據。不接受任意上傳主機。linkedin_list_ad_creatives:廣告連結圖像與可播放影片的圖庫,並附有實際廣告名稱。將到達網頁 URL 與媒體 URL 分開。不會回報投放成效。linkedin_list_media:列出帳戶圖像/影片媒體庫檔案,包括下載 URL 與原生處理狀態;並非廣告成效。linkedin_rename_ad(寫入):重新命名所選帳戶中一個擁有的 LinkedIn 廣告(廣告素材)。只會變更名稱。linkedin_rename_ad_account(寫入):重新命名所選的 LinkedIn 廣告帳戶。只會變更名稱。linkedin_rename_campaign(寫入):重新命名所選帳戶中一個擁有的 LinkedIn 廣告活動。只會變更名稱。linkedin_rename_campaign_group(寫入):重新命名所選帳戶中一個擁有的 LinkedIn 廣告活動群組。只會變更名稱。linkedin_run_statistics_report:執行依最多三個樞紐同時分組的 LinkedIn Ads 報表。這是統計查找器,也是在單一請求中將廣告活動與裝置交叉分析,或將廣告活動群組與投放位置交叉分析的唯一方式。linkedin_update_entity(寫入):重新命名、暫停/封存,或編輯所選帳戶中一個擁有的廣告活動/群組/廣告的預算、排程、指定目標或文字廣告內容。不提供啟用功能。巢狀設定會取代對應的物件。linkedin_update_media(寫入):重新命名或封存帳戶媒體庫中一個擁有的圖像/影片。二進位內容不可變更;請上傳新素材來取代。linkedin_upload_part(寫入):使用已簽署的初始化收據上傳一個 base64 檔案部分。解碼後最多 8 MiB;檔案位元組會留在 LinkedIn。不會將權杖傳送至任何上傳主機。
Reddit Ads(54 個工具,23 個寫入)
連接 Reddit 並選擇你的助理可存取的廣告帳戶。原生帳戶資格與權限適用。
reddit_create_ad(寫入):使用原生欄位建立 Reddit 廣告,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=ad_create) 與目前設定。reddit_create_ad_group(寫入):使用原生欄位建立 Reddit ad_group,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=ad_group_create) 與目前設定。reddit_create_campaign(寫入):使用原生欄位建立 Reddit 行銷活動,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=campaign_create) 與目前設定。reddit_create_catalog(寫入):使用原生結構定義 catalog_create 建立 Reddit 目錄。請先預覽。匯入為非同步作業;請輪詢傳回的控制代碼。不會啟用廣告。reddit_create_custom_audience(寫入):使用原生欄位建立 Reddit custom_audience,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=custom_audience_create) 與目前設定。reddit_create_lead_form(寫入):使用原生欄位建立 Reddit lead_form,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=lead_form_create) 與目前設定。reddit_create_post(寫入):使用原生結構定義 post_create 建立 Reddit 貼文。請先預覽。匯入為非同步作業;請輪詢傳回的控制代碼。不會啟用廣告。reddit_create_product_set(寫入):使用原生結構定義 product_set_create 建立 Reddit 產品集。請先預覽。匯入為非同步作業;請輪詢傳回的控制代碼。不會啟用廣告。reddit_create_saved_audience(寫入):使用原生欄位建立 Reddit saved_audience,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=saved_audience_create) 與目前設定。reddit_get_ad:讀取單一 Reddit 廣告;確認其屬於所選廣告帳戶。reddit_get_ad_group:讀取單一 Reddit ad_group;確認其屬於所選廣告帳戶。reddit_get_ad_groups:讀取 Reddit ad_groups,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_ads:讀取 Reddit 廣告,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_asset_uploads:透過所選設定檔輪詢創意素材匯入的處理進度;ACTIVE 表示媒體已就緒,不代表廣告正在投放。reddit_get_campaign:讀取單一 Reddit 行銷活動;確認其屬於所選廣告帳戶。reddit_get_campaigns:讀取 Reddit 行銷活動,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_catalog_imports:從所擁有的 Reddit 目錄讀取 catalog_imports。reddit_get_catalogs:讀取擁有所選廣告帳戶之企業的產品目錄。reddit_get_creative_assets:列出所選 Reddit 設定檔的素材庫;未使用的檔案不一定就是廣告。reddit_get_custom_audience:讀取單一 Reddit custom_audience;確認其屬於所選廣告帳戶。reddit_get_custom_audiences:讀取 Reddit custom_audiences,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_insights:原生 Reddit 報表,包含指標與實體/受眾細分、明確的 UTC 日期與分頁。空結果僅能驗證傳輸。報表中的受眾人口統計資料與已設定的目標對象不同。reddit_get_lead_form:讀取單一 Reddit lead_form;確認其屬於所選廣告帳戶。reddit_get_lead_gen_forms:讀取 Reddit lead_gen_forms,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_pixels:列出所選 Reddit 廣告帳戶可存取的像素。reddit_get_post:在驗證設定檔擁有權後,讀取廣告結構化貼文。reddit_get_post_job:使用其簽署的工作憑證輪詢先前建立的結構化貼文。不接受來自其他帳戶的任意工作 ID。reddit_get_posts:列出此帳戶所連結設定檔的廣告結構化貼文。傳回原生圖片/影片/輪播/文字設定。reddit_get_product_sets:從所擁有的 Reddit 目錄讀取 product_sets。reddit_get_products:從所擁有的 Reddit 目錄讀取產品。reddit_get_profiles:列出所選 Reddit 廣告帳戶可存取的設定檔。reddit_get_reporting_schema:Reddit 指標與維度清單;已設定的目標對象請以 reddit_get_targeting 讀取,不要從報表推斷。reddit_get_saved_audience:讀取單一 Reddit saved_audience;確認其屬於所選廣告帳戶。reddit_get_saved_audiences:讀取 Reddit saved_audiences,包含原生設定與已設定/實際生效狀態。分頁會傳回不透明游標;所有頁面都需要明確接續。reddit_get_setup_guide:完整的 Reddit 連接器涵蓋範圍、先決條件與限制。請勿從初始的簡短工具清單推斷不可用的功能。reddit_get_targeting:讀取實際的廣告群組目標對象設定:包含項目、排除項目、地理、年齡/性別、語言、興趣、社群、關鍵字、裝置與受眾 ID。這是設定,不是投放人口統計資料。reddit_get_targeting_options:探索有效的原生目標對象值。可搜尋社群;大型清單會分頁或明確標示為部分結果。reddit_get_write_schema:用於 Reddit 建立與編輯的固定原生結構定義,包含目標對象設定與所有已實作的活動/廣告格式。供應商接受與本機結構定義驗證是兩回事。reddit_health_check:讀取所選 Reddit 帳戶、貨幣與時區;API 存取權不代表實際投放或完全符合目標資格。reddit_list_ad_creatives:解析廣告連結的圖片/影片/輪播素材,並明確標示涵蓋範圍。影片封面無法確認其動態/音訊內容;若可用,請使用完整媒體。reddit_rename_ad(寫入):重新命名單一 Reddit 廣告。只會變更名稱。預設為預覽。reddit_rename_ad_account(寫入):重新命名所選 Reddit 廣告帳戶。只會變更名稱。預設為預覽。reddit_rename_ad_group(寫入):重新命名單一 Reddit 廣告群組。只會變更名稱。預設為預覽。reddit_rename_campaign(寫入):重新命名單一 Reddit 行銷活動。只會變更名稱。預設為預覽。reddit_update_ad(寫入):使用原生欄位更新 Reddit 廣告,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=ad_update) 與目前設定。reddit_update_ad_group(寫入):使用原生欄位更新 Reddit ad_group,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=ad_group_update) 與目前設定。reddit_update_asset(寫入):更新支援的 Reddit 素材欄位;預設為預覽。請讀取 reddit_get_write_schema(operation=asset_update)。reddit_update_campaign(寫入):使用原生欄位更新 Reddit 行銷活動,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=campaign_update) 與目前設定。reddit_update_catalog(寫入):更新支援的 Reddit 目錄欄位;預設為預覽。請讀取 reddit_get_write_schema(operation=catalog_update)。reddit_update_post(寫入):更新支援的 Reddit 貼文欄位;預設為預覽。請讀取 reddit_get_write_schema(operation=post_update)。reddit_update_product_set(寫入):更新支援的 Reddit product_set 欄位;預設為預覽。請讀取 reddit_get_write_schema(operation=product_set_update)。reddit_update_saved_audience(寫入):使用原生欄位更新 Reddit saved_audience,包含支援的目標與格式。預設為預覽;建立行銷活動/廣告群組/廣告時一律為 PAUSED。編輯前請先讀取 reddit_get_write_schema(operation=saved_audience_update) 與目前設定。reddit_upload_creative_assets(寫入):使用原生結構定義 asset_upload 上傳 Reddit 創意素材。請先預覽。匯入為非同步作業;請輪詢傳回的控制代碼。不會啟用廣告。reddit_upsert_products(寫入):使用原生結構定義 products_upsert 執行 Reddit 產品 upsert。請先預覽。匯入為非同步作業;請輪詢傳回的控制代碼。不會啟用廣告。
Microsoft Advertising(42 項工具,23 項寫入)
透過 Microsoft 連線,然後明確選取您的助理可存取的廣告帳戶。免費方案可使用讀取功能;寫入功能需要符合資格的付費方案。
bing_add_ad_group_targeting(寫入):新增一個原生廣告群組指定目標條件。編輯前請先讀取目前的指定目標;人口統計/地理編輯請使用 Targets,受眾關聯請使用 Audience。不會清除未指定的條件。bing_add_campaign_targeting(寫入):新增一個原生廣告活動指定目標條件。編輯前請先讀取目前的指定目標;人口統計/地理編輯請使用 Targets,受眾關聯請使用 Audience。不會清除未指定的條件。bing_create_ad(寫入):使用原生欄位建立 Microsoft Ads 廣告。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_create_ad_group(寫入):使用原生欄位建立 Microsoft Ads ad_group。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_create_asset_group(寫入):建立一個暫停的 Performance Max 素材群組,包含文字/圖片素材。需要符合資格的廣告活動與所有必要素材;本機預覽並非供應商驗證。bing_create_audience(寫入):使用原生欄位建立 Microsoft Ads 受眾。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_create_campaign(寫入):使用原生欄位建立 Microsoft Ads 廣告活動。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_create_conversion_goal(寫入):建立 Microsoft Ads conversion_goal 設定。不會安裝網站或注入事件。請先預覽;轉換目標建立時為暫停狀態,且不納入出價。bing_create_keyword(寫入):使用原生欄位建立 Microsoft Ads 關鍵字。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_create_uet_tag(寫入):建立 Microsoft Ads uet_tag 設定。不會安裝網站或注入事件。請先預覽;轉換目標建立時為暫停狀態,且不納入出價。bing_get_ad_groups:讀取自有廣告活動中的廣告群組與原生設定。bing_get_ads:讀取廣告,包括原生創意素材、URL 與狀態。AdTypes 會明確控制傳回的格式。bing_get_asset_groups:讀取 Performance Max 素材群組及其原生創意設定與狀態。bing_get_audiences:讀取指定單一明確類型的可存取受眾設定。空受眾並不代表具備比對或指定目標能力。bing_get_campaigns:讀取指定明確廣告活動類型的原生廣告活動設定、預算、設定與狀態。請對其他類型重複操作,以盤點整個帳戶。bing_get_conversion_goals:讀取轉換目標設定;這並不代表事件正在流入。bing_get_geo_file:取得 Microsoft 目前地理指定目標目錄的下載連結。請使用其有效的 Location ID;切勿重複使用 Google 的 location ID。bing_get_insights:為所選帳戶提交非同步 Microsoft Ads 報表。使用 bing_get_report 輪詢已簽署的收據。適用原生欄位相容性與資料可用性限制。bing_get_keywords:讀取自有廣告群組中的關鍵字、比對類型、出價與狀態。bing_get_media:依 ID 讀取所選帳戶中已上傳 Microsoft Ads 媒體的中繼資料。bing_get_report:輪詢並下載綁定此所選帳戶與環境的 Microsoft Ads 報表。最多傳回 2,000 列 CSV;若遭截斷請縮小範圍。空報表並非零成效的證據。bing_get_reporting_schema:讀取固定的 Microsoft 報表類型、支援的原生欄位與官方參考資料。請為相容的報表類型選擇欄位;目錄項目並非已填入資料或生產資料的證據。bing_get_setup_guide:Microsoft Ads 連接器的涵蓋範圍、已驗證的工作流程與其餘限制。在聲稱功能對等或支援不支援的功能前請先閱讀。bing_get_targeting:依條件類型分別讀取實際設定的廣告活動或群組指定目標。包含納入/排除條件物件;這是設定,並非人口統計成效。bing_get_uet_tags:讀取 UET 追蹤代碼設定。此操作不會安裝任何網站追蹤程式碼。bing_get_videos:讀取帳戶影片素材與處理狀態。Active 表示媒體已就緒,並不代表廣告正在放送。影片存取取決於帳戶資格;請使用傳回的失敗代碼。bing_get_write_schema:固定的 Microsoft 原生實體欄位。請閱讀每個多型物件的文件以了解其 REST Type 值。結構描述描述的是 API;帳戶資格仍須另行確認。bing_health_check:讀取所選帳戶並確認其環境、客戶與幣別。這不會驗證每一項功能。bing_import_video(寫入):從您可直接下載的 HTTPS 檔案將影片匯入所選帳戶。Microsoft 會以非同步方式擷取並轉碼來源;傳回的 ID 並不代表已就緒。請先預覽,再使用 bing_get_videos 輪詢。不會建立或啟用廣告。bing_list_ad_creatives:擷取連結至帳戶自有廣告與 Performance Max 素材群組的實際圖片表示,並保留父項 ID/名稱。庫存有上限;不推論放送情形、影片內容或 KPI 歸因。bing_rename_account(寫入):重新命名所選 Microsoft Ads 帳戶。Microsoft 僅接受完整帳戶更新,因此會讀取帳戶並原樣寫回,僅變更名稱。預設為預覽。bing_rename_ad_group(寫入):重新命名 Microsoft Ads 廣告群組。僅變更名稱。預設為預覽。bing_rename_campaign(寫入):重新命名 Microsoft Ads 廣告活動。僅變更名稱。預設為預覽。bing_update_ad(寫入):使用原生欄位更新 Microsoft Ads 廣告。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_update_ad_group(寫入):使用原生欄位更新 Microsoft Ads ad_group。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_update_ad_group_targeting(寫入):更新一個原生廣告群組指定目標條件。編輯前請先讀取目前的指定目標;人口統計/地理編輯請使用 Targets,受眾關聯請使用 Audience。不會清除未指定的條件。bing_update_audience(寫入):使用原生欄位更新 Microsoft Ads 受眾。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_update_campaign(寫入):使用原生欄位更新 Microsoft Ads 廣告活動。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_update_campaign_targeting(寫入):更新一個原生廣告活動指定目標條件。編輯前請先讀取目前的指定目標;人口統計/地理編輯請使用 Targets,受眾關聯請使用 Audience。不會清除未指定的條件。bing_update_keyword(寫入):使用原生欄位更新 Microsoft Ads 關鍵字。預設為預覽。廣告實體建立時為暫停狀態。請先讀取 bing_get_write_schema 與目前設定。bing_update_video(寫入):更新帳戶自有影片素材的描述。不會變更放送或取代影片來源。預設為預覽;使用 bing_get_videos 讀回。bing_upload_image(寫入):將圖片位元組上傳至所選 Microsoft Ads 資源庫。不會建立或啟用廣告。本機預覽會回報位元組長度,而不重複圖片內容。
Snapchat Ads(50 項工具,29 項寫入)
適用於已授權的所選帳戶。
snapchat_create_ad(寫入):建立 Snapchat 廣告。一律為 PAUSED。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_adsquad(寫入):建立 Snapchat 廣告群組(adsquad)。一律為 PAUSED。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_campaign(寫入):建立 Snapchat 行銷活動。一律為 PAUSED。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_creative(寫入):建立 Snapchat 創意素材。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_creative_element(寫入):建立 Snapchat creative_element。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_interaction_zone(寫入):建立 Snapchat interaction_zone。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_lead_generation_form(寫入):建立 Snapchat lead_generation_form。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_lookalike(寫入):從自有客戶名單種子建立類似廣告受眾。仍須符合供應商資格與足夠的種子規模;建立並不保證 targetable_status 為 READY。除非 confirm true,否則僅預覽。snapchat_create_media(寫入):建立 Snapchat 媒體。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_create_segment(寫入):建立 Snapchat 區隔。預設為本機預覽;驗證上層/帳戶擁有權後,確認 true 寫入。snapchat_finalize_frozen_upload(寫入):僅在每個凍結的上傳分段都取得已確認的簽章 partReceipt 後才完成。傳回 mediaId;接著呼叫 snapchat_get_media_status 直到 ready:true,再建立創意素材。snapchat_finalize_media_upload(寫入):在所有分段成功後完成影片上傳。使用 init_media_upload 傳回的 exact finalize_path 與 upload_id。除非 confirm true,否則僅預覽。snapchat_get_ads:列出所選帳戶中的 Snapchat 廣告,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_adsquads:列出所選帳戶中的 Snapchat adsquad,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_campaigns:列出所選帳戶中的 Snapchat 行銷活動,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_creative_elements:列出所選帳戶中的 Snapchat creative_elements,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_creatives:列出所選帳戶中的 Snapchat 創意素材,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_entity:讀取行銷活動、廣告群組、廣告、創意素材、媒體或區隔,並驗證帳戶擁有權。snapchat_get_insights:讀取原生 Snapchat 統計資料,需明確指定時間區間(結束時間為排除)、粒度及選用的實體細分。花費與金錢轉換值為微貨幣。測試帳戶的空結果不構成實際投放成效的證據。snapchat_get_interaction_zones:列出所選帳戶中的 Snapchat interaction_zones,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_lead_generation_forms:列出所選帳戶中的 Snapchat lead_generation_forms,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_media:列出所選帳戶中的 Snapchat 媒體,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_media_status:讀取此帳戶擁有的媒體及其原生處理狀態。僅 ready:true 允許建立創意素材;僅上傳被接受並不足夠。snapchat_get_mobile_apps:在建立應用程式推廣行銷活動或行動再行銷廣告受眾前,先讀取與所選廣告帳戶相關聯的 Snap App ID。snapchat_get_pixels:在設定轉換最佳化或網站廣告受眾前,先讀取與所選帳戶相關聯的像素。snapchat_get_segments:列出所選帳戶中的 Snapchat 區隔,保留完整原生設定與分頁。ad squad 即廣告群組/廣告集。snapchat_get_setup_guide:讀取 Snapchat 行銷活動目標、廣告受眾工作流程、創意素材格式先決條件及明確限制。實作並不代表帳戶資格或實際投放的證明。在聲稱所有功能皆可用前先使用。snapchat_get_targeting:讀取已設定的廣告群組定向、廣告受眾、排除條件、人口統計、地理及版位。缺少的欄位代表未知,並非廣泛定向的證明。成效細分描述的是投放情形,而非已設定的定向。snapchat_get_targeting_options:在編輯前探索原生定向值:國家、地區、語言、性別、興趣及裝置。保留分頁;請勿自行編造類別 ID。snapchat_get_targeting_specs:讀取另行儲存的定向規格,包括超過 500 項條件的設定。這些可能不會出現在一般廣告群組回應中。snapchat_get_write_schema:探索已實作的 Snapchat 建立/編輯欄位、必填欄位及預覽規則。這些是連接器支援的欄位,並非完整的 Snap API 結構描述。snapchat_health_check:讀取所選 Snapchat 帳戶、權限可見的中繼資料及測試旗標。測試帳戶無法投放廣告。snapchat_init_media_upload(寫入):初始化分段影片上傳,最多 256 MiB,分為最多 32 個 8 MiB 的分段。傳回 upload_id、add_path 及 finalize_path,供後續呼叫使用。除非 confirm true,否則僅預覽。snapchat_list_ad_creatives:解析與廣告連結的 Snapchat 圖片/影片、Story 子項及 Collection 圖磚,附上商家名稱、原生 ID 及最新的媒體 URL。不完整的格式/媒體會被回報。不推斷任何成效。snapchat_prepare_frozen_upload(寫入):從凍結的 Launcher 檔案為現有媒體物件準備可續傳的上傳。圖片:PNG/JPEG,最大 5 MB。影片:MP4/MOV,最大為共用的 500 MB 上限。傳回簽章收據與分段數;不會建立另一個媒體或廣告。snapchat_rename_ad(寫入):重新命名一個 Snapchat 廣告。僅名稱會變更。預設為預覽;套用前會檢查擁有權。snapchat_rename_ad_account(寫入):重新命名所選 Snapchat 廣告帳戶。Snap 僅接受完整帳戶更新,因此會讀取帳戶並原樣寫回,僅名稱變更。預設為預覽。snapchat_rename_adsquad(寫入):重新命名一個 Snapchat 廣告群組。僅名稱會變更。預設為預覽;套用前會檢查擁有權。snapchat_rename_campaign(寫入):重新命名一個 Snapchat 行銷活動。僅名稱會變更。預設為預覽;套用前會檢查擁有權。snapchat_update_ad(寫入):更新 Snapchat 廣告設定,包括名稱。預設為預覽;套用前會檢查擁有權。snapchat_update_adsquad(寫入):更新 Snapchat adsquad 設定,包括名稱、定向、排程及預算。預設為預覽;套用前會檢查擁有權。snapchat_update_audience_users(寫入):新增或移除客戶名單成員。僅接受正規化的 SHA-256 雜湊:EMAIL_SHA256、PHONE_SHA256、MOBILE_AD_ID_SHA256。電子郵件以去除空白/轉小寫正規化;電話轉為含國碼的數字;行動 ID 轉小寫並保留連字號。切勿自行編造客戶資料。預覽會傳回計數,而非雜湊。呼叫端每請求最多批次 10,000 筆;confirm true 才會套用。snapchat_update_campaign(寫入):更新 Snapchat 行銷活動設定,包括名稱。預設為預覽;套用前會檢查擁有權。snapchat_update_creative(寫入):更新 Snapchat 創意素材設定,包括名稱。預設為預覽;套用前會檢查擁有權。snapchat_update_segment(寫入):重新命名或編輯廣告受眾區隔的保留期/描述。未變更的欄位會保留。除非 confirm true,否則僅本機預覽。snapchat_update_status(寫入):暫停或啟用行銷活動、廣告群組或廣告。預設為預覽;啟用正式環境實體可能會花費預算。snapchat_upload_frozen_image(寫入):將一個凍結的 PNG/JPEG(最大 5 MB)上傳至現有媒體物件。有界傳輸且僅一次原生變更;無額外的多部分步驟。接著以 get_media_status ready:true 確認 /result/mediaId。支援大量圖片批次,無須將每張圖片展開為影片上傳分段。snapchat_upload_frozen_part(寫入):使用已儲存的上傳收據傳輸一個確切的凍結檔案範圍。分段編號從 1 開始,記憶體中最多 8 MiB。請保存每個 partReceipt 以供完成;成功的分段絕不會由 Launcher 重播。snapchat_upload_media(寫入):將 base64 圖片/影片位元組上傳至先前建立的媒體物件。解碼後每張圖片最大 5 MB,或每個直接影片最大 10 MiB。較大的影片請使用凍結上傳。不從外部 URL 擷取。預覽不會傳送位元組;confirm true 會在驗證擁有權後上傳。snapchat_upload_media_part(寫入):上傳一個影片分段,解碼後最大 8 MiB。使用 init_media_upload 傳回的 exact add_path 與 upload_id。預覽絕不會傳送位元組。
X Ads(46 項工具,21 項寫入)
連接您自己的 X Ads 帳戶,並選擇要公開的廣告主。免費方案允許讀取;Pro、Team 與 Enterprise 允許寫入。請重新連接較舊的連線以使用 media.write。X 控管帳戶驗證與投放資格。
x_ads_activate_campaign(寫入):啟用行銷活動(設定 entity_status=ACTIVE)。一旦其廣告群組也處於啟用狀態,此舉便使行銷活動符合投放廣告的資格,並花費真實金錢。這是唯一能啟用行銷活動的工具;呼叫前請先與廣告主確認。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_activate_line_item(寫入):啟用廣告群組(設定 entity_status=ACTIVE)。一旦其父行銷活動也處於啟用狀態,廣告群組便符合投放廣告的資格,並花費真實金錢。這是唯一能啟用廣告群組的工具;呼叫前請先與廣告主確認。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_add_targeting_criterion(寫入):為廣告群組新增一個定向條件(每個條件呼叫一次)。沒有條件的廣告群組會進行廣泛投放;這是允許的,並非錯誤。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_ad_post(寫入):撰寫僅限推廣(「nullcasted」)的貼文,作為廣告創意使用。該貼文永遠不會出現在作者的個人檔案或追蹤者的時間軸上,本身也不會花費任何費用;請使用 promote_post 將其附加至廣告群組。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_campaign(寫入):在廣告帳戶中建立行銷活動。行銷活動一律以 entity_status PAUSED 建立;在明確使用 activate_campaign 啟用之前,它無法投放或花費。行銷活動一律以 budget_optimization LINE_ITEM 建立(這是 ads-api 仍支援的唯一模式),因此預算不在此處設定:請透過 create_line_item 在每個廣告群組上設定 daily_budget_amount_local_micro。在 ads-api v12 中,排程(start_time/end_time)與投放步調(standard_delivery)也位於廣告群組而非行銷活動上。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_card(寫入):從 JSON 元件承載建立卡片。透過此 API,卡片是不可變的(沒有更新工具);若要變更卡片,請建立新卡片,並推廣使用新 card_uri 的新貼文。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_line_item(寫入):在行銷活動下建立廣告群組。廣告群組一律以 entity_status PAUSED 建立;在明確使用 activate_line_item 啟用之前,它無法投放或花費。對於網站轉換行銷活動,請設定 goal=WEBSITE_CONVERSIONS,並將 primary_web_event_tag 設為來自 list_web_event_tags 的網路事件標籤(像素)ID。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_media_library_item(寫入):將現有媒體鍵註冊為帳戶媒體庫中的具名項目。使用 list_media_library 查看已註冊至帳戶的媒體。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_create_web_event_tag(寫入):建立網站轉換事件標籤(像素);傳回的 ID 可設為廣告群組的 primary_web_event_tag。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_delete_card(寫入):從廣告帳戶刪除卡片。刪除仍在投放的推廣貼文所參照的卡片,會使該貼文的卡片懸空(貼文不可變);若要替換仍在投放的廣告卡片,請建立新卡片、使用其 card_uri 建立新廣告貼文、推廣該貼文,然後在刪除舊卡片之前暫停舊廣告。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_delete_media_library_item(寫入):從廣告帳戶刪除媒體庫物件。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_delete_web_event_tag(寫入):刪除網站轉換事件標籤。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_get_account_stats:取得廣告帳戶的同步分析資料(曝光次數、互動次數、花費)。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_active_entities:列出在時間範圍內指標有變更的廣告實體(在請求帳戶統計資料之前使用)。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_campaign:依 ID 取得單一行銷活動。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_campaign_reach:取得行銷活動的觸及人數與平均頻率指標。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_card:依 ID 取得單一卡片。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_line_item:依 ID 取得單一廣告群組。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_media_library_item:依媒體鍵取得單一媒體庫物件。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_media_upload_status:讀取已連線 X 使用者所擁有之上傳項目的處理狀態。媒體上傳項目在註冊至所選帳戶的媒體庫之前,皆由使用者擁有。x_ads_get_promoted_post:依 ID 取得單一推廣貼文。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_targeting_criterion:依 ID 取得單一定向條件。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_get_web_event_tag:依 ID 取得單一網站轉換事件標籤。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_account_posts:列出廣告帳戶可用於推廣的貼文(推文)。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_ads_accounts:列出已驗證使用者可存取的廣告帳戶。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_campaigns:列出帳戶的行銷活動。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_cards:列出廣告帳戶中的卡片。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_funding_instruments:列出廣告帳戶的資金工具(付款來源)。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_line_item_placements:列出各廣告群組產品類型有效的版位組合。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_line_items:列出廣告帳戶的廣告群組。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_media_library:列出廣告帳戶中的媒體庫物件。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_post_previews:取得已發佈或已排程貼文的轉譯 HTML 預覽。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_promoted_posts:列出廣告帳戶的推廣貼文(推廣推文)。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_targeting_criteria:列出廣告帳戶廣告群組的定向條件。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_list_web_event_tags:列出廣告帳戶中的網站轉換事件標籤(像素);標籤的 ID 即為轉換廣告群組作為 primary_web_event_tag 所採用者。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_promote_post(寫入):將貼文附加至廣告群組,作為其廣告創意。推廣貼文本身沒有 entity_status;當父廣告群組或行銷活動暫停時,它們無法投放。回應會帶有每則貼文的 approval_status(廣告在投放前會先進入審查)。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_remove_targeting(寫入):從其廣告群組移除定向條件(復原定向錯誤)。條件 ID 來自 list_targeting_criteria 或新增時的回應。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_rename_campaign(寫入):重新命名 X Ads 行銷活動。只有名稱會變更。預設為預覽。x_ads_rename_line_item(寫入):重新命名 X Ads 廣告群組。只有名稱會變更。預設為預覽。x_ads_search_targeting_interests:依名稱搜尋可定向的興趣類別。使用此工具尋找 add_targeting_criterion 對 INTEREST 類型條件所需的 targeting_value ID。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_search_targeting_locations:依名稱搜尋可定向的地點。使用此工具尋找 add_targeting_criterion 對 LOCATION 類型條件所需的 targeting_value ID。保留原生 X 欄位與分頁;以 _micro 結尾的金額欄位為帳戶幣別的百萬分之一。x_ads_update_campaign(寫入):重新命名行銷活動或將其暫停(entity_status=PAUSED)。此工具可以暫停,但無法啟用;請使用 activate_campaign 使行銷活動符合花費資格。在 ads-api v12 中,預算與排程位於廣告群組上:請使用 update_line_item 變更它們。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_update_line_item(寫入):更新廣告群組的出價、預算、名稱、排程、版位、目標、投放步調、受眾擴展(設定 audience_expansion=EXPANDED 以開啟最佳化定向)或 entity_status。設定 entity_status=PAUSED 以暫停此廣告群組;暫停只能在此處進行,而 activate_line_item 是使其再次符合花費資格的唯一方式。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_update_media_library_item(寫入):更新媒體庫物件的詮釋資料(例如名稱、標題、描述)。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_update_web_event_tag(寫入):更新網站轉換事件標籤。預設為預覽。在 confirm:true 之前,請使用者核准確切的帳戶、目標與參數。x_ads_upload_media(寫入):將圖片、GIF 或 MP4 短片上傳至 X。預覽僅包含大小與 SHA-256。可能會收取 X API 額度。圖片使用單一請求;影片/GIF 使用 initialize、append 與 finalize,且不重試。在將傳回的 media_key 透過 create_media_library_item 註冊之前,請先檢查處理狀態。不會建立或啟用廣告。
RTB House(7 個工具,2 個寫入)
適用於已授權的特定帳戶。
rtb_house_get_advertiser:讀取 RTB House 廣告主詳細資料、狀態、貨幣、可用的歸因慣例與權限。rtb_house_get_campaigns:讀取 RTB House 廣告活動,包括已暫停的廣告活動與 isEditable。廣告活動雜湊在統計資料中即為子廣告活動。rtb_house_get_creatives:讀取 RTB House 廣告素材名稱、狀態與預覽連結,預設包含未啟用的廣告素材。rtb_house_get_insights:讀取 RTB House 每日或分組成效資料。轉換指標需要明確指定 countConvention。回傳可用指標、附標籤的比率計算、unavailableMetrics 與部分涵蓋範圍,並包含歸因、貨幣與 UTC 位移。切勿跨資料列加總比率或觸及數。RTB House 會驗證維度組合。rtb_house_get_offers:從 RTB House 廣告主饋送資料讀取商品優惠。若結果達到上限,可能不完整。rtb_house_update_advertiser_status(寫入):暫停或啟用整個 RTB House 廣告主。此操作會控制其所有廣告活動的投放。請先預覽,再以 expectedStatus 搭配 confirm:true 確認。啟用後可能會恢復所有啟用中廣告活動的支出。rtb_house_update_campaign_status(寫入):暫停或啟用單一 RTB House 廣告活動。會檢查廣告主成員資格與 isEditable。請先預覽,再以該預覽中的 expectedStatus 搭配 confirm:true 確認。啟用後可能會產生花費。
Meta Ads(61 項工具,24 項寫入)
適用於已授權的特定帳戶。
meta_batch_catalog_items(寫入):依 retailer_id 建立或更新最多 50 個目錄商品。傳回非同步批次控制代碼;接受不代表完成。不刪除,也不自動 upsert。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_ad(寫入):使用所選帳號中現有的廣告組合與創意,建立一個 PAUSED 廣告。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_adcreative(寫入):從現有貼文或明確的 object_story_spec 及選用的 asset_feed_spec 建立廣告創意。支援圖片、影片、輪播、精選集與彈性規格。不會啟動廣告。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_adset(寫入):建立一個 PAUSED 的 Meta 廣告組合,並明確指定目標設定、最佳化、版位、歸因、出價與排程。金額使用帳號幣別的主要單位。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_campaign(寫入):建立一個 PAUSED 的 Meta 行銷活動,預算可採用廣告組合預算(省略行銷活動預算)、每日行銷活動預算或總額行銷活動預算。支援原生 validate_only。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_custom_audience(寫入):建立網站、互動、客戶名單容器或類似廣告受眾。不會上傳客戶資料。條款與資格由 Meta 強制執行。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_create_product_set(寫入):在與所選廣告帳號同屬一個商家的目錄中,建立篩選後的商品集。絕不會發佈至 Shops。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_debug_token:使用伺服器應用程式憑證檢查權杖身分、有效性、到期時間與範圍。若無法進行具權限的檢查,則獨立檢查連線使用者與已授予的權限;權杖/應用程式中繼資料仍為未知。meta_duplicate_adset(寫入):在所選帳號內複製一個已知良好的廣告組合,保留複雜的原生設定。一律為 PAUSED,且不複製廣告。之後使用 meta_rename_adset 重新命名。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_get_account_details:取得特定 Meta 廣告帳號的詳細資訊:名稱、幣別、時區、支出上限、狀態、商家資訊。meta_get_ad_activity:從 /{ad_account_id}/activities 讀取廣告帳號活動記錄,包含 object、event、actor、timestamp 與 extra_data 欄位。meta_get_ad_studies:列出廣告帳號的轉換提升研究與 A/B 測試(Ad Studies)。包含研究類型、狀態與組別。meta_get_ads:列出 Meta 廣告帳號的廣告,可依廣告組合篩選。傳回廣告 ID、名稱、狀態與創意參照。meta_get_adset_configuration:在準備編輯或新增廣告之前,讀取現有廣告組合、其父行銷活動的預算/目標與帳號幣別。對於網站與應用程式(跨管道)廣告組合,creativeRequirements 會提供其自身廣告所使用的 applink_treatment(與 omnichannel_link_spec)。傳回原生設定;不進行變更。meta_get_adsets:列出 Meta 廣告帳號的廣告組合,可依行銷活動篩選。傳回目標設定、預算、最佳化與排程資訊。meta_get_audience_details:在權限允許的範圍內,以分頁與豐富欄位讀取詳細的自訂、已儲存與類似廣告受眾。meta_get_audiences:列出 Meta 廣告帳號的自訂、已儲存與類似廣告受眾。meta_get_brand_safety_controls:從廣告帳號/廣告組合的目標設定與選用的封鎖清單邊緣,讀取品牌安全、適宜性、版位與情境控制訊號。meta_get_business_assets:在權限允許時,以唯讀方式探索可存取的 Meta 商家資產:商家、粉絲專頁、Instagram 帳號、像素與資料集。meta_get_campaign_structure:取得階層式行銷活動結構:行銷活動 -> 廣告組合 -> 廣告。有助於了解帳號組織。meta_get_campaigns:列出 Meta 廣告帳號的行銷活動。傳回行銷活動 ID、名稱、狀態、目標、預算與出價策略。meta_get_catalog_batch_status:讀取目錄批次控制代碼的完成狀態與逐項錯誤。接受批次並不代表每個商品都成功。meta_get_catalog_products:在可存取目錄時,讀取商品目錄與商品項目。傳回可供聯結的商品中繼資料,不會建立或更新目錄資產。meta_get_creative_assets:傳回與廣告連結的創意媒體,包含實際廣告名稱、精選集封面、所有輪播/彈性元件、解析後的圖片雜湊與影片 URL。僅限目錄的廣告會另行分類;如需視覺化圖庫,請使用 get_creative_gallery。原始創意中繼資料仍可供診斷使用。meta_get_creatives:取得廣告創意內容:文字、圖片、影片、連結、行動呼籲。傳回指定廣告的創意詳細資料。meta_get_delivery_diagnostics:使用可取得的 status/effective_status/issues_info 加上簡單的投遞洞察,彙總行銷活動、廣告組合與廣告的唯讀投遞診斷。meta_get_insights:Meta 成效。若需分析購買、潛在客戶或轉換,請要求 actions(營收則要求 action_values),或明確指定指標,例如 purchases/omni_purchases/leads。原生 conversions 欄位並非通用的轉換總數;其不存在並不代表無法取得購買或潛在客戶。請標示確切的 action_type,且絕不可加總重疊的購買類型。欄位:meta://metrics、meta://dimensions、meta://breakdowns。相容的查詢結果會合併。meta_get_instagram_accounts:在權限允許時,列出連結至可存取粉絲專頁、Business Manager 資產或廣告帳號的 Instagram 帳號。meta_get_organic_content_enrichment:讀取 Facebook 粉絲專頁貼文與 Instagram 媒體,包含 URL、原生期間與選用的洞察。這些是內容洞察,並非廣告洞察;請勿推斷為僅限自然流量的細分。meta_get_page_posts:使用從連線使用者解析出的粉絲專頁權杖,讀取已發佈的 Facebook 粉絲專頁貼文。傳回確切的 PageID_PostID、訊息、永久連結與媒體附件。使用 postId 進行確切現有貼文廣告的預先檢查。不會要求 Instagram 媒體、留言、讚或洞察;僅此讀取並不能確立廣告資格。meta_get_pages:列出可存取的 Facebook 粉絲專頁,包含 id、名稱、類別、任務、圖片,以及可取得時所連結的 Instagram 帳號參照。meta_get_pixels:在可存取時,列出廣告帳號或 Business Manager 的像素與資料集,並針對受權限限制的邊緣傳回可據以行動的警告。meta_get_promotable_apps:列出此廣告帳號可投放廣告的應用程式及其商店 URL,以設定網站與應用程式(跨管道)廣告組合:promoted_object.omnichannel_object.app[] 接受 application_id 與 object_store_urls。唯讀。meta_get_study_results:取得轉換提升或 A/B 測試研究的詳細結果。傳回目標、組別與提升結果。meta_get_uploaded_video:檢查影片處理狀態與其是否屬於所選帳號的媒體庫。若第一頁未包含該 ID,請使用影片標題縮小帳號範圍的查詢。僅直接讀取影片本身絕不能證明其成員資格或就緒狀態。有界分頁;not_found 不代表成功。meta_get_video_sources:為特定廣告影片解析最新的下載 URL(來源)與縮圖。請在下載時呼叫:傳回的 URL 已簽署且會快速到期。meta_health_check:唯讀連線診斷:檢查權杖身分與已授予的權限,並列出可存取的精選廣告帳號。無法進行的檢查仍為未知;已授予的範圍不能證明應用程式存取層級或已通過 Meta 安全檢查點。meta_inspect_launcher_entity:在其廣告帳號中讀取特定已確認的 Launcher 實體,以供對帳。唯讀;絕不會建立、變更或重試該實體。在聲稱完全相符之前,必須檢查缺少或正規化的欄位。meta_interpret_experiment_results:以信賴護欄、組別、目標與選用的組別實體,讀取並解讀 A/B 測試或轉換提升研究結果。meta_join_product_insights:查詢商品細分洞察,並在可存取目錄時以商品目錄中繼資料充實資料列。meta_list_ad_accounts:列出目前權杖可存取的所有 Meta 廣告帳號。傳回帳號 ID、名稱、幣別、時區與狀態。meta_list_ad_images:列出廣告帳號圖片庫(/adimages):雜湊、名稱、尺寸、狀態、永久公開提供的顯示 URL(permalink_url)、短期 CDN URL,以及選用的使用各圖片的創意。meta_list_ad_videos:列出廣告帳號影片庫(/advideos):標題、長度、處理狀態與公開提供的縮圖(偏好與最大尺寸)。來源檔案 URL 僅在要求時傳回,因為它們會快速到期。meta_rename_ad(寫入):重新命名 Meta 廣告。只會變更名稱。預設為預覽。meta_rename_ad_account(寫入):重新命名 Meta 廣告帳號。只會變更名稱。預設為預覽。meta_rename_adset(寫入):重新命名 Meta 廣告組合。只會變更名稱。預設為預覽。meta_rename_campaign(寫入):重新命名 Meta 行銷活動。只會變更名稱。預設為預覽。meta_search_entities:在廣告帳號內依名稱搜尋行銷活動、廣告組合或廣告。有助於尋找特定實體。meta_update_ad_creative(寫入):以同一帳號中另一個現有創意取代廣告的創意。廣告狀態維持不變。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_ad_status(寫入):暫停或重新啟用 Meta 廣告。預設為預覽:若未提供 confirm: true,工具只會描述變更而不會套用。meta_update_adset_budget(寫入):在檢查父預算與現有排程後,變更廣告組合的每日或總額預算。狀態維持不變。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_adset_configuration(寫入):更新目標設定、最佳化、版位、歸因、出價、預算或排程。目標設定為完整取代,而非部分合併。狀態維持不變。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_adset_schedule(寫入):使用含明確時區位移的 ISO 8601 變更開始和/或結束時間。在任何變更之前,先將產生的範圍與現有日期核對。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_adset_status(寫入):暫停或重新啟用 Meta 廣告組合。預設為預覽:若未提供 confirm: true,工具只會描述變更而不會套用。meta_update_campaign_budget(寫入):在確認幣別與擁有權後,變更現有由行銷活動擁有的預算。不會將廣告組合預算的行銷活動轉換,也不會變更狀態。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_campaign_status(寫入):暫停或重新啟用 Meta 行銷活動。預設為預覽:若未提供 confirm: true,工具只會描述變更而不會套用。meta_update_custom_audience(寫入):更新現有自訂廣告受眾的名稱、描述、保留期或完整規則。不會直接變更廣告受眾成員。預設為本機預覽。不自動重試。在 Meta 驗證或變更之前,會先檢查帳號擁有權。meta_update_product_set(寫入):取代產品集篩選條件或重新命名。寫入前會檢查目錄擁有權與集合成員資格。預設為本機預覽。不會自動重試。在 Meta 驗證或變更前會檢查帳戶擁有權。meta_upload_ad_image(寫入):使用 base64 位元組(解碼後最多 5 MiB)將圖片上傳至所選廣告帳戶。預覽僅回報大小,絕不回報檔案內容。預設為本機預覽。不會自動重試。在 Meta 驗證或變更前會檢查帳戶擁有權。meta_upload_ad_video(寫入):從可公開存取的 HTTPS URL 或 base64 MP4 位元組(解碼後最多 5 MiB)匯入影片。Meta 會以非同步方式處理。不會啟動任何行銷活動。預設為本機預覽。不會自動重試。在 Meta 驗證或變更前會檢查帳戶擁有權。meta_validate_query:在執行前驗證指標/細分組合。傳回錯誤與警告。可用來檢查查詢是否可行。
Pinterest 廣告(59 項工具,30 項寫入)
適用於已授權的特定帳戶。
pinterest_batch_catalog_items(寫入):提交原生 CREATE/UPDATE/UPSERT/DELETE 目錄項目操作。在回報完成前,請輪詢傳回的批次 ID。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_ad(寫入):從可存取的 Pin 建立 PAUSED 廣告。原生規格支援 Pinterest 創意格式,但須符合適用資格。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_adgroup(寫入):建立 PAUSED 廣告群組,並明確指定原生出價、目標設定、預算與排程。Performance+ 需要明確的 performancePlusUnderPausedCampaign 同意:其群組為 ACTIVE,而父行銷活動必須保持 PAUSED。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_board(寫入):在選定的廣告主環境中建立 /boards。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_campaign(寫入):建立 PAUSED 行銷活動。金額便利欄位使用帳戶貨幣。Campaign Budget Optimization 預設為 true;非 CBO 適用資格因帳戶而異。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_catalog(寫入):在選定的廣告主環境中建立 /catalogs。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_catalog_feed(寫入):在選定的廣告主環境中建立 /catalogs/feeds。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_collection_ad(寫入):建立 PAUSED 精選集,並明確選取圖片/影片主視覺 Pin 及可存取的目錄產品群組。不會建立僅限目錄/DPA 廣告。需要標準帳戶適用資格;Sandbox 中無法使用。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_pin(寫入):在選定的廣告主環境中建立 /pins。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_product_group(寫入):在選定的廣告主環境中建立 /catalogs/product_groups。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_create_product_group_promotion(寫入):從目錄產品群組建立 PAUSED 購物或精選集推廣。Sandbox 中無法使用。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_estimate_delivery:執行非變更性的 Pinterest 規劃計算:廣告群組受眾規模、出價下限或行銷活動投放預估。請求主體遵循所選的 Pinterest v5 結構描述,且不會建立或變更任何行銷活動/廣告群組。pinterest_get_account_entities:讀取 Pinterest 廣告帳戶實體與設定。涵蓋帳戶、行銷活動、廣告群組、廣告、產品群組推廣、推廣、標籤、排程、目標設定範本與訂單明細庫存。傳回單一 API 頁面及其書籤,以提供可預期的即時查詢。pinterest_get_audience_insights:讀取廣告主總受眾或互動受眾、Pinterest 總受眾,或範圍/類型端點的彙總 Pinterest Audience Insights。Pinterest 固定 audience-insights 觀察期間;這不是自訂日期範圍報表。pinterest_get_audiences:讀取受眾、客戶名單、分享及 Business 接收的受眾庫存,而不上傳或變更受眾成員資格。pinterest_get_billing_and_orders:讀取帳單設定檔/發票、發票下載 URL、訂單明細、廣告點數折扣及 SSIO 帳戶/訂單狀態。僅當權杖具有帳戶存取權時才會傳回財務資料。pinterest_get_business_assets:讀取 Pinterest Business Access 庫存:雇主/連結商家、資產、成員、合作夥伴、已指派資產、已接收受眾及邀請。需要相應的商家管理權限。pinterest_get_catalog_diagnostics:讀取深度目錄庫存與診斷:目錄、摘要、摘要處理結果、項目問題、產品群組、產品計數/產品、可用篩選值及目錄項目查詢。ITEMS 是唯讀的 POST 查詢。pinterest_get_catalog_inventory:列出 Pinterest 目錄庫存介面:目錄、產品群組、產品群組推廣及選用產品樣本。pinterest_get_conversion_setup:檢查 Pinterest 轉換評估設定:轉換標籤、符合 oCPM 資格/頁面造訪標籤、Event Quality Score、廣告主定義事件及轉換刪除請求狀態。這絕不會傳送或刪除轉換事件。pinterest_get_creative_assets:在可用時擷取 Pinterest 創意素材與期間成效。傳回廣告、Pin、縮圖/圖片/影片、行銷活動/廣告群組內容、目錄訊號及素材分類。pinterest_get_delivery_metrics:讀取 Pinterest resources/delivery_metrics。用於檢查 Pinterest 官方投放指標中繼資料,以供同步或非同步報表使用。pinterest_get_keyword_intelligence:讀取已指派的目標設定關鍵字、Pinterest 國家/地區層級關鍵字指標、建議字詞或相關字詞。國家/地區指標每次請求最多接受 2,000 個關鍵字。pinterest_get_lead_assets:讀取潛在客戶表單定義與潛在客戶訂閱設定。刻意排除潛在客戶記錄匯出,因為其中可能包含終端使用者 PII。pinterest_get_organic_inventory:讀取與廣告搭配使用的自然 Pinterest 內容:Pin、圖板、圖板上的 Pin、Pin 產品標籤或搜尋結果。這是庫存中繼資料,並非付費投放的證明。pinterest_get_pin_analytics:讀取付費 Pin 分析、自然多 Pin/單 Pin 分析、使用者帳戶分析、熱門 Pin 或熱門影片 Pin。傳入所選 Pinterest 端點支援的原始指標名稱。pinterest_get_platform_resources:讀取 Pinterest 平台中繼資料與整備資源:支援的廣告帳戶國家/地區、投放指標定義、指標整備狀態、潛在客戶表單問題、媒體上傳中繼資料、商務整合中繼資料或已驗證的使用者帳戶。pinterest_get_targeting_options:讀取 Pinterest 官方目標設定選項目錄,涵蓋應用程式類型、性別、語言地區、年齡、位置/地理、興趣、關鍵字或受眾。也可解析特定興趣 ID。pinterest_get_trends:讀取 Pinterest Trends:依支援地區的熱門成長/每月/每年/季節性關鍵字、成長中產品類別、產品類別詳細資料、精選主題或編輯文章。pinterest_get_video_upload:讀取此廣告主綁定已上傳影片的處理狀態。僅 ready:true 允許建立影片 Pin;註冊或 HTTP 204 並不足夠。pinterest_get_write_schema:在撰寫寫入操作前,讀取官方 Pinterest v5 原生請求結構描述與 Sandbox 限制。pinterest_health_check:唯讀 Pinterest Ads 健康檢查。驗證已設定的憑證、帳戶存取權、投放指標存取權及選用預設帳戶可讀性,而不暴露 OAuth 權杖。pinterest_list_ad_accounts:列出已設定憑證可存取的 Pinterest 廣告帳戶。pinterest_list_ad_creatives:列出廣告帳戶在所有狀態下的廣告創意(除非特別要求,API 會默默省略 ARCHIVED 廣告),並解析其 Pin 媒體:公開 i.pinimg.com 圖片 URL(最高 1200px)、影片封面,以及應用程式獲准讀取時的 video_url。目錄驅動格式預設排除。pinterest_prepare_video_upload(寫入):為凍結的 Launcher 影片註冊上傳,並在傳輸位元組前儲存其不透明收據。不會建立 Pin 或廣告。先預覽、確認、上傳,然後檢查處理狀態。pinterest_register_media(寫入):註冊媒體上傳;傳回的 upload_url/parameters 並不代表影片已上傳或已就緒。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_rename_ad(寫入):重新命名一個廣告。僅名稱會變更。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_rename_adgroup(寫入):重新命名一個廣告群組。僅名稱會變更。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_rename_campaign(寫入):重新命名一個行銷活動。僅名稱會變更。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_run_catalog_report:依 PRODUCT_GROUP 或 PRODUCT_ITEM 執行 Pinterest 目錄報表。PRODUCT_ITEM 歷史資料僅限今天(UTC)之前 92 天,請求會分塊為 31 天視窗;較舊的項目成效無法透過重試擷取。較舊的目錄投放總計請使用 PRODUCT_GROUP,而非個別 SKU 成效。pinterest_run_conversion_product_report:透過 reports/brand_category_sku 依品牌、類別、品牌+類別、SKU 或 SKU 群組執行 Pinterest 非同步轉換產品報表。這是受限制的 Pinterest 功能:僅有 Standard API 存取權並不保證用戶端可用。這與 PRODUCT_ITEM 花費報表分開。pinterest_run_report:執行唯讀 Pinterest Ads 報表。自動將舊/寬或明確的非同步請求路由至 Pinterest 非同步報表。使用原始 Pinterest 報表欄位名稱。pinterest_run_specialized_export:啟動或檢查非變更性的 Pinterest 資料作業,用於行銷組合建模(MMM)、大量廣告主實體下載或目錄診斷。START 僅建立報表/匯出成品;絕不會更新投放實體。pinterest_run_targeting_report:為廣告帳戶、行銷活動、廣告群組或廣告執行即時目標設定分析,並依年齡、性別、位置、興趣、關鍵字、受眾、版位、裝置或其他 Pinterest 目標設定類型細分。若資料早於同步視窗,請使用 pinterest_run_report 並搭配 targetingTypes 與 executionMode=async。pinterest_update_ad(寫入):更新原生廣告設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_ad_status(寫入):更新現有廣告的狀態。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_adgroup_budget(寫入):以主要帳戶貨幣單位設定恰好一個每日或總期間廣告群組預算。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_adgroup_configuration(寫入):更新原生廣告群組設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_adgroup_status(寫入):更新現有廣告群組的狀態。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_board(寫入):在選定的廣告主環境中更新 /boards。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_campaign_budget(寫入):以主要帳戶貨幣單位設定恰好一個每日或總期間行銷活動預算。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_campaign_configuration(寫入):更新原生行銷活動設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_campaign_status(寫入):更新現有行銷活動的狀態。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_catalog_feed(寫入):在選定的廣告主環境中更新 /catalogs/feeds。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_pin(寫入):更新 Pin。除 pins:write 外,還需要 Pinterest 受限的 pin_edit 權限;僅有 Standard 並不足夠。預設為預覽。不會自動重試變更。原生 API 適用資格與權限範圍仍適用。pinterest_update_product_group(寫入):在所選廣告主情境中更新 /catalogs/product_groups。預設為預覽。不會自動重試變更。原生 API 的適用資格與範圍仍適用。pinterest_update_product_group_promotion(寫入):更新目錄產品群組促銷活動。Sandbox 中無法使用。預設為預覽。不會自動重試變更。原生 API 的適用資格與範圍仍適用。pinterest_upload_video(寫入):將凍結的影片串流至 uploadReceipt 中儲存的原生目的地。不會將 bearer 憑證傳送至儲存空間。不會註冊其他媒體或啟用廣告。請接著執行 pinterest_get_video_upload。pinterest_validate_report:驗證並預覽 Pinterest 報表的執行方式。傳回同步/非同步路由、端點、層級、欄位、歸因設定與警告,且不會呼叫成效端點。
Google Ads(48 個工具,13 個寫入)
適用於已授權的指定帳戶。
google_ads_apply_plan(寫入):預覽、驗證並以原子方式套用 Google Ads v25 建置/變更計畫:廣告活動、預算、廣告群組、RSA/多媒體/需求開發廣告、圖片/文字/YouTube 素材、PMax 素材群組與連結、關鍵字、地理/語言指定目標清單群組,以及轉換動作設定(不含轉換事件上傳)。使用原生 REST camelCase 欄位;金額為明確指定貨幣的整數微單位。支援暫存負數資源 ID,以便在單一交易中依序建立。不支援建立 VIDEO 廣告活動(Google API 限制)、帳單、帳戶存取權變更、客戶名單或轉換上傳。新建的廣告活動/群組/廣告一律為 PAUSED。請先在不帶 confirm 的情況下呼叫,以檢視計畫並取得 planHash;validateOnly 會向 Google 詢問但不套用;執行時需要 confirm 及相符的 expectedPlanHash。使用 google_ads_run_gaql 讀回結果。在網路結果不確定時,務必先檢查其名稱/ID,再重試建立。google_ads_create_campaign(寫入):建立 Google Ads 廣告活動。一律以 PAUSED 狀態建立,且無法選擇建立為啟用狀態:必須有人先檢視過,它才會開始花費。同時建立廣告活動預算。預設為預覽。google_ads_generate_ad_group_themes:將提供的關鍵字整理到現有的 Google Ads 廣告群組中。傳回建議的廣告群組/廣告活動配對、正規化後的關鍵字文字,以及建議的比對類型,不會建立或編輯關鍵字。唯讀 Keyword Planner RPC。google_ads_generate_keyword_forecast_metrics:針對暫存關鍵字廣告活動預測點擊次數、CPC、費用、轉換次數與 CPA。支援地區與語言指定目標、比對類型、三種出價策略、明確的未來日期,以及可選的獨立逐關鍵字細分。此唯讀的無計畫 RPC 不會建立廣告活動或儲存的計畫。google_ads_generate_keyword_historical_metrics:取得所提供關鍵字的 Keyword Planner 搜尋量歷史記錄。傳回平均每月搜尋量、每月搜尋量(最多 48 個月)、最新搜尋量、計算出的 3 個月與年增率變化、競爭程度、CPC/出價範圍、近似變體,以及可選的裝置總計。此為唯讀的無計畫 RPC。google_ads_generate_keyword_ideas:從最多 20 個種子關鍵字、一個 URL、關鍵字加 URL,或整個網站探索 Keyword Planner 構想。傳回歷史搜尋量、每月趨勢、計算出的 3 個月/年增率變化、競爭程度、出價、近似變體、可選的概念,以及分頁。唯讀;不會儲存任何計畫。google_ads_get_account_details:取得特定 Google Ads 客戶帳戶的詳細資訊。google_ads_get_account_hierarchy:列出可存取的客戶,並在可能時從 GAQL customer_client 列出管理員/客戶關係。若無法使用階層查詢,則退回列出可存取的客戶。google_ads_get_adgroups:列出 Google Ads 帳戶的廣告群組,可選擇依廣告活動篩選。google_ads_get_bidding_strategies:列出組合出價策略。僅在提供 startDate/endDate 時包含指標;否則僅傳回結構。google_ads_get_budgets:列出廣告活動預算,包含金額、狀態、放送方式,以及支援時的建議預算欄位。google_ads_get_campaigns:列出 Google Ads 帳戶的廣告活動,包含狀態、預算、管道類型與出價策略。google_ads_get_change_events:擷取最近的 change_event 資料列。強制執行 Google Ads 限制:日期範圍須在最近 30 天內,且 LIMIT <= 10000。google_ads_get_conversion_actions:列出轉換動作,包含狀態、類型、類別、主要/納入轉換旗標、擁有者客戶,以及支援時的最後活動日期。google_ads_get_demand_gen_assets:列出需求開發廣告(影片回應式、多素材、輪播),並解析其參照的廣告素材:穩定的圖片 URL 與 YouTube 影片 ID,附嵌入與縮圖 URL。可補足涵蓋 Performance Max 的 google_ads_get_pmax_assets。google_ads_get_insights:以智慧查詢規劃查詢 Google Ads 成效洞察。自動產生 GAQL,並透過拆分查詢處理指標/區隔不相容的問題。 可用指標請參閱 google-ads://metrics,維度請參閱 google-ads://dimensions。google_ads_get_keyword_performance:從 keyword_view 資源取得關鍵字層級成效資料。顯示品質分數、曝光次數、點擊次數、費用。google_ads_get_landing_pages:擷取 landing_page_view 成效,包含最終到達網址、廣告活動/廣告群組脈絡、流量、轉換,以及支援時的到達網頁品質指標。google_ads_get_paid_organic_search_terms:唯讀的付費/自然搜尋字詞報表。在可用時使用 paid_organic_search_term_view,若自然欄位不可用則退回僅付費的 search_term_view。google_ads_get_pmax_asset_diagnostics:唯讀的 Performance Max 素材群組診斷。傳回廣告強度、素材涵蓋率待辦事項、主要狀態原因、可選的成效指標,以及可選的頂尖素材組合。google_ads_get_pmax_assets:從 asset_group_asset 列出 Performance Max 素材群組素材,包含素材群組/廣告活動脈絡及可選的日期範圍成效指標。google_ads_get_pmax_placements:從 performance_max_placement_view 取得唯讀的 Performance Max 刊登位置診斷。僅傳回刊登位置類型、顯示名稱、目標 URL、廣告活動脈絡與曝光次數。google_ads_get_recommendations:列出 Google Ads 建議,包含類型、資源、廣告活動/廣告群組連結、已忽略狀態,以及支援時的影響。google_ads_get_search_terms:依 reportType 從 search_term_view 或 campaign_search_term_insight 擷取搜尋字詞成效。google_ads_get_shopping_performance:以 Merchant Center 產品維度為鍵的唯讀購物成效報表。適合將花費/轉換與商家 ID、商品 ID、標題、品牌、動態饋給標籤及自訂標籤連結。google_ads_get_shopping_products:透過 shopping_product 取得唯讀的 Merchant Center 產品目錄/資格報表。支援帳戶、廣告活動與廣告群組範圍,並在帳戶有購物/PMax 電子商務資料時提供成效指標。google_ads_get_simulations:唯讀的規劃/預測查詢,用於廣告活動、廣告群組或組合出價模擬。在可用時傳回模擬中繼資料與預測點清單,並提供中繼資料備援。google_ads_get_video_upload:讀取所選客戶中某個 Google Ads 上傳項目的處理狀態與 YouTube 影片 ID。僅在 state=PROCESSED 後使用傳回的 videoId。此為讀取;不會再次上傳。google_ads_health_check:唯讀的連線檢查。驗證憑證是否存在、Google Ads API 存取權、登入客戶可見性、API 版本,以及可採取行動的警告,且不會傳回機密資訊。google_ads_list_accounts:列出目前憑證可存取的 Google Ads 客戶帳戶。若可存取的客戶是管理員帳戶,也會嘗試從 customer_client 納入已啟用的子帳戶。google_ads_list_image_assets:列出帳戶的圖片素材庫(FROM asset),包含在 tpc.googlesyndication.com 上穩定、公開提供的完整尺寸 URL、尺寸、檔案大小與 MIME 類型。這是完整庫存,不帶任何放送概念:2022 年上傳且從未放送的素材,看起來與今天正在放送的素材完全相同。依最新優先排序,因此 limit 會傳回最近的素材,而非任意切片,且回應中的計數為帳戶總數。若只要檢視含日期區間放送情況的視覺化素材庫,請使用 get_creative_gallery(涵蓋 Performance Max)。僅在需要 KPI 卡片時才要求 get_creative_performance。購物產品圖像位於 Merchant Center,不在此素材庫中。google_ads_list_video_assets:列出帳戶的 YouTube 影片素材(FROM asset),包含衍生的觀看、嵌入與公開縮圖 URL。這是完整庫存,不帶任何放送概念:多年前上傳且從未放送的素材,看起來與今天正在放送的素材完全相同。依最新優先排序,因此 limit 會傳回最近的素材,而非任意切片,且回應中的計數為帳戶總數。若只要檢視含日期區間放送情況的視覺化素材庫,請使用 get_creative_gallery(涵蓋 Performance Max)。僅在需要 KPI 卡片時才要求 get_creative_performance。Google Ads 不提供可下載的影片檔案:PMax 與需求開發影片託管於 YouTube,因此請透過嵌入或縮圖顯示。google_ads_remove_video_upload(寫入):移除所選廣告帳戶擁有的影片上傳項目。會刪除已上傳的 YouTube 影片,並可能使參照該影片的廣告無法運作。需要預覽及相符的 expectedPlanHash。Google v25 將標題/說明標示為不可變更;此工具不會假裝能編輯它們。google_ads_rename_account(寫入):重新命名 Google Ads 帳戶(其描述性名稱)。其他內容皆不變。預設為預覽。google_ads_rename_adgroup(寫入):重新命名 Google Ads 廣告群組。名稱是唯一變更的項目:放送、出價與素材皆不受影響。預設為預覽。google_ads_rename_asset_group(寫入):重新命名 Google Ads Performance Max 素材群組。名稱是唯一變更的項目:放送、出價與素材皆不受影響。預設為預覽。google_ads_rename_campaign(寫入):重新命名 Google Ads 廣告活動。名稱是唯一變更的項目:放送、預算與指定目標皆不受影響。預設為預覽。google_ads_run_gaql:執行原始 GAQL(Google Ads Query Language)查詢。可完全靈活滿足任何報表需求。 範例:SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100。google_ads_run_readonly_rpc:唯讀的進階逃生口,用於 GAQL 以外、列入允許清單的 Google Ads 服務:目標對象洞察、觸及率規劃工具、基準、創作者/熱門洞察、指定目標建議、智慧廣告活動建議、身分驗證、發票與付款帳戶。操作為列舉;任意路徑及所有變更/上傳皆不可能。google_ads_search_fields:搜尋 Google 即時的 GoogleAdsField 目錄。探索每個可查詢的 GAQL 資源、屬性、區隔、指標、列舉值,以及可搭配選取的相容性關係。唯讀,適合在執行原始 GAQL 查詢前使用。google_ads_suggest_geo_targets:將最多 25 個地點名稱或地理目標 ID 解析為 Google Ads geoTargetConstants。傳回條件 ID、標準名稱、目標類型、狀態、上層、語言地區與約略觸及範圍。唯讀。google_ads_update_adgroup_bid(寫入):變更 Google Ads 廣告群組的預設 CPC 出價。金額以帳戶貨幣計(1.20 代表 1.20 EUR)。對使用自動出價策略的廣告活動無效。預設為預覽。google_ads_update_adgroup_status(寫入):暫停、重新啟用或移除 Google Ads 廣告群組。預設為預覽。google_ads_update_campaign_budget(寫入):變更 Google Ads 廣告活動的每日預算。金額以帳戶貨幣計(12.50 代表 12.50 EUR)。預設為預覽。google_ads_update_campaign_schedule(寫入):變更 Google Ads 廣告活動的開始或結束日期。日期為帳戶時區的 YYYY-MM-DD。預設為預覽。google_ads_update_campaign_status(寫入):暫停、重新啟用或移除 Google Ads 廣告活動。預設為預覽:若無 confirm: true,工具只會描述變更而不套用。google_ads_upload_video(寫入):將 MP4/WebM/QuickTime 位元組(最大 16 MiB)上傳至所選廣告帳戶的 Google 代管 YouTube 頻道。瀏覽權限為 UNLISTED:任何有連結的人皆可檢視,並非私人。預設預覽會省略位元組並傳回 planHash;confirm 需要 expectedPlanHash。此 API 沒有 validateOnly。上傳後,使用 google_ads_run_gaql 查詢 you_tube_video_upload.state 與 video_id;僅在 PROCESSED 後,透過 google_ads_apply_plan assetOperation.youtubeVideoAsset 使用影片 ID。上傳結果不確定後,請勿自動重試。google_ads_validate_query:在執行查詢前先驗證指標/維度/資源的相容性。檢查區隔限制與資源可用性。
TikTok Ads(65 個工具,30 個寫入)
適用於已授權的指定帳戶。
tiktok_create_adgroup(寫入):建立已停用的傳統 TikTok 廣告群組。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_ads(寫入):建立已停用的傳統 TikTok 廣告(影片、圖片、輪播或經授權的 Spark 內容)。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_campaign(寫入):建立 TikTok 行銷活動。一律以停用狀態建立,且無法選擇以執行中狀態建立。預設為預覽。tiktok_create_campaign_advanced(寫入):建立已停用的傳統 TikTok 行銷活動。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_cta_portfolio(寫入):根據 creative/cta/recommend 為此廣告主傳回的完全相同已核准建議,建立動態 CTA 作品集。將其 result.creative_portfolio_id 用作 Smart+ Spark 網站/應用程式廣告的 ad_configuration.call_to_action_id。不會建立廣告,也不會變更投放狀態。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_custom_identity(寫入):為 Pangle 或 Global App Bundle 建立廣告主擁有的 CUSTOMIZED_USER 廣告身分。不會建立公開的 TikTok 個人檔案,也不會啟用投放。自訂身分無法用於新的 TikTok 版位廣告。使用 TikTok 的預設大頭貼。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_ad(寫入):建立已停用的升級版 Smart+ TikTok 廣告(影片、圖片、輪播或經授權的 Spark 內容)。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_adgroup(寫入):建立已停用的升級版 Smart+ TikTok 廣告群組。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_campaign(寫入):建立已停用的升級版 Smart+ TikTok 行銷活動。無法選擇以啟用狀態啟動。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_get_adgroups:讀取完整的原生廣告群組設定,包括目標鎖定、自訂/類似廣告受眾參照與排除、地理、語言、年齡/性別、版位、興趣/行為、預算與排程。針對升級版 Smart+ targeting_spec 設定 smartPlus:true。缺少的欄位代表未知,而非無限制的目標鎖定。分頁。tiktok_get_ads:列出 TikTok 廣告主的廣告。傳回廣告 ID、名稱、操作狀態與創意資訊。tiktok_get_advertiser_info:取得特定 TikTok 廣告主帳戶的詳細資訊:貨幣、時區、狀態、餘額。tiktok_get_asset_urls:為特定 TikTok 素材庫資產(file/video/ad/info 與 file/image/ad/info)重新解析全新、可公開擷取的 URL。請在顯示或下載時呼叫:每個 TikTok 媒體 URL 皆經過簽署且會過期。tiktok_get_async_report_status:在非同步報表端點可用時,依 taskId 檢查 TikTok 非同步報表工作狀態。不會建立或變更報表。tiktok_get_audience_details:在 TikTok DMP 端點可存取時,取得自訂/類似/已儲存廣告受眾詳細資料。僅限唯讀。tiktok_get_audience_overlap:跨廣告群組、自訂廣告受眾、已儲存廣告受眾與目標鎖定欄位的唯讀廣告受眾重疊診斷。tiktok_get_audience_report:依年齡或性別在廣告主、行銷活動、廣告群組或廣告層級讀取 TikTok AUDIENCE 成效報表,包括來自符合資格 Smart+ 行銷活動的投放。多個人口統計資料會傳回個別報表,而非聯合分佈。明確分頁與原生供應商錯誤;不會推斷已設定的目標鎖定或自訂廣告受眾成員資格。tiktok_get_audiences:列出 TikTok 廣告主帳戶的自訂與類似廣告受眾。tiktok_get_campaigns:列出 TikTok 廣告主帳戶的行銷活動。傳回行銷活動 ID、名稱、狀態、預算與目標。tiktok_get_carousel_music:為標準(非目錄)圖片廣告(單一卡片)或輪播中完全相同的已上傳圖片取得 TikTok 音樂建議。驗證每張圖片皆可用於輪播。唯讀;在核准預覽中選擇傳回的 music_id,並在廣告中使用相同的圖片。音樂僅限於 TikTok 上使用。tiktok_get_creative_fatigue_recipes:從廣告層級每日報表找出可能的創意疲勞模式,並傳回唯讀的更新配方。不會建立、編輯或上傳創意。tiktok_get_creatives:取得 TikTok 廣告主帳戶中特定廣告的創意詳細資料(影片、圖片、文字)。tiktok_get_delivery_status:彙總行銷活動、廣告群組與廣告的投放狀態/operation_status,並提供簡單診斷。tiktok_get_entities_raw:列出 TikTok 行銷活動、廣告群組或廣告,並由呼叫端選擇原生欄位、篩選、排序與分頁。此僅限 GET 的逃生通道可公開新推出的實體欄位,無須等待 MCP 的策劃結構描述。tiktok_get_events:探索廣告主的像素/應用程式事件或可存取的追蹤診斷。使用盡力而為的端點檢查,並以報表維度作為後備。tiktok_get_insights:使用目前原生/計算指標目錄與查詢規劃,查詢 TikTok Ads 成效洞察。 使用 tiktok://metrics 資源查看可用指標。使用 tiktok://dimensions 查看維度。 年齡/性別維度會透過 tiktok_get_audience_report 自動路由至 AUDIENCE 報表,包括行銷活動/廣告群組層級。其他維度使用 BASIC 規劃器。多個廣告受眾細分會保持為個別報表,絕不會合併。tiktok_get_pixels:列出 TikTok 像素,並在權限允許時列出像素事件中繼資料。端點無法使用時會以明確警告後備。tiktok_get_read_endpoint:進階僅限 GET 的 TikTok Business API 逃生通道,適用於尚未由專用 MCP 工具建模的已記載 JSON 讀取端點。會驗證相對 v1.3 路徑與 JSON 相容查詢參數;OAuth、變更、下載與潛在客戶記錄路徑會被封鎖。tiktok_get_report_raw:以呼叫端選擇的維度與指標執行原生 TikTok BASIC 或 AUDIENCE 同步報表。AUDIENCE 支援行銷活動/廣告群組層級的年齡/性別等人口統計資料;tiktok_get_audience_report 提供引導式路徑。當目前 API 欄位尚未納入 tiktok://metrics 時使用;與 tiktok_get_insights 不同,此工具不會計算別名或自動拆分不相容的選擇。tiktok_get_search_ads_maturity:從關鍵字/搜尋詞報表與選用的關鍵字建議端點診斷 TikTok 搜尋廣告成熟度。僅限唯讀診斷。tiktok_get_shop_catalog_diagnostics:唯讀的 TikTok Shop/目錄/電子商務診斷。先嘗試目錄報表,再嘗試 Shop 競價指標,並在目錄權限無法使用時傳回端點警告。tiktok_get_spark_ads:在可用時從廣告欄位傳回 Spark Ads 內容,若支援 Spark 特定欄位則採用保守後備。tiktok_get_spark_organic_joins:在權限允許時,將可存取的 Spark Ads 欄位與付費粉絲頁/貼文報表及選用的自然身分/貼文端點合併。僅限唯讀。tiktok_get_targeting:讀取已設定的廣告群組目標鎖定與廣告受眾參照:自訂/類似納入/排除、地理、語言、年齡/性別、版位、興趣與行為。支援傳統與升級版 Smart+(smartPlus:true),保留 targeting_spec 與自動目標鎖定設定。不會推斷已投放的廣告受眾或隱藏的 Smart+ 訊號。使用 tiktok_get_audiences 取得廣告受眾名稱/類型,並使用 tiktok_get_audience_report 取得已投放的人口統計資料。tiktok_get_targeting_catalog:讀取 TikTok 目標鎖定與規劃目錄:地點、語言、興趣、行為、主題標籤、搜尋廣告關鍵字構想/健康度、裝置、電信業者、情境標籤、內容排除與時區。tiktok_get_uploaded_video:從此廣告主的媒體庫讀取一支已上傳的影片。僅在其媒體資訊可用且具有正的時長與尺寸後才傳回就緒。不會再次上傳。tiktok_get_video_assets:在可用時從 ad/get 與影片素材端點傳回廣告連結的 TikTok 影片資產中繼資料。tiktok_get_write_context:在編輯或建立新設定之前,讀取確切的 TikTok 實體、上層設定與廣告主貨幣/時區。唯讀。tiktok_health_check:TikTok 憑證、可存取廣告主與廣告主資訊的唯讀健康檢查。絕不會傳回權杖或密鑰。tiktok_list_ad_images:列出廣告主的整個圖片庫(file/image/ad/search):檔案名稱、尺寸、簽章、輪播可用性,以及約簽署三十天的公開提供圖片 URL(image_url_expires_at 提供確切時間點)。tiktok_list_ad_videos:列出廣告主的整個影片庫(file/video/ad/search):檔案名稱、時長、尺寸、簽章,以及公開提供的預覽與封面 URL。每個 TikTok URL 皆經過簽署且約六小時後過期:使用前請以 tiktok_get_asset_urls 重新解析。tiktok_list_advertisers:列出目前權杖可存取的所有 TikTok 廣告主帳戶。傳回廣告主 ID、名稱與狀態。tiktok_rename_ad(寫入):重新命名一個傳統 TikTok 廣告。不會變更其預算、創意內容或狀態。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_rename_adgroup(寫入):重新命名一個傳統 TikTok 廣告群組。不會變更其預算、創意內容或狀態。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_rename_advertiser(寫入):重新命名 TikTok 廣告帳戶(廣告主)本身。適用於在 Business Center 中建立、由 Business Center 管理員建立的廣告帳戶。不會變更帳單、公司詳細資料或投放。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_rename_campaign(寫入):重新命名一個傳統 TikTok 行銷活動。不會變更其預算、創意內容或狀態。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_search_keywords:取得 TikTok 搜尋廣告的關鍵字建議。傳回附搜尋量估計的建議關鍵字。tiktok_update_ad_status(寫入):暫停或重新啟用恰好一個傳統廣告。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_adgroup_budget(寫入):變更 TikTok 廣告群組的預算。金額以帳戶貨幣為單位,依原樣傳送。預設為預覽。tiktok_update_adgroup_configuration(寫入):更新傳統 TikTok 廣告群組。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_adgroup_status(寫入):暫停或重新啟用 TikTok 廣告群組。預設為預覽。tiktok_update_ads(寫入):更新傳統 TikTok 廣告(影片、圖片、輪播或經授權的 Spark 內容)。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_campaign_budget(寫入):變更 TikTok 行銷活動預算,以帳戶貨幣為單位。預設為預覽。tiktok_update_campaign_configuration(寫入):更新傳統 TikTok 行銷活動。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_campaign_status(寫入):暫停或重新啟用 TikTok 行銷活動。預設為預覽。tiktok_update_smart_plus_ad(寫入):更新已升級的 Smart+ TikTok 廣告(影片、圖片、輪播或授權的 Spark 內容)。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_ad_status(寫入):暫停或重新啟用恰好一個 Smart+ 廣告。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_adgroup(寫入):更新已升級的 Smart+ TikTok 廣告群組。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_adgroup_status(寫入):暫停或重新啟用恰好一個 Smart+ 廣告群組。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_campaign(寫入):更新已升級的 Smart+ TikTok 行銷活動。狀態維持不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_campaign_status(寫入):暫停或重新啟用恰好一個 Smart+ 行銷活動。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_material_status(寫入):暫停或重新啟用一個已升級 Smart+ 廣告中所選的創意素材。上層行銷活動、廣告群組和廣告狀態維持不變;共用素材庫資產不會被修改。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_upload_ad_image(寫入):從公開的 HTTPS 媒體 URL 或 base64 檔案(最大 5 MiB)匯入圖片。單一傳回的媒體 ID 會暴露於 media.id,原生回執則保留在 result 中。TikTok 可能會非同步處理;接受並不代表媒體已就緒。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_upload_ad_video(寫入):從公開的 HTTPS 媒體 URL 或 base64 檔案(最大 5 MiB)匯入影片。單一傳回的媒體 ID 會暴露於 media.id,原生回執則保留在 result 中。TikTok 可能會非同步處理;接受並不代表媒體已就緒。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_validate_query:在執行前驗證 TikTok 指標/維度組合。檢查維度分組規則、生命週期相容性,以及指標/維度相容性。
Search Console(18 個工具,0 個寫入)
適用於已授權的選定帳戶。
gsc_analyze_search_appearance_trends:當 GSC 提供 searchAppearance 維度時,透過 Search Analytics 的 searchAppearance 維度分析結構化資料與複合式搜尋結果的趨勢訊號。gsc_bulk_inspect_urls:以保守的循序限制與正規化後的 URL Inspection 結果檢查多個 URL。配額:每個資源每天 2000 次請求。gsc_cluster_queries:依簡單詞元與意圖訊號將 Search Console 查詢分群:品牌/非品牌、問句、類別與主題詞元。gsc_compare_search_types:比較 Search Console 各搜尋類型的成效:web、image、video、news、discover 與 Google News。gsc_detect_cannibalization:在 Search Analytics 的查詢-頁面資料列中,偵測多個頁面競逐點擊/曝光次數的查詢。gsc_find_losses_gains:比較兩個期間的查詢或頁面成效,並回傳點擊/曝光/CTR/排名差異。gsc_get_data_freshness:透過查詢近期的每日資料列,偵測 Search Analytics 資料的最新日期。gsc_get_sitemap_health:回傳增強的唯讀 sitemap 健康摘要,包含狀態總計、已提交/已索引的內容數量、警告與錯誤。gsc_health_check:驗證 Google Search Console 唯讀驗證、可見資源、已設定的預設網站與權限層級,且不暴露權杖。gsc_indexation_watchlist:針對關鍵 URL 的唯讀 URL Inspection 監看清單。最多檢查 10 個 URL,並回傳警示/待審查/正常評估,不儲存狀態。gsc_inspect_url:檢查 URL 的 Google 索引狀態、檢索資訊、行動裝置可用性、AMP 與複合式搜尋結果。配額:每個資源每天 2000 次請求。gsc_list_sitemaps:列出為 Search Console 資源提交的 sitemap,包含處理狀態與已提交/已索引數量。gsc_list_sites:列出目前憑證可存取的所有 Google Search Console 資源。gsc_monitor_indexation_freshness:唯讀監控快照,包含 Search Analytics 資料新鮮度、sitemap 索引總計,以及可選的小型 URL Inspection 取樣。gsc_plan_large_site_sampling:依據 sitemap 風險訊號與 Search Analytics 頁面成效,為大型網站建立唯讀的 URL Inspection 取樣計畫。gsc_query_search_analytics:查詢 Google Search Console Search Analytics。回傳查詢、頁面、國家/地區、裝置、日期與搜尋外觀的點擊次數、曝光次數、CTR 與平均排名。 可用欄位與規則請使用 gsc://metrics、gsc://dimensions、gsc://filters 與 gsc://compatibility。gsc_track_sitemap_deltas:唯讀 sitemap 差異追蹤器。擷取目前的 sitemap 快照,並與代理程式提供的基準進行比較;不寫入任何狀態。gsc_validate_query:在執行前驗證 Search Console 指標/維度/搜尋類型的組合。
Google Analytics 4(27 個工具,0 個寫入)
適用於已授權的選定帳戶。
ga4_batch_run_pivot_reports:在單一官方 Data API 批次請求中,為同一資源執行 1-5 個獨立的唯讀 GA4 樞紐分析報表。ga4_batch_run_reports:在單一官方 Data API 批次請求中,為同一資源執行 1-5 個獨立的唯讀 GA4 Core 報表。ga4_check_compatibility:向官方 GA4 Data API 詢問哪些維度與指標與所提出的 Core 報表選取項目相容。ga4_get_audience_diagnostics:唯讀的目標對象診斷,來源包含 Admin API 目標對象、Data API 週期性目標對象清單,以及觀察到的 audienceName 報表備援。ga4_get_audience_export_diagnostics:唯讀的 Audience Export 診斷。列出既有的目標對象匯出、狀態計數,並可選擇從既有匯出中取樣資料列。ga4_get_bigquery_export_diagnostics:偵測 GA4 BigQuery 匯出連結,並診斷匯出模式、串流涵蓋範圍、排除的事件與資料集位置。ga4_get_channel_groups:列出為 GA4 資源定義的自訂管道群組。ga4_get_custom_definitions:列出 GA4 Data API 中繼資料所暴露的自訂維度與自訂指標。作為自訂定義清冊的唯讀備援。ga4_get_ecommerce_diagnostics:唯讀的電子商務涵蓋範圍診斷,涵蓋指定日期範圍內的核心電子商務事件、收益指標與項目層級報表。ga4_get_event_parameters:盡力從 GA4 中繼資料與事件報表建立事件參數清冊。記錄 Data API 對原始參數的限制。ga4_get_key_events:使用具中繼資料感知的 Data API 報表清點 GA4 關鍵事件/轉換。回傳盡力取得的事件名稱與計數。ga4_get_metadata:取得特定 GA4 資源可用的完整維度與指標清單。適合用來探索自訂維度/指標。ga4_get_property_configuration:讀取 GA4 資源詳細資料,以及選定的單一 Admin 設定(歸因、資料保留、Google Signals、報表識別或使用者提供資料設定)。ga4_get_property_quotas_snapshot:從官方 v1alpha 端點讀取目前的 GA4 Data API 資源配額快照。這不會執行報表,但 Google 仍會向剩餘配額最多的類別扣除一個資源配額權杖。ga4_get_server_side_tagging_diagnostics:盡力提供唯讀的伺服器端代碼標記診斷,來源包含資料串流、Measurement Protocol 密鑰、事件規則與串流設定。ga4_health_check:唯讀的 GA4 健康檢查。驗證已設定的憑證、可存取的資源,以及中繼資料/資源存取權,且不暴露 OAuth 權杖。ga4_list_accounts:列出已驗證使用者可存取的原始 GA4 Analytics Admin 帳戶(唯讀、自動分頁)。ga4_list_admin_resources:以唯讀模式列出允許清單中的 GA4 Admin 集合:串流、自訂定義、關鍵事件、目標對象、產品連結、註解、管道群組、擴充資料集、子資源/匯總設定與存取權繫結。ga4_list_audience_exports:列出既有的 GA4 Audience Export 快照與週期性目標對象清單,不建立新的匯出。ga4_list_properties:列出目前憑證可存取的所有 GA4 資源。回傳資源 ID、顯示名稱、時區與貨幣。ga4_query_audience_export:從既有的 GA4 Audience Export 查詢資料列。使用者/裝置識別碼預設會遮蔽;僅透過明確選擇加入才包含。ga4_run_advanced_funnel_report:執行 GA4 Data API v1alpha 的 runFunnelReport 端點,可選擇性提供細分/後續動作;若無法使用,則退回唯讀的步驟計數。ga4_run_funnel_recipe:使用每個 eventName/pagePath 步驟各一份 GA4 報表,執行可設定的唯讀漏斗配方,並回傳簡單的步驟計數。ga4_run_pivot_report:執行唯讀的 GA4 Data API 樞紐分析報表,支援原生篩選、排序、配額狀態、多個日期範圍,以及最多 250,000 個樞紐儲存格。每個樞紐分析都必須明確指定限制。ga4_run_realtime_report:執行唯讀的 GA4 Data API 即時報表。即時報表僅支援有限的維度與指標子集。ga4_run_report:以智慧查詢規劃執行 GA4 分析報表。支援 52 個指標、63 個維度、自動分頁。 可用欄位請使用 ga4://metrics 與 ga4://dimensions 資源。每個請求最多 9 個維度 + 10 個指標。ga4_validate_query:在執行前驗證指標/維度組合。檢查上限(9 個維度、10 個指標)、電子商務規則與維度相容性。
要保留的 MCP 伺服器名稱:Get MCP Ads Markdown 區塊:22/22 目標語言:繁體中文