用於廣告的潛在顧客名單表格

本文介紹如何透過利用推廣 API 來使用 Graph API 建立名單型廣告。

如要建立和發佈名單型廣告，您需要按照以下步驟操作：

建立廣告宣傳活動
建立廣告組合，將廣告連結至廣告宣傳活動
建立潛在顧客名單表格
使用潛在顧客名單表格建立廣告創意
連結宣傳活動與廣告創意，建立廣告
發佈廣告

準備工作

本指南假設您已閱讀 Messenger 平台概覽，且已執行收發訊息和通知所需的元件。

您需要準備好以下項目：

第 1 步：建立宣傳活動

如要為您的名單型廣告建立宣傳活動，請向 /act_AD_ACCOUNT_ID/campaigns 端點傳送 POST 要求，並在當中加入以下參數：

將 access_token 設為您的專頁存取憑證
將 buying_type 設為 AUCTION
將 name 設為您宣傳活動的名稱
將 objective 設為 LEAD_GENERATION
將 special_ad_categories 設為 NONE 或您的特殊廣告類別
將 status 設為 PAUSED

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值（如 AD_ACCOUNT_ID）替換為您的值。

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "buying_type":"AUCTION",
           "name":"Messenger_ad_campaign_name",
           "objective":"LEAD_GENERATION",
           "special_ad_categories":["NONE"],
           "status":"PAUSED"
         }'

成功的話，您的應用程式將收到 JSON 物件，其中包含宣傳活動的編號。在下一步建立廣告組合時，您將會用到此編號。

{
  "id": "YOUR_CAMPAIGN_ID"
}

詳情請瀏覽廣告宣傳活動參考資料。

第 2 步：建立廣告組合

如要建立廣告組合，您需向 act_ad_account_id/adsets 端點傳送 POST 要求，其中 ad_account_id 即您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：

將 access_token 設為您的專頁存取憑證
將 bid_amount 設為您最高希望支付的金額
將 billing_event 設為 IMPRESSIONS
將 campaign_id 設為第 1 步中的廣告宣傳活動編號
將 daily_budget 設為您每天希望花費的金額
將 name 設為廣告組合的名稱
將 optimization_goal 設為 LEAD_GENERATION 或 QUALITY_LEAD
將 promoted_object 設為您企業的 Facebook 專頁編號
將 status 設為 PAUSED

注意：如果您已設定客戶關係管理資料來源，並選擇 QUALITY_LEAD 作為優化目標，您可以將 pixel_id 加入 promoted_object，以進一步優化質素。請注意，您不必同時提供 pixel_rule 與 pixel_id。

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值（如 AD_ACCOUNT_ID）替換為您的值。

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"Your_page_access_token",
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "name:"YOUR_LEADADS_ADSET",
           "optimization_goal:LEAD_GENERATION",
           "promoted_object":"YOUR_PAGE_ID",
           "status:PAUSED"
         }'

成功的話，您的應用程式就會收到以下 JSON 回應，其中包含廣告組合編號。

{
  "id": "YOUR_ADSET_ID"
}

詳情請瀏覽廣告組合參考資料。

第 3 步：建立潛在顧客名單表格

如要建立潛在顧客名單表格，請向 /PAGE_ID/leadgen_forms 端點傳送 POST 要求，並在要求中加入以下參數：

將 access_token 設為您的專頁存取憑證
將 name 設為表格名稱
將 questions 設為定義問題類型的物件陣列，並使用 key 參數設定問題在表格中顯示的順序
- 使用 label 參數設定自訂問題
- 使用包含下拉式回答選單的 options 參數設定自訂問題

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_PAGE_ACCESS_TOKEN",
           "name": "YOUR_LEADADS_FORM_NAME",
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

適用於 Messenger 對話的表格

如需在 Messenger 對話中的廣告使用表格，有關表格必須包含以下各項：

questions.type 參數只能設定為以下其中一種值：
CUSTOM
EMAIL
FIRST_NAME
FULL_NAME
LAST_NAME
PHONE
如果表格中 questions.type 設定的值有別於上述列出的值，表格便不符合條件。
block_display_for_non_targeted_viewer 參數必須設定為 false。這會將表格標記為公開分享。

符合條件的 Messenger 潛在顧客名單表格要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "page_ACCESS_TOKEN"
           "block_display_for_non_targeted_viewer": "false"
           "name": "LeadAds Form for Messenger Conversation Name"
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

其他問題類型

