行銷 API

Reels 廣告

建立以可用連續短片版位為主的 Meta 廣告，並瞭解我們廣告運作的最佳作法。

必要條件

  • 您先前已建立 Facebook 應用程式
  • 您熟悉行銷 API 並已啟用「Facebook 登入」

如果您不符合這些必要條件，請參閱我們的開發人員文件。

沙箱測試

Meta 提供測試環境，在此環境中不會真的投遞廣告，但可讓您：

  • 在您的 Meta 應用程式中，將行銷 API 做為產品新增至「工具」區塊，以使用我們的 API 來建立和編輯廣告，而不會產生費用
  • 建立廣告帳號來使用行銷 API

請詳閱我們的測試最佳作法。

步驟 1：存取資產

存取權杖是一種可辨識用戶、應用程式或粉絲專頁的隱晦字串，可以讓應用程式用來進行圖形 API 呼叫。您可以查看這個權杖何時到期，以及哪個應用程式產生了這個權杖。Meta 應用程式上的行銷 API 呼叫需要包含存取權杖。

取得具有必要權限的存取權杖：

  • ads_management：在特定廣告帳號中進行變更

  • ads_read：讀取廣告資料

  • read_insights：讀取成效洞察報告

請使用系統存取權杖，因為其有效期限較長。

額外授權階層

若要存取行銷 API 端點，您需要建立商業應用程式。其受制於名為存取權限層級的額外圖形 API 授權階層。在應用程式審查期間，您的應用程式也必須要求特定的權限和功能。如果要讓在應用程式本身不具有角色，或在已認領應用程式之商家中不具有角色的應用程式用戶使用您的應用程式，您必須完成商家驗證。

如果您的應用程式有管理其他用戶的廣告帳號，您需要：

  • 進階存取權限 ads_read

和／或

  • 進階存取權限 ads_management

步驟 2：擷取廣告帳號

擷取您的廣告商廣告帳號，並允許他們選擇用來建立廣告的帳號。

透過我們的商家管理 API，您可以查看其商家有權存取的所有廣告帳號。這會傳回商家擁有的所有廣告帳號。請注意，您在應用程式和用戶層級會需要 business_management 權限。請參閱商家資產管理 API。

呼叫範例

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0/<BUSINESS_ID>/owned_ad_accounts"

步驟 3：建立行銷活動

行銷活動是廣告帳號組織架構中的最高層級，應代表廣告商的單一目標。這些物件中包含您的廣告目標和一或多個廣告組合。這有助於您最佳化和衡量各廣告目標的結果。前往這裡進一步瞭解如何建立、讀取、更新和刪除行銷活動。

呼叫範例

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

步驟 4：目標定義

若要讓廣告商能夠觸及特定族群，請在 API 要求中指定以下參數：

  • 人口統計資料（年齡、性別、地點）
  • 興趣
  • 行為

如此就會觸及最有可能對您的產品或服務感興趣的潛在顧客。

呼叫範例

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'description=People who live in New York, aged 25-40, interested in technology' \
  -F 'customer_file_source=USER_PROVIDED_ONLY' \
  -F 'targeting_spec={
        "geo_locations": {
          "countries": ["US"],
          "regions": [{"key": "4081"}]  # New York region key
        },
        "age_min": 25,
        "age_max": 40,
        "interests": [{"id": "6003139266461", "name": "Technology"}]
      }' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/customaudiences

步驟 5：建立廣告組合

廣告組合可以包含一或多個廣告。廣告組合中的廣告應有相同的目標設定、預算、帳單、最佳化目標和刊登時間。

您可以設定預算、排程、目標設定、出價策略和廣告版位選項。廣告組合可供微調向特定受眾族群投放廣告的方式和地區、最佳化成效，並達到行銷目標。

主要參數：

  • 廣告受眾目標設定條件
  • 單日預算或總經費
  • 用來控制廣告顯示時機的排程選項

前往這裡瞭解更全面的詳細資訊。

您可以選擇包含 Instagram 和 Facebook 連續短片廣告的手動版位，或預設為自動版位。如果您沒有為特定的版位欄位指定任何項目，則會考慮該欄位的所有可能預設位置。

呼叫範例

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=Reels Ad Set' \
  -F 'campaign_id=YOUR_CAMPAIGN_ID' \
  -F 'daily_budget=5000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=REACH' \
  -F 'start_time=2024-07-10T10:00:00-0700' \
  -F 'end_time=2024-07-20T10:00:00-0700' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
  -F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
  -F 'status=PAUSED' \
  -F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
  -F 'publisher_platforms=["instagram"]' \
  -F 'instagram_positions=["reels"]' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/adsets

