行銷 API

活用型廣告創意

您可透過活用型廣告創意，自動向用戶提供廣告創意的內容組合。它有助於找出每次曝光的最佳廣告創意組合，並從素材對於不同廣告受眾的成效中學習。

此解決方案也能幫助您探索各種廣告創意素材組合和廣告受眾，以便向用戶展示最佳的圖像、標題、描述等素材。

活用型廣告創意可用於：

  • 發展自動化的工作流程來測試廣告創意
  • 利用不同的廣告受眾，學習如何挑選最有效的廣告創意素材組合

請將此 API 用於新上線與進行中的行銷活動，以及刊登時間超過五天的行銷活動。您應該對現有的行銷活動進行分組測試，以找出最貼近需求的方式。

立即開始

步驟 1：建立行銷活動和廣告組合

您可以為活用型廣告創意建立標準廣告行銷活動，但有兩項限制：

  • 您的 objective 必須為下列其中之一：OUTCOME_SALES、OUTCOME_ENGAGEMENT、OUTCOME_LEADS、OUTCOME_AWARENESS、OUTCOME_TRAFFIC 或 OUTCOME_APP_PROMOTION。
  • buying_type 必須為預設值，即 AUCTION 或留空白。

例如，若要以 CONVERSIONS 的 objective 建立廣告行銷活動：

curl \
  -F 'name=Dynamic Creative Sample Campaign'
  -F 'objective=OUTCOME_SALES'
  -F 'status=PAUSED'
  -F 'special_ad_categories=<SPECIAL_AD_CATEGORY>'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

有了行銷活動後，使用標準廣告組合端點建立廣告組合。

  • 只要與上層廣告行銷活動的 objective 相容，就能使用所有的 billing_event、targeting 和 promoted_object。
  • 您必須為 OUTCOME_SALES、OUTCOME_ENGAGEMENT、OUTCOME_LEADS 和 OUTCOME_TRAFFIC 目標，將 optimization_goal 設為 OFFSITE_CONVERSIONS。
  • 然後將 is_dynamic_creative 設為 true。

若要在 optimization_goal 設為 conversions 的情況下，為行銷活動建立廣告組合：

curl \
  -F 'status=PAUSED'
  -F 'name=Dynamic Creative Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=true'
  -F 'lifetime_budget=5000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2024-04-09'
  -F 'end_time=2024-04-20'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

這會回傳新的廣告組合編號：

{"id":"23842500259260001"}

若要使用 asset_feed_spec 搭配已為 APP_INSTALLS 最佳化的廣告組合，您須指定 link_url，例如 http://www.abc.com。link_url 應該與 promoted_object 中的 object_store_url相同。在 asset_feed_spec 中，只能提供一個 link_url 參數。

curl 
-F "name=Dynamic Creative AdSet"
-F "campaign_id=CAMPAIGN_ID"
-F "optimization_goal=APP_INSTALLS"
-F 'is_dynamic_creative=true'
-F "billing_event=IMPRESSIONS"
-F "is_autobid=true"
-F "promoted_object={'object_store_url':'https://itunes.apple.com/us/app/facebook/id284882215','application_id':ADVERTISED_APP_ID}"  // object_store_url must match what is provided in asset feed's link_urls 
-F "lifetime_budget=20000"
-F "end_time=1461974400"
-F "targeting={
     'geo_locations':{'countries':['US']},
     'age_min':18,
     'age_max':24,
     'publisher_platforms':['facebook', 'audience_network'],
     'user_os':['ios']
   }"
-F "access_token=ACCESS_TOKEN" 
https://graph.facebook.com/<API_VERSION>/act_AD_ACCOUNT_ID/adsets

步驟 2：以 asset_feed_spec 提供廣告創意

透過 asset_feed_spec 欄位（也稱為「素材摘要」）提供您的廣告創意。在此欄位中，您可為每種素材類型指定多個廣告創意素材。素材類型包括圖像、影片、標題與連結說明。請參閱下列內容：

請注意，您可能也需要設定 page_id 和 instagram_actor_id。

第只有行銷 API 第 3.1 版和之前版本支援 asset_feed_id。建議您改用 asset_feed_spec。

圖像裁切

活用型廣告創意可支援圖像裁切功能。請在圖像規格中指定圖像裁切參數。每個圖像只能指定一種裁切方式。我們會在所有廣告版位中，套用您的圖像裁切方式。請參閱行銷 API 的圖像裁切。

在此階段，您的廣告組合必須為空白。建立廣告時，請提供廣告創意編號的參照。每個廣告組合只能建立一個廣告。不過，您可以另外建立新的廣告組合，以建立更多的活用型廣告創意廣告。

curl 
  -F 'name=Dynamic Creative Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

建立廣告之後：

活用型廣告創意廣告建立完後，便無法將其刪除或封存。您必須改為刪除或封存上層廣告組合。

活用型廣告創意可支援所有廣告版位，除了 Messenger 上的 sponsored_messages。

輪播廣告

活用型廣告創意可提供最佳的輪播廣告格式素材組合。如果您的摘要圖像少於 10 張，則輪播圖卡的數量與圖像數量相同。如果您使用的圖像超過 10 張，我們僅會輪播 10 張圖卡。我們建議採用正方形的圖像尺寸。

如果您使用輪播廣告搭配活用型廣告創意，則無法在輪播廣告中使用以下功能：

  • BODY_LABEL
  • CALL_TO_ACTION_TYPE_LABEL
  • LINK_URL_LABEL
  • CAPTION_LABEL
  • AD_FORMAT_LABEL

在素材洞察報告的資料解析中，所有圖卡之圖卡內素材的曝光指標，會彙整至第一張圖卡的素材。圖卡內素材包括圖像、標題和描述

如需瞭解背景資訊，請參閱輪播廣告。

步驟 4（選用）：查看審查狀態

建立行銷活動、廣告組合和廣告之後，請查看廣告審查狀態：

curl -G 
-d "access_token=<ACCESS_TOKEN>" 
-d 'fields=review_feedback' 
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

審查結果會包含廣告審查意見回饋。若顯示空白陣列，表示您的廣告已通過審查：

{
  "review_feedback":"[]",
  "id":"<ADSET_ID>"
}

若您的廣告未通過審查，則會顯示：

{
  "review_feedback": {
    {"id":23842500258220001,"text":"Body 1","reason":["ALCOHOL"]},
    {"id":23842500258160001,"text":"Title 1","reason":["ALCOHOL"]},
    {"id":23842500258170001,"text":"Title 2","reason":["ALCOHOL"]}
  }",
  "id": "<AD_ID>"  
}