多目的地發訊廣告

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

用戶點擊您的多目的地發訊廣告後，系統會將用戶直接帶到通訊應用程式或用戶最可能回應的應用程式中，如 Messenger、Instagram 或 WhatsApp，讓他們與您的企業開始對話。您可以運用這種廣告大規模地接觸用戶，以及提供出色的個人化服務。

多目的地廣告代表廣告可以前往任何以下目的地組合：Messenger 聊天室、Instagram 聊天室、WhatsApp 聊天室。

如要建立只前往單一目的地的廣告，請參閱以下文章：

• Messenger 發訊廣告
• Instagram 發訊廣告
• WhatsApp 發訊廣告

廣告建立流程概覽

本文件概述在設定多目的地發訊廣告的整合時，需要按照哪些步驟操作。您需要執行以下操作：

1. 建立廣告宣傳活動
2. 建立廣告組合，以連結廣告與廣告宣傳活動
3. 就您希望刊登的多目的地廣告類型建立廣告創意
4. 連結廣告創意與廣告組合以建立廣告

準備工作

本指南假設您符合以下條件：

• 具有 Meta 廣告帳戶
• 已將要在廣告中使用的所有資產上載至 Meta 伺服器，如圖片或影片

第 1 步：建立廣告宣傳活動

首先建立廣告宣傳活動。請向 /act_<AD_ACCOUNT_ID>/campaigns 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：

參數

要求

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>"
}

更新

您可以向 /<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/v21.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 廣告帳戶編號。您的要求必須包括以下內容：

參數

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

要求

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>"
}

更新

您可以向 /<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/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 步：建立廣告創意

透過建立廣告創意，您可以在廣告中加入各種資產。如要建立廣告創意，請向 /act_<AD_ACCOUNT_ID>/adcreatives 端點發出 POST 要求，其中 <AD_ACCOUNT_ID> 是您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：

參數

{
  "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 欄位中自訂廣告的問候訊息、開場白和自動填入訊息，在多目的地發訊廣告建立更度身而設的用戶體驗。

如要進一步了解開場白，請參閱 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 帳戶。

更新

您可以向 /<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/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 步：建立廣告

您可以透過廣告，將廣告創意資料與廣告組合連結起來。如要建立廣告，請向 /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/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"
      }
    }
  ]
}

詳情請參閱素材摘要規格文件。

更新

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

讀取

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

要求

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>"
}