多目的地發訊廣告
本指南說明如何使用推廣 API 建立和發佈多目的地發訊廣告。
用戶點擊您的多目的地發訊廣告後，系統會將用戶直接帶到通訊應用程式或用戶最可能回應的應用程式中，如 Messenger、Instagram 或 WhatsApp，讓他們與您的企業開始對話。您可以運用這種廣告大規模地接觸用戶，以及提供出色的個人化服務。
多目的地廣告代表廣告可以前往任何以下目的地組合：Messenger 聊天室、Instagram 聊天室、WhatsApp 聊天室。
如要建立只前往單一目的地的廣告，請參閱以下文章：
廣告建立流程概覽
本文件概述在設定多目的地發訊廣告的整合時，需要按照哪些步驟操作。您需要執行以下操作：
第 1 步：建立廣告宣傳活動
首先建立廣告宣傳活動。請向 /act_<AD_ACCOUNT_ID>/campaigns 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：
參數
| 名稱 | 說明 |
|---|---|
字串 | 此為必要項目。 |
列舉 | 此為必要項目。 |
清單 <Object> | 此為必要項目。 |
列舉 | 此為可選項目。 |
要求
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/v19.0/act_<AD_ACCOUNT_ID>/campaigns
回應
成功的話，應用程式會收到 JSON 回應，內含您新建立宣傳活動的編號。
{
"id": "<AD_CAMPAIGN_ID>"
}
更新
您可以向 /<AD_CAMPAIGN_ID> 發出 POST 要求來更新宣傳活動。
讀取
如要驗證是否成功建立多目的地發訊廣告宣傳活動，請向 /<AD_CAMPAIGN_ID> 發出 GET 要求。請參閱廣告宣傳活動參考資料，獲取可用參數的完整清單。
要求
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>回應
{
"name": "Click to Multi Destination Campaign",
"status": "ACTIVE",
"objective": "OUTCOME_ENGAGEMENT",
"id": "<AD_CAMPAIGN_ID>"
}
第 2 步：建立廣告組合
建立好廣告宣傳活動後，接下來請建立廣告組合。建立方法是向 /act_<AD_ACCOUNT_ID>/adsets 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：
參數
| 名稱 | 說明 |
|---|---|
未簽署的 int32 | 如果 bid_strategy 設為 |
列舉 | 此為可選項目。 |
列舉 | 此為必要項目。 |
數字字串或整數 | 此為必要項目。 |
int64 | 如未設定 |
字串 | 此為必要項目。
注意：如果您的目的地包括 WhatsApp，請確保已將 WhatsApp Business 電話號碼與您的專頁連結。如果您的目的地包括 Instagram，請確保已將 Instagram 商業帳戶與您的專頁連結。 |
日期時間 | 如已指定 |
int64 | 如未設定 |
字串 | 此為必要項目。 |
列舉 | 此為必要項目。 |
| 此為必要項目。
詳情請參閱廣告組合：推廣的物件。 |
日期時間 | 此為可選項目。 |
列舉 | 此為必要項目。 |
鎖定受眾 | 此為必要項目。 |
日期時間 | 此為可選項目。 |
日期時間 | 如已指定 |
請參閱廣告帳戶廣告組合參考資料，獲取可用參數的完整清單。
要求
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/v19.0/act_<AD_ACCOUNT_ID>/adsets
回應
成功的話，應用程式會收到 JSON 回應，內含您新建立廣告組合的編號。
{
"id": "<AD_SET_ID>"
}
更新
您可以向 /<AD_SET_ID> 發出 POST 要求來更新廣告組合。
讀取
如要驗證是否成功建立多目的地發訊廣告組合，請向 /<AD_SET_ID> 發出 GET 要求。請參閱廣告組合參考資料，獲取可用參數的完整清單。
要求
curl -X GET -G \
-d 'fields=name,destination_type,optimization_goal,bid_strategy' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.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 步：建立廣告創意
透過建立廣告創意，您可以在廣告中加入各種資產。如要建立廣告創意，請向 /act_<AD_ACCOUNT_ID>/adcreatives 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：
參數
| 名稱 | 說明 |
|---|---|
| 此為必要項目。 必要項目：
Messenger
{
"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"
}
}
|
字串 | 此為必要項目。 |
| 此為必要項目。 必要項目：
可選項目：
|
| 此為可選項目。 |
請參閱廣告創意參考資料，獲取可用參數的完整清單。
填寫專頁歡迎訊息
顧客看到的預設訊息為「你好！能否提供更多相關資訊？」。您可以在 object_story_spec 下的 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": {
"text": "<GREETING_MESSAGE>",
"ice_breakers": [
{
"title": "<ICEBREAKER>"
},
{
"title": "<ICEBREAKER>"
},
{
"title": "<ICEBREAKER>"
}
]
}
}
}
廣告創意建立範例
要求
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/v19.0/act_<AD_ACCOUNT_ID>/adcreatives
回應
成功的話，應用程式會收到 JSON 回應，內含您新建立廣告創意的編號。
{
"id": "<AD_CREATIVE_ID>"
}
更新
您可以向 /<AD_CREATIVE_ID> 發出 POST 要求來更新廣告創意。
讀取
如要驗證是否成功建立多目的地發訊廣告創意，請向 /<AD_CREATIVE_ID> 發出 GET 要求。請參閱廣告創意，獲取可用參數的完整清單。
要求
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/v19.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 步：建立廣告
您可以透過廣告，將廣告創意資料與廣告組合連結起來。如要建立廣告，請向 /act_<AD_ACCOUNT_ID>/ads 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：
參數
| 名稱 | 說明 |
|---|---|
字串 | 此為必要項目。 |
數字字串或整數 | 此為必要項目。 |
| 此為必要項目。 |
列舉 | 此為必要項目。 |
要求
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/v19.0/act_<AD_ACCOUNT_ID>/ads
回應
成功的話，應用程式會收到 JSON 回應，內含您新建立廣告的編號。
{
"id": "<AD_ID>"
}
更新
您可以向 /<AD_ID> 發出 POST 要求來更新廣告。
讀取
如要驗證是否成功建立多目的地發訊廣告，請向 /<AD_ID> 發出 GET 要求。請參閱廣告參考資料，獲取可用參數的完整清單。
要求
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_ID>回應
{
"status": "ACTIVE",
"adset_id": "<AD_SET_ID>",
"id": "<AD_ID>"
}