更新廣告行銷活動

本頁面針對您加入合約合作夥伴廣告的合約合作夥伴（賣家），提供更新廣告行銷活動的步驟。

準備工作

在為合作夥伴更新廣告行銷活動之前，請確認您已完成以下步驟：

必要權限

若要呼叫賣家廣告更新 API，用戶需要下列權限：

賣家企業管理平台管理員

目標設定為數位服務法（DSA）監管地點（歐盟）

對於目標設定為歐盟（EU）和／或相關地區的廣告行銷活動，dsa_payor 和 dsa_beneficiary 為必要欄位。這 2 個欄位中提供的資訊會對終端用戶顯示，指出誰是廣告的付費者，以及誰是廣告的受益者。若未提供這些欄位，廣告商將無法編輯 MPA 行銷活動，且 API 會傳回失敗回應和下面列出的錯誤代碼。

賣家廣告更新 API 呼叫

要求

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "campaign_group_id=123456789&lifetime_budget=100000" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

對 API 呼叫的回應會附帶 ASYNC_SESSION_ID 立即傳回。在繼續處理要求時，應輪詢 ASYNC_SESSION_ID，直到達到最終狀態 [COMPLETED|FAILED]。

參數

名稱	說明
`campaign_group_id` 字串	必要項目。需要更新之行銷活動的編號。
`campaign_group_status` 字串	選用項目。 `ACTIVE` 或 `PAUSED`
`dsa_payor` 字串（最多 512 個字元）	選用項目。行銷活動的付費者。注意：對於目標設定為歐盟（EU）和／或相關地區的行銷活動，此為必要欄位。
`dsa_beneficiary` 字串（最多 512 個字元）	選用項目。行銷活動的受益者。注意：對於目標設定為歐盟（EU）和／或相關地區的行銷活動，此為必要欄位。
`end_time` 日期時間	選用項目。廣告行銷活動的新結束時間（使用 UTC UNIX 時間戳記）。結束時間不能更新為舊的結束時間之前，必須在之後。
`lifetime_budget` 數值字串	選用項目。行銷活動的新預算（使用廣告帳號的幣別）。預算不能更新為小於舊的預算，必須更大。

回應

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

使用 ASYNC_SESSION_ID 取得已加入合約合作夥伴廣告之賣家的對應編號。

請參閱如何輪詢非同步連線階段以取得回應，瞭解更多資訊。

成功回應

如果狀態為 COMPLETED，則輪詢非同步連線階段所產生的資料如下所示：

{
  "result": "{\"id\":\"<NEWLY_UPDATED_CAMPAIGN_ID>\",\"success\":true}",
  "id": "<ASYNC_SESSION_ID>"
}

失敗回應

如果狀態為 FAILED，則輪詢非同步連線階段所產生的資料如下所示：

錯誤代碼

錯誤代碼	錯誤子代碼	說明
1800700	2310172	輸入為此廣告組合付費的個人或組織。
1800701	2310171	輸入從此廣告組合受益的個人或組織。

瞭解詳情

如何輪詢非同步連線階段以取得回應