廣告版位目標設定：Reels 可用位置、相容目標和最佳化目標

publisher_platformsfacebook_position 或 instagram position相容目標optimization_goal
instagram

reels、profile_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

instagram

reels、profile_reels

 OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

instagram

reels、profile_reels

 OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

instagram

reels、profile_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

VISIT_INSTAGRAM_PROFILE

instagram

reels、profile_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

POST_ENGAGEMENT

REACH

IMPRESSIONS

REMINDERS_SET

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

instagram

reels、profile_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

facebookfacebook_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

facebookfacebook_reels

OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

facebookfacebook_reels

OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

facebookfacebook_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

QUALITY_CALL

facebookfacebook_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

POST_ENGAGEMENT

REACH

IMPRESSIONS

EVENT_RESPONSES

QUALITY_CALL

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

PAGE_LIKES

facebookfacebook_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

QUALITY_CALL

限制

相容目標 + optimization_goal 組合 是否符合 FB Reels 資格？ 是否符合 IG Reels 資格？

OUTCOME_AWARENESS + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_TRAFFIC + VISIT_INSTAGRAM_PROFILE

❌

✅

OUTCOME_TRAFFIC + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_ENGAGEMENT + EVENT_RESPONSES

✅

❌

OUTCOME_ENGAGEMENT + REMINDERS_SET

❌

✅

OUTCOME_ENGAGEMENT + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + PAGE_LIKES

✅

❌

OUTCOME_SALES + QUALITY_CALL

✅

❌

步驟 6：選擇廣告創意

廣告創意是廣告的視覺和文字元素，支援下列廣告格式：

  • 圖像
  • 影片
  • 輪播
  • 啟用自訂廣告設計

利用我們的廣告創意程序，自動化設計元素並最佳化成效。

重複利用現有的連續短片做為廣告創意

用戶可以提供新的素材，或重複利用 Instagram 帳號中現有的連續短片做為廣告創意。

您可以從符合推廣資格的現有​​、自主 Instagram 或 Facebook 連續短片建立廣告，但需符合下列條件：

  • 少於 90 秒
  • 具有全螢幕（9:16）直向長寬比
  • 不含第三方版權音樂、GIF、互動式貼圖或相機濾鏡
  • 未分享至 Facebook

若要重新利用自主 Instagram 連續短片做為新廣告行銷活動的廣告創意：

  1. 取得 Instagram 商業帳號編號，需與 Facebook 粉絲專頁連結

    • GET/{ad_account_id}/connected_instagram_accounts 或
    • GET/{business_id}/instagram_business_accounts

  2. 找到您想要推廣的連續短片

    • GET/{ig-business-account-user-id}/media

  3. 提供廣告創意

    • 將 instagram_user_id 設定為 Instagram 用戶編號，而不是在廣告創意規格中指定 instagram_actor_id
    • 指定 source_instagram_media_id 為影音素材編號
    • （選用）更新促銷活動的 call_to_action

使用 boost_eligibility_info 可方便判斷影音素材是否符合資格，可以當作廣告加強推廣，而使用 boost_ads_list 可追蹤過去加強推廣的 Instagram 廣告相關資訊。

呼叫範例

curl -i -X POST \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>

Gen AI 廣告創意工具箱

您可以自動產生多樣化且引人入勝的廣告元素，例如：圖像、影片和文字。這些人工智慧驅動的工具可依據廣告受眾偏好量身打造內容，並加強廣告創意多樣性，以幫助廣告達到最佳成效。廣告的建立將帶來更高頻率的互動和更優質的行銷活動。

步驟 7：預覽廣告

使用下列資料，以下表中的 Facebook 和 Instagram Reels 格式預覽廣告：

  • 廣告編號
  • 廣告創意編號
  • 廣告創意規格
發佈平台 廣告格式

Facebook

DESKTOP_FEED_STANDARD、FACEBOOK_STORY_MOBILE、INSTANT_ARTICLE_STANDARD、INSTREAM_VIDEO_DESKTOP、INSTREAM_VIDEO_MOBILE、MARKETPLACE_DESKTOP、MARKETPLACE_MOBILE、MOBILE_FEED_BASIC、MOBILE_FEED_STANDARD、RIGHT_COLUMN_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE、FACEBOOK_REELS_BANNER、FACEBOOK_REELS_BANNER_DESKTOP、FACEBOOK_REELS_MOBILE、FACEBOOK_REELS_POSTLOOP、FACEBOOK_REELS_STICKER、FACEBOOK_STORY_STICKER_MOBILE、WATCH_FEED_HOME

