建立和刊登廣告行銷活動

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

準備工作

在為合作夥伴建立和刊登廣告行銷活動之前，請確認您已完成以下步驟：

必要權限

若要呼叫賣家廣告建立 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": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

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

參數

名稱	說明
`conversion_domain` 字串	必要項目。設定廣告建立流程中的轉換網域。 `conversion_domain` 欄位應與 Meta 像素配置相符。此欄位應僅包含第一層級和第二層級網域，而不是完整的網址。例如，facebook.com。
`custom_event_type` 列舉	選用項目。在開發潛在顧客廣告和再行銷廣告中所要最佳化的應用程式事件。值：`CONTENT_VIEW`、`ADD_TO_CART`、`PURCHASE` 條件：僅限在 `use_marketplace_template` 為 `true` 且 `use_seller_template` 為 `false` 時，才能指定此欄位。
`dsa_payor` 字串（最多 512 個字元）	選用項目。行銷活動的付費者。注意：對於目標設定為歐盟（EU）和／或相關地區的行銷活動，此為必要欄位。
`dsa_beneficiary` 字串（最多 512 個字元）	選用項目。行銷活動的受益者。注意：對於目標設定為歐盟（EU）和／或相關地區的行銷活動，此為必要欄位。
`end_time` 日期時間	必要項目。廣告行銷活動的結束時間（使用 UTC UNIX 時間戳記）。
`lifetime_budget` 數值字串	必要項目。以廣告帳號幣別表示的行銷活動預算。在廣告界，換算倍率（offset）可以是 1 或 100（用於具有「分」概念的幣別）。例如，美元（換算倍率 100）的 `lifetime_budget = 1` 表示 1/100（換算倍率）= $0.01（1 美分）。日元（換算倍率 1）的 `lifetime_budget = 1` 表示 1/1（換算倍率）= ¥1（1 日元）。
`override_creative_text` 字串	必要項目。廣告創意內文。
`override_targeting_countries` 清單<strings>	選用項目。行銷活動目標設定的國家／地區。這會覆寫在建立賣家企業管理平台期間，針對開發潛在顧客廣告和再行銷廣告設定的國家／地區。
`product_set_id` 數值字串	選用項目。賣家商品目錄中的商品組合編號，此行銷活動將在其所有廣告中宣傳該商品組合。
`start_time` 日期時間	必要項目。廣告行銷活動的開始時間（使用 UTC UNIX 時間戳記）。
`use_marketplace_template` 布林值	選用項目。指定此欄位可使用全球所有賣家通用的預設範本來建立行銷活動。條件：必須使用 `use_marketplace_template` 或 `use_seller_template`，但兩者不能同時使用。
`use_seller_template` 布林值	選用項目。指定此欄位可使用套用於賣家的自訂範本來建立行銷活動。條件：必須使用 `use_marketplace_template` 或 `use_seller_template`，但兩者不能同時使用。

回應

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

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

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

成功回應

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

{
  "result": "{\"id\":\"<NEWLY_CREATED_CAMPAIGN_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

失敗回應

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

錯誤代碼

錯誤代碼	錯誤子代碼	說明
1800011	2310154	廣告創意貼文是由處於開發模式的應用程式所建立。應用程式必須處於公開模式，才能建立此廣告。
1800103	2310155	企業管理平台 {seller_business_id} 缺少共享目錄子集。這可能是因為加入程序不完整所導致。您可以使用協作中心來共享資產並新增目錄子集，或是使用賣家刪除 API 來刪除賣家，然後使用非同步賣家加入 API 將其重新加入。您也可以聯絡 Meta 合作夥伴尋求協助。
1800104	2310156	您輸入的編號 {product_set_id} 不是商品組合編號。請輸入與目錄編號 {catalog_id} 相關聯的商品組合編號。
1800105	2310157	您輸入的編號 {product_set_id} 不是商家目錄子集的商品組合編號。請輸入與目錄編號 {catalog_id} 相關聯的商品組合編號。
1800208	2310152	此商家的廣告帳號因違反我們的廣告政策或其他標準而被停用。若要進一步瞭解，請前往協作中心的「合作夥伴」，選擇「合約合作夥伴」和「品質問題」頁籤。您也可以聯絡 Meta 合作夥伴尋求協助或申訴。
1800209	2310153	輸入的廣告帳號 {account_id} 不是隨著合約合作夥伴廣告所建立。請輸入將此商家加入合約合作夥伴廣告時，為其建立的帳號編號。
1800308	2310137	此商家的企業管理平台 {seller_business_id} 缺少賣家粉絲專頁。這可能是因為加入程序不完整所導致。您可以使用賣家刪除 API 來刪除賣家，然後使用非同步賣家加入 API 將其重新加入。您也可以聯絡 Meta 合作夥伴尋求協助。
1800309	2310159	此商家的賣家粉絲專頁可能因違反我們的廣告政策或其他標準而被停用，無法用來刊登廣告。若要進一步瞭解，請前往協作中心的「合作夥伴」，選擇「合約合作夥伴」和「品質問題」頁籤。您也可以聯絡 Meta 合作夥伴尋求協助或申訴。
1800400	2310161	輸入的行銷活動預算太小。根據所使用的範本，預算必須至少為 {minimum_budget}。
1800402	2310160	輸入的開發潛在顧客預算和再行銷預算不等於 100%。請輸入加起來等於 100% 的開發潛在顧客行銷活動預算百分比和再行銷行銷活動預算百分比。此外，請確認範本中識別了同時為開發潛在顧客和再行銷的行銷活動。
1800500	2310166	您正在嘗試使用合約合作夥伴廣告（MPA）API 來更新非 MPA 行銷活動的行銷活動。請檢查您輸入的行銷活動（{campaign_id}），或使用其他 API。
1800501	2310168	輸入的行銷活動編號（{campaign_id}）不屬於該廣告帳號。請檢查編號，然後再試一次。
1800700	2310172	輸入為此廣告組合付費的個人或組織。
1800701	2310171	輸入從此廣告組合受益的個人或組織。