除了[「建立潛在顧客名單表格」部分]{#create-a-lead-form} 中介紹的一般問題類型以外，您還可以新增更多專為以下用例而設的問題類型：

安排預約時間：安排預約時間問題會顯示日期和時間選取器，並在問題下方列出時間有限的選項和確認訊息。
身分證明文件：身分證明文件問題會根據用戶所在的國家／地區顯示問題，並會就所輸入的身分證明文件資料驗證格式。
商店定位工具：商店定位工具問題可根據用戶輸入的郵遞區號或郵政編碼，顯示商店定位工具選擇器。

安排預約時間

安排預約時間問題會顯示日期和時間選取器，並在問題下方列出時間有限的選項和確認訊息。

如要新增安排預約時間問題，請加入一個問題物件並將 type 參數設為 DATE_TIME。您也可在 inline_context 參數中加入確認訊息，此訊息會直接顯示於問題欄位下方，以便在必要時提供更多背景資訊。

...
           "questions": "[
               ...
               {"type": "DATE_TIME", 
                "label": "Appointment time", 
                "inline_context": "We will verify and call you to confirm your appointment."
               },
...

身分證明文件

身分證明文件問題會根據用戶所在的國家／地區顯示問題，並會就所輸入的身分證明文件資料驗證格式。系統會針對以下國家／地區顯示此問題：

阿根廷 – {"type": "ID_AR_DNI"}
巴西 – ID_CPF
智利 – ID_CL_RUT
哥倫比亞 – ID_CO_CC
厄瓜多爾 – ID_EC_CI
秘魯 – ID_PE_DNI

如要新增身分證件問題，請新增一個問題物件並將 type 參數設為用戶所在國家／地區類型。

限制

您只能要求用戶以任何指定形式提供單一身分證件，並且只能鎖定相應國家／地區的用戶。例如，如果您要求秘魯的用戶提供 DNI 形式證件，您的目標廣告受眾必須限制為秘魯用戶。只有符合此條件的廣告方可獲得批准。
驗證主要用以檢查格式是否有效，不會驗證此身分證明文件是否屬於真人。

...
           "questions": "[
               ...
               {"type": "ID_AR_DNI"
               },
...

商店定位工具

商店定位工具問題可根據用戶輸入的郵遞區號或郵政編碼，顯示商店定位工具選擇器。

您需要設定分店專頁架構方能使用此問題。請前往 Meta 企業商家幫助中心查閱在 Facebook 上設定分店專頁架構，以了解具體操作方法。

如要新增商店定位工具問題，請新增一個問題物件並將 type 參數設為 STORE_LOOKUP，以及將 context_provider_type 參數設為 LOCATION_MANAGER。

...
           "questions": "[
               ...
               {"type": "STORE_LOOKUP", 
                "label": "Which store do you want to visit?", 
                "context_provider_type": "LOCATION_MANAGER"
               },
...

進階表格設定

加入以下一個或多個表格設定，開發更優質的潛在顧客：

表格成效追蹤，用於追蹤潛在顧客的來源
提高意願表格，用於在表格流程中新增檢查和確認步驟
自主潛在顧客篩選，用於篩選出自主潛在顧客

新增成效追蹤功能

為幫助您追蹤潛在顧客的來源，請在表格中加入 tracking_parameters 欄位，並將其設定為要追蹤的參數鍵值組合清單。此類參數不會在您的廣告中顯示，但可以讓 Meta 向您提供透過表格開發的潛在顧客之相關中繼資料。

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "tracking_parameters": {"your_tracking_parameter_name":"your_tracking_parameter_value"},
           "questions": "[
...

新增提高意願設定

名單型廣告預設會針對潛在顧客數量優化，不過您可以建立表格來篩選出意願更高的潛在顧客。這些類型的潛在顧客可以是可能對特定商品或服務感興趣的用戶，例如有興趣向經銷商預約試駕。此表格設定在表格提交流程中加入了一個步驟，要求用戶在提交表格前先檢查並確認答案。

如要在表格中加入此確認流程，請在建立表格時加入 is_optimized_for_quality 參數，並將其設為 true。

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "is_optimized_for_quality": "true",
           "questions": "[
...

篩選出自主潛在顧客

如要篩選出自主潛在顧客，請在建立表格時加入 block_display_for_non_targeted_viewer 參數，並將其設為 true。

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "block_display_for_non_targeted_viewer": "true",
           "questions": "[
...

回應範例

成功的話，您的應用程式將收到 JSON 回應，其中包含建立廣告時要用到的表格編號。

{
  "id": "leadgen_form_id",
}

第 4 步：建立廣告創意

如要建立附有圖片和表格的廣告創意，請向 /act_AD_ACCOUNT_ID/adcreatives 端點傳送 POST 要求，並在當中加入以下參數：

將 access_token 設為您的專頁存取憑證
包含 link_data 物件及以下參數的 object_story_spec：
- 將 call_to_action 設為包含 type 和 value（設為您的潛在顧客名單表格編號）的物件
- 將 description 設為您廣告創意的說明
- 將 image_hash 設為廣告創意圖片的雜湊值
- 將 link_url 設為您的網址。這不能是您的 Facebook 專頁
- 將 message 設為廣告創意的文字
將 page_id 設為您的 Facebook 專頁編號

注意：建立 link_data 時，與 link 欄位相關的值只能為 https//fb.me/。

link_data.call_to_action 參數必須設定為以下其中一種值：

APPLY_NOW
DOWNLOAD
GET_QUOTE
LEARN_MORE
SIGN_UP
SUBSCRIBE

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值（如 AD_ACCOUNT_ID）替換為您的值。

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/act_AD_ACCOUNT_ID/adcreatives" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "object_story_spec":{ 
             "link_data": { 
               "call_to_action": {
                 "type":"SIGN_UP",
                 "value":{
                   "lead_gen_form_id":"YOUR_FORM_ID"
                 }
               }, 
               "description": "YOUR_AD_CREATIVE_DESCRIPTION", 
               "image_hash": "YOUR_IMAGE_HASH", 
               "link": "http:\/\/fb.me\/", 
               "message": "YOUR_AD_CREATIVE_MESSAGE" 
             }, 
           "page_id": "YOUR_PAGE_ID" 
         }'

採用輪播格式

您可以使用同一 object_story_spec 建立輪播名單型廣告，但需要在 child_attachments 參數中定義一個額外的 lead_gen_form_id 欄位。

您只能為所有子附件指定同一個 <FORM_ID>。

curl \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "link_data": { 
      "message": "My description", 
      "link": "http:\/\/www.google.com", 
      "caption": "WWW.EXAMPLE.COM", 
      "child_attachments": [ 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        } 
      ], 
      "multi_share_optimized": true, 
      "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/act_<AD_ACCOUNT_ID>/adcreatives

加入影片

您也可使用影片來取代名單型廣告創意內的相片。首先，將影片上載到您的廣告影片檔案庫，然後將其用於 object_story_spec 參數中：

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "link_description": "try it out",
         "image_url": "<IMAGE_URL>",
         "video_id": "<VIDEO_ID>",
         "call_to_action": {
           "type": "SIGN_UP",
           "value": {
             "link": "http://fb.me/",
             "lead_gen_form_id": "<FORM_ID>"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

廣告創意回應範例

成功的話，您的應用程式就會收到以下 JSON 回應，其中包含廣告創意編號。

{
  "id": "YOUR_AD_CREATIVE_ID"
}

第 5 步：建立廣告

在建立廣告時，您需將廣告創意與廣告組合連結。如要建立廣告，請向 /act_AD_ACCOUNT_ID/ads 端點傳送 POST 要求。您的要求必須包括以下內容：

將 access_token 設為您的專頁存取憑證
adset_id（來自步驟 2）
creative_id（來自步驟 4）
名稱
狀態

加入創意廣告的廣告要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值（如 AD_ACCOUNT_ID）替換為您的值。

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token"="YOUR_PAGE_ACCESS_TOKEN",
           "adset_id"="YOUR_AD_SET_ID",
           "creative"={ "creative_id": "YOUR_AD_CREATIVE_ID" },
           "status"="PAUSED"
         }'

成功的話，您的應用程式就會收到以下 JSON 回應，其中包含廣告編號。

{
  "id": "YOUR_AD_ID"
}

第 6 步：發佈廣告

在廣告管理員中驗證您的廣告是否確實存在。點擊右上角的檢查並發佈按鈕。選擇宣傳活動、用於宣傳活動的廣告組合及廣告。

您可以從廣告管理員發佈廣告，也可使用 API 發佈。如要使用 API 發佈，請重複執行步驟 4，並將 status 參數設為 ACTIVE。

Meta 會審查您的廣告，此時狀態會顯示為 PENDING_REVIEW。當廣告通過審核後，狀態會變為 ACTIVE，此時即可刊登廣告。

表格管理

獲取表格清單和特定表格問題清單，並將舊表格封存。

獲取表格清單

如要獲取潛在顧客開發表格之清單，請向 /page_id/leadgen_forms 端點傳送 GET 要求，並設定以下參數：

將 access_token 設為您的專頁存取憑證
將 fields（選用）設為以逗號分隔的欄位清單，以獲取名稱和表格編號等具體資訊

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=name,id
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

成功的話，應用程式就會收到以下 JSON 回應，其中包含您的表格清單。您可以使用表格編號獲取與該表格相關的問題或封存該表格。

獲取符合 Messenger 條件的表格清單

只有包含特定要求的表格才符合條件在 Messenger 對話中傳送。

如要獲取符合條件的潛在顧客名單表格之清單，請向 /page_id/leadgen_forms 端點傳送 GET 要求，並設定以下參數：

將 access_token 設為您的專頁存取憑證
將 fields 設為 is_eligible_for_in_thread_forms

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=is_eligible_for_in_thread_forms
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

成功的話，應用程式就會收到以下 JSON 回應，其中包含符合資格的表格之編號清單。

{
  "data": [
    {
      "id": "eligible_form_1_id"
    },
    {
      "id": "eligible_form_2_id"
    }
  ],
...
}

獲取問題清單

如要獲取特定潛在顧客開發表格之問題清單，請向 /page_id/leadgen_form_id 端點傳送 GET 要求，並設定以下參數：

將 access_token 設為您的專頁存取憑證
將 fields 設為 questions

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?fields=questions
    &access_token=page_access_token"

成功的話，應用程式就會收到以下 JSON 回應，其中包含問題清單。

封存表格

您無法刪除潛在顧客名單表格，只能將其封存。表格一經封存：

此表格將不會再出現於表格資料庫（預設設定）
您無法在廣告中使用已封存的表格，此類行為將會令 API 產生錯誤。
在 CF 或 PE 內建立廣告時，您將無法存取已封存表格。

如要封存特定潛在顧客開發表格，請向 /page_id/leadgen_form_id 端點傳送 POST 要求，並設定以下參數：

將 access_token 設為您的專頁存取憑證
將 status 設為 ARCHIVED

要求範例

我們已設定特定格式以便閱讀。請將以粗體及斜體標示的值替換為您的值。

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

成功的話，應用程式就會收到以下 JSON 回應，其中包含 success 設為 true 的物件。

您可以將 status 設為 ACTIVE 並傳送要求，便能重新啟用已封存的表格。

在網站加入表格

如要在您的網站加入表格，您可使用 Facebook JavaScript SDK 來啟動彈出彈出式對話框。執行此 SDK 後，彈出式對話框隨即會啟動。因此，請確保將其與合適的事件連結。您將能夠定義為廣告創意提供必要資料的回呼。Meta 會將表格儲存於專頁層面。

限制

流動裝置上不支援此對話框。

請注意，ad_account_id 值中並不包含 act_。

SDK 範例

請將以粗體及斜體標示的值替換為您的值。


FB.ui({
  method: 'lead_gen',
  page_id: YOUR_PAGE_ID,
  ad_account_id: AD_ACCOUNT_ID, 
}, function(response) {
...
});

您收到的回呼回應中將包含有關表格的資訊。

{
  follow_up_action_text: "YOUR_FOLLOW_UP_ACTION_TEXT",
  follow_up_action_url: "YOUR_FOLLOW_UP_ACTION_URL",
  formID: YOUR_FORM_ID,
  form_url: "YOUR_FORM_URL",
  is_tcpa_compliant: false,
  name: "YOUR_FORM_NAME",
  pageID: YOUR_PAGE_ID,
  privacy_policy_url: "YOUR_PRIVACY_POLICY_URL",
  status: "success"
}

回應屬性

名稱	說明
`custom_disclaimer_responses` 字串	針對自訂免責聲明選框的回應
`follow_up_action_text` 字串	表格最後畫面中的跟進動作文字的說明
`follow_up_action_url` 字串	表格最後畫面中的跟進動作文字的目標位置
`formID` 字串	此為必要項目。表格的編號
`form_url` 字串	表格的網址
`name` 字串	表格的名稱
`pageID` 字串	表格所屬網頁的編號
`privacy_policy_url` 字串	提供的私隱政策網址
`status` 字串	表格建立後傳回 `success`

如果您取消建立，則會看到以下內容：

{
  error_code: 4201,
  error_message: "User canceled the Dialog flow"
}

另請參閱

瀏覽我們的其他指南，進一步了解本文件中的各個部分。

用於廣告的潛在顧客名單表格

準備工作

第 1 步：建立宣傳活動

要求範例

第 2 步：建立廣告組合

要求範例

第 3 步：建立潛在顧客名單表格

要求範例

適用於 Messenger 對話的表格

符合條件的 Messenger 潛在顧客名單表格要求範例

其他問題類型

安排預約時間

身分證明文件

限制

商店定位工具

進階表格設定

新增成效追蹤功能

要求範例

新增提高意願設定

要求範例

篩選出自主潛在顧客

要求範例

回應範例

第 4 步：建立廣告創意

要求範例

採用輪播格式

加入影片

廣告創意回應範例

第 5 步：建立廣告

加入創意廣告的廣告要求範例

第 6 步：發佈廣告

表格管理

獲取表格清單

要求範例

獲取符合 Messenger 條件的表格清單

要求範例

獲取問題清單

要求範例

封存表格

要求範例

在網站加入表格

限制

SDK 範例

回應屬性

另請參閱

推廣 API 開發人員文件

Meta 企業商家幫助中心