Instagram

INSTAGRAM_STANDARD、INSTAGRAM_STORY、INSTAGRAM_EXPLORE_CONTEXTUAL、INSTAGRAM_EXPLORE_IMMERSIVE、INSTAGRAM_EXPLORE_GRID_HOME、INSTAGRAM_FEED_WEB、INSTAGRAM_FEED_WEB_M_SITE、INSTAGRAM_PROFILE_FEED、INSTAGRAM_REELS、INSTAGRAM_REELS_OVERLAY、INSTAGRAM_SEARCH_CHAIN、INSTAGRAM_SEARCH_GRID、INSTAGRAM_STORY_CAMERA_TRAY、INSTAGRAM_STORY_WEB、INSTAGRAM_STORY_WEB_M_SITE

呼叫範例

curl -X POST \
  'https://graph.facebook.com/v21.0/act_{ad_account_id}/adpreviews' \
  -F 'access_token={your_access_token}' \
  -F 'creative={
        "object_story_spec": {
            "instagram_actor_id": "{instagram_actor_id}",
            "video_data": {
                "video_id": "{video_id}",
                "title": "Check out our new product!",
                "description": "Exciting new features and benefits.",
                "call_to_action": {
                    "type": "LEARN_MORE",
                    "value": {
                        "link": "https://www.example.com/product"
                    }
                }
            }
        }
    }' \
  -F 'ad_format=INSTAGRAM_REELS'

步驟 8：廣告投遞排程

若要使用行銷 API 來預訂廣告，請建立廣告群組物件，並將廣告組合物件連結到廣告創意。使用 /act_{ad_account_id}/ads 來提交您的廣告物件，並驗證回應以確認預訂成功。此步驟將完成廣告設定，使其準備好根據提供的配置進行投遞。

呼叫範例

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

步驟 9：檢視成效

使用洞察報告 API，從廣告帳號擷取廣告成效衡量指標：

  • act_<AD_ACCOUNT_ID>/insights
  • <CAMPAIGN_ID>/insights
  • <ADSET_ID>/insights
  • <AD_ID>/insights

在 Instagram 和 Facebook 上刊登行銷活動時，請新增 breakdowns=publisher_platform，以分別查看 Facebook 和 Instagram 廣告版位的統計資料，如下方呼叫範例所示。依廣告版位層級細分洞察報告時，可以透過 Instagram 和 Facebook Reels 廣告版位瞭解廣告的成效。

呼叫範例

curl -X GET \
  'https://graph.facebook.com/v21.0/{ad_account_id}/insights' \
  -F 'access_token={your_access_token}' \
  -F 'level=campaign' \
  -F 'fields=campaign_name,impressions,clicks,spend' \
  -F 'breakdowns=publisher_platform,platform_position' \
  -F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
  -F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'

重要考量因素

ODAX（成果導向廣告體驗目標驗證）支援的新目標

  • OUTCOME_APP_PROMOTION
  • OUTCOME_AWARENESS
  • OUTCOME_ENGAGEMENT
  • OUTCOME_LEADS
  • OUTCOME_SALES
  • OUTCOME_TRAFFIC

速率限制

行銷 API 有自己的限速邏輯，不受任何圖形 API 速率限制影響。影響行銷 API 速率限制額度的功能是「廣告管理一般存取權限」。根據預設，當您將行銷 API 產品新增至應用程式主控板時，會取得一般存取權限，為您提供對行銷 API 的開發存取權限。若要增加限速額度，請升級至進階存取權限。

廣告創意基本概要

Reels 廣告可將注意力轉換成行動，使成效大幅提升。如果建置的方式正確，效果更是加倍。

1. 以 9:16 影片建置，使您的影片讓人著迷：Reels 是全螢幕的沉浸式影片格式。為了讓您的廣告創意更適合這種格式，請考慮以影片為主並調整為 9:16 的尺寸格式。

2. 在安全區域中建置內容，讓您的訊息清楚傳達：在安全區域內建置內容，Reels 用戶介面才不會擋住您的疊壓文字／貼圖、行動呼籲或重要訊息。9:16 廣告創意底部 35% 的部分應保持淨空，不要放置文字、標誌和其他重要元素。

3. 建置有聲影片，以創造娛樂效果：無論是音樂、配音或音效，音訊都是 Reels 上提升互動性和娛樂性的關鍵因素。