行銷 API

素材摘要規格選項

您可以在 asset_feed_spec 中使用下列選項。請參閱廣告素材摘要規格，取得更多參考資訊。

屬性名稱 說明

images

類型：清單陣列

這是 SINGLE_IMAGE 和 CAROUSEL_IMAGE 格式的必要項目。

符合條件的圖像陣列。此陣列中提供的圖像應包含在廣告帳號的圖像庫中。


請以包含 {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"} 的清單陣列提供此欄位。必須提供 url 或 hash 其中任一項。

videos

類型：清單陣列

SINGLE_VIDEO 格式的必要項目。

video_id 陣列。此陣列中提供的 video_id 應屬於廣告帳號。


請以包含 {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"} 的清單陣列提供此欄位

carousels
類型：清單陣列

選用項目。
child_attachments 陣列（含 multi_share_end_card 和 multi_share_optimized 布林值），以及 adlabels。此陣列中提供的 child_attachments 應屬於廣告帳號。



請以包含 {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}} 的清單陣列提供 child_attachments。必須提供 image_label 或 video_label 其中任一項。

bodies

類型：清單陣列

選用項目。

正文陣列。廣告的主要訊息或文案。


請以 {"text": "{BODY_TEXT}", "url_tags": "{TAG}"} 的清單陣列提供此欄位。

call_to_action_types

類型：清單陣列

所有目標的必要項目，OUTCOME_AWARENESS 除外。

行動呼籲類型值的陣列。


請以 {"{CALL_TO_ACTION}"} 的清單陣列提供此欄位。您可以提供多個值，最多五個。

titles

類型：清單陣列

選用項目。

標題陣列。標題是廣告中的短標題，通常顯示在連結、圖像或影片旁邊。


請以 {"text": "{TITLE}", "url_tags": "{TAG}"} 的清單陣列提供此欄位。

descriptions

類型：清單陣列

選用項目。

次要說明文字陣列，顯示方式不如正文或標題顯眼。通常出現在連結、圖像或影片旁邊。若未指定，Facebook 會抓取您提供的連結來產生說明文字。如果您不想使用抓取的文字，請使用含單一空格的空字串以顯示空白說明。


請以 {"text": "{DESCRIPTION}", "url_tags": "{TAG}"} 的清單陣列提供此欄位。

link_urls

類型：清單陣列

必要項目。

連結網址陣列。


請以 {"website_url": "{URL}"} 的清單陣列提供此欄位。

ad_formats

類型：字串陣列

必要項目。

我們應該用來建立廣告的 Facebook 廣告格式陣列。支援的格式包括：SINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO、AUTOMATIC_FORMAT。


請以 ["{AD_FORMAT}"] 字串陣列提供此欄位。

optimization_type

類型：字串

選用項目。

素材摘要中使用的最佳化類型。可能的值為 ASSET_CUSTOMIZATION、LANGUAGE、PLACEMENT 和 REGULAR。

message_extensions

類型：字串陣列

選用項目。
素材摘要中使用的訊息擴充類型。


可能的值：whatsapp

onsite_destinations
類型：清單陣列

商店廣告的必要項目。適用於靜態廣告；SINGLE_IMAGE、SINGLE_VIDEO 或 CAROUSEL 格式。
請以包含下列其中一個值的清單陣列提供此欄位，以指定站內商店的連結目的地。

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
類型：布林值

商店廣告的必要項目。適用於高效速成+ 目錄廣告。
請提供此欄位以進行商店最佳化。包括 reasons_to_shop 和 automated_product_tags 商店最佳化類型。
可能的值：true、false

reasons_to_shop
類型：布林值

商店廣告的必要項目。適用於高效速成+ 目錄廣告。
請提供此欄位以進行商店最佳化。自動強調顯示商店的產品資訊，像是「免運費」、「熱門商品」或「存貨不多」。
可能的值：true、false

素材摘要規格限制

廣告格式

  • 支援的格式：ad_formats、SINGLE_IMAGE、CAROUSEL、SINGLE_VIDEO、AUTOMATIC_FORMAT。
  • 每個素材摘要只能使用一種 ad_format。
  • ad_format 算作素材摘要中的一項素材。

素材數量：

  • 素材總數最多 30 項。例如，您有 28 項素材，其中有 10 個 images、5 個 bodies、5 個 titles、5 個 description、1 個 ad_format、1 個 link_url 和 1 個 call_to_action_types。
  • 圖像總數：<= 10。
  • 影片總數：<= 10。如果您使用 Instagram 做為廣告版位，僅限使用正方形或橫向影片。
  • 正文總數：<= 5。
  • 行動呼籲總數：<= 5。
  • 標題總數：<= 5。
  • 連結總數：<= 5。
  • 說明總數：<= 5。

圖像規定：

  • 建議圖像規格：1.9:1。
  • 建議圖像尺寸：1,200 x 628 像素。
  • 若使用 CAROUSEL_IMAGE 格式，您必須提供至少 2 個圖像。
  • 如果您使用 Instagram 做為廣告版位，請使用正方形圖像以獲得較佳效果。

文字規定：

  • 標題和說明文字：長度上限為 255 個字元。
  • 正文：長度上限為 1024 個字元。
  • 如果您未指定任何說明，我們會抓取您提供的連結來擷取說明。
  • 若使用 CAROUSEL_IMAGE，標題為選用項目。

url_tags 為選用項目，僅適用於 images、videos、bodies、descriptions 和 titles。Facebook 會在連結網址後面附加 url_tags，做為廣告中每項素材的參數。

例如，SINGLE_IMAGE 格式的有效素材摘要組合設定為：

  • 5 個 images
  • 3 個 bodies
  • 3 個 titles
  • 3 個 descriptions
  • 1 個格式：SINGLE_IMAGE
  • 2 個 link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

使用深層連結

您可以為具有下列目標的行銷活動，在素材摘要規格中使用深層連結：

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

建立 asset_feed_spec 時，在 link_urls 中加入 deeplink_url。

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

網站導向 WhatsApp 廣告

您可以建立將用戶導向自家網站的廣告，在畫面底部顯示 WhatsApp 按鈕，讓用戶可以立即與您聯繫。這有助於用戶在瀏覽您的網站時，透過 WhatsApp 與您聯繫。

建立 asset_feed_spec 時，加入 message_extensions。

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives