行銷 API

多目的地發訊廣告

本指南說明如何使用行銷 API 來建立和發佈多目的地發訊廣告。

多目的地發訊廣告會將點擊廣告的用戶直接送到他們最有可能用來回應的訊息應用程式（Messenger、Instagram 或 WhatsApp）中，與商家進行對話。使用這類廣告可大量觸及用戶，並提供優質的個人化服務。

多目的地廣告是指廣告可以投放到任何目的地組合：Messenger 聊天室、Instagram 聊天室、WhatsApp 聊天室。

如果您想要建立僅投放到單一目的地的廣告，請參閱：

廣告建立流程總覽

本文件說明設定多目的地發訊廣告整合所需遵循的步驟。您需要：

  1. 建立廣告行銷活動
  2. 建立將廣告連結至廣告行銷活動的廣告組合
  3. 針對您想要投放的多目的地廣告類型建立廣告創意
  4. 將廣告創意連結至廣告組合，以建立廣告

準備工作

本指南假設您已經具備下列條件：

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

首先建立您的廣告行銷活動。若要執行此作業，請發出 POST 要求至 /act_<AD_ACCOUNT_ID>/campaigns 端點，其中 <AD_ACCOUNT_ID> 是 Meta 廣告帳號的編號。您的要求必須包含：

參數

名稱說明

name

字串

必要項目。
多目的地發訊廣告行銷活動的名稱。

objective

列舉

必要項目。
行銷活動的目標。
支援的目標為 OUTCOME_ENGAGEMENT、OUTCOME_SALES 和 OUTCOME_TRAFFIC。

special_ad_categories

清單<Object>

必要項目。
與多目的地發訊廣告行銷活動相關聯的特殊廣告類別。我們目前不支援多目的地發訊廣告的特殊廣告類別，所以此項目必須是 NONE 或空白陣列。如需詳細資訊，請參閱廣告行銷活動參考資料。

status

列舉

選用項目。
有效選項為 PAUSED 和 ACTIVE。
如果此狀態為 PAUSED，其所有上線的廣告組合和廣告都會暫停，且有效狀態為 CAMPAIGN_PAUSED。

要求

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

回應

成功後，您的應用程式會收到 JSON 回應，其中包含新建行銷活動的編號。

{
  "id": "<AD_CAMPAIGN_ID>"
}

更新

您可以發出 POST 要求至 /<AD_CAMPAIGN_ID>，以更新行銷活動。

讀取

若要驗證您是否已成功建立多目的地發訊廣告行銷活動，您可以發出 GET 要求至 /<AD_CAMPAIGN_ID>。請參閱廣告行銷活動參考資料，取得完整的可用參數清單。

要求

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

回應

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

步驟 2：建立廣告組合

有了廣告行銷活動後，請建立廣告組合。若要建立廣告組合，請發出 POST 要求至 /act_<AD_ACCOUNT_ID>/adsets 端點，其中 <AD_ACCOUNT_ID> 是 Meta 廣告帳號的編號。您的要求必須包含：

參數

名稱說明

bid_amount

未簽署的 int32

如果 bid_strategy 設為 LOWEST_COST_WITH_BID_CAP 或 COST_CAP，則此為必要項目。
您願意為以 optimization_goal 為依據的結果支付的最高金額。

bid_strategy

列舉

選用項目。
此行銷活動的出價策略，以配合您特定的業務目標。如需詳細資訊，請參閱廣告行銷活動參考資料。
值：LOWEST_COST_WITHOUT_CAP、LOWEST_COST_WITH_BID_CAP、COST_CAP

billing_event

列舉

必要項目。
用於多目的地發訊廣告時，必須設為 IMPRESSIONS。當您的廣告對用戶顯示時，Meta 會向您收費。

campaign_id

數值字串或整數

必要項目。
要新增此廣告組合的有效多目的地發訊廣告行銷活動。

daily_budget

int64

若未設定 lifetime_budget，則此為必要項目。
以您的帳號幣別定義的單日預算。僅限用於刊登時間（end_time 與 start_time 之間的差距）超過 24 小時的廣告組合。
daily_budget 或 lifetime_budget 必須大於 0。

destination_type

字串

必要項目。


  • 如果您想要使用所有三個目的地（Messenger、WhatsApp 和 Instagram），則設為 MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP。
  • 如果您想要使用 Messenger 和 Instagram，則設為 MESSAGING_INSTAGRAM_DIRECT_MESSENGER。
  • 如果您想要使用 Messenger 和 WhatsApp，則設為 MESSAGING_MESSENGER_WHATSAPP。
  • 如果您想要使用 WhatsApp 和 Instagram，則設為 MESSAGING_INSTAGRAM_DIRECT_WHATSAPP。

注意：如果您在目的地中包含 WhatsApp，請確認您已將 WhatsApp Business 號碼連接至粉絲專頁。如果您在目的地中包含 Instagram，請確認您已將 Instagram 商業帳號連接至粉絲專頁。

end_time

DateTime

指定 lifetime_budget 時，此為必要項目。
使用 daily_budget 來建立廣告組合時，請指定 end_time=0，或將此欄位保留空白，以將廣告組合設為持續刊登，沒有結束日期。
範例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。UTC UNIX 時間戳記。

lifetime_budget

int64

若未設定 daily_budget，則此為必要項目。
以您的帳號幣別定義的廣告組合總經費。若指定此項目，也必須指定 end_time。
daily_budget 或 lifetime_budget 必須大於 0。

name

字串

必要項目。
多目的地發訊廣告組合的名稱。

optimization_goal

列舉

必要項目。
廣告組合的最佳化目標。用於多目的地發訊廣告時，必須設為 CONVERSATIONS。依據行銷活動的目標，廣告組合可能符合不同的最佳化目標資格。

promoted_object

必要項目：
此廣告組合在其所有廣告中推廣的物件。針對多目的地發訊廣告，promoted_object 具有以下條件：

  • page_id：必要項目。Facebook 粉絲專頁的編號。

如需詳細資訊，請參閱廣告組合：推廣的物件。

start_time

DateTime

選用項目。
廣告組合的開始時間。若未提供值，此欄位預設為目前時間。
範例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。UTC UNIX 時間戳記。

status

列舉

選用項目。
廣告組合的狀態。這可能會因為其上層行銷活動而與有效狀態不同。若未提供值，此欄位預設為 ACTIVE。
值：ACTIVE、PAUSED、DELETED、ARCHIVED

targeting

目標設定物件

必要項目。
Instagram 發訊廣告的目標設定結構。如需詳細資訊，請參閱目標設定。

time_start

DateTime

選用項目。
可與 start_time 互換。

time_stop

DateTime

指定 lifetime_budget 時，此為必要項目。
可與 end_time 互換。

請參閱廣告帳號廣告組合參考資料，取得完整的可用參數清單。

要求

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

回應

成功後，您的應用程式會收到 JSON 回應，其中包含新建廣告組合的編號。

{
  "id": "<AD_SET_ID>"
}

更新

您可以發出 POST 要求至 /<AD_SET_ID>，以更新廣告組合。

讀取

若要驗證您是否已成功建立多目的地發訊廣告組合，您可以發出 GET 要求至 /<AD_SET_ID>。請參閱廣告組合參考資料，取得完整的可用參數清單。

要求

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

回應

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

步驟 3：建立廣告創意

廣告創意可讓您新增素材至廣告。若要建立廣告創意，請發出 POST 要求至 /act_<AD_ACCOUNT_ID>/adcreatives 端點，其中 <AD_ACCOUNT_ID> 是 Meta 廣告帳號的編號。您的要求必須包含：

參數

名稱說明

asset_feed_spec

必要項目。
指定多目的地發訊廣告的目的地

必要項目：

  • optimization_type：用於多目的地發訊廣告時，必須設為 DOF_MESSAGING_DESTINATION。
  • call_to_actions：多目的地發訊廣告的選定目的地陣列，必須與廣告組合中指定的 destination_type 相符。

Messenger

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
}

WhatsApp

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

Instagram

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

name

字串

必要項目。
廣告創意的名稱。

object_story_spec

必要項目。
包含訊息相關資訊的物件。如需詳細資訊，請參閱廣告創意物件動態規格。


必要項目：

  • page_id：Facebook 粉絲專頁的編號
  • instagram_actor_id：Instagram 帳號編號。取得 Instagram 帳號編號的方式有三種：企業管理平台擁有的 Instagram 帳號、粉絲專頁連結的 Instagram 帳號，以及粉絲專頁型 Instagram 帳號。

選用項目：

  • link_data：連結粉絲專頁貼文或輪播廣告的規格
  • photo_data：相片粉絲專頁貼文的規格
  • text_data：文字粉絲專頁貼文的規格
  • video_data：影片粉絲專頁貼文的規格

degrees_of_freedom_spec

選用項目。
如需詳細資訊，請參閱高效速成+ 廣告創意的標準強化效果。

請參閱廣告創意參考資料，取得完整的可用參數清單。

填寫粉絲專頁歡迎訊息

顧客看到的預設訊息是「你好！能否提供更多相關資訊？」。您可以為多目的地發訊廣告建立更為客製化的用戶體驗，在 object_story_spec 下方的 page_welcome_message 欄位中自訂廣告的問候訊息、破冰問題和自動填入訊息。

如需深入瞭解破冰問題，請參閱 ice_breakers 參考資料。

限制

  • 破冰問題標題不得超過 80 個字元。
  • 破冰問題回應不得超過 300 個字元。
  • 訊息文字不得超過 300 個字元。

範例

建立 page_welcome_message 物件以新增包含問候訊息的破冰問題。

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

廣告創意建立範例

在廣告創意新增 page_welcome_message 欄位，如下所示。

要求

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

回應

成功後，您的應用程式會收到 JSON 回應，其中包含新建廣告創意的編號。

{
  "id": "<AD_CREATIVE_ID>"
}

使用 Instagram 內容建立廣告創意

Instagram 貼文

如需詳細資訊，請參閱將貼文做為 Instagram 廣告使用。

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Instagram 圖像

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

使用 Facebook 內容建立廣告創意

如需詳細資訊，請參閱將貼文做為 Instagram 廣告使用：Facebook 貼文。

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

其中 object_story_id 是 postOwnerID_postID 格式的貼文編號，instagram_actor_id 是粉絲專頁連結的 Instagram 帳號編號或粉絲專頁支援的 Instagram 帳號編號。請參閱使用粉絲專頁設定 Instagram 帳號，瞭解詳細資訊。

更新

您可以發出 POST 要求至 /<AD_CREATIVE_ID>，以更新廣告創意。

讀取

若要驗證您是否已成功建立多目的地發訊廣告創意，您可以發出 GET 要求至 /<AD_CREATIVE_ID>。請參閱廣告創意，取得完整的可用參數清單。

要求

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

回應

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

步驟 4：建立廣告

廣告可讓您將廣告創意資訊與廣告組合建立關聯。若要建立廣告，請發出 POST 要求至 /act_<AD_ACCOUNT_ID>/ads 端點，其中 <AD_ACCOUNT_ID> 是 Meta 廣告帳號的編號。您的要求必須包含：

參數

名稱說明

name

字串

必要項目。
廣告創意的名稱。

adset_id

數值字串或整數

必要項目。
廣告組合的編號。

creative

必要項目。
此廣告所使用的廣告創意。您可以提供現有廣告創意的 creative_id，或包含所有必填欄位來建立新的廣告創意。如需詳細資訊，請參閱廣告創意。

status

列舉

必要項目。
廣告的配置狀態。
值：ACTIVE、PAUSED、DELETED、ARCHIVED

要求

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

回應

成功後，您的應用程式會收到 JSON 回應，其中包含新建廣告的編號。

{
  "id": "<AD_ID>"
}

行動呼籲

您也可以在建立廣告時設定行動呼籲。

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

如需詳細資訊，請參閱素材摘要規格文件。

更新

您可以發出 POST 要求至 /<AD_ID>，以更新廣告。

讀取

若要驗證您是否已成功建立多目的地發訊廣告，您可以發出 GET 要求至 /<AD_ID>。請參閱廣告參考資料，取得完整的可用參數清單。

要求

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

回應

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}