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

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

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

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

準備工作

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

您需要準備好以下項目：

步驟 1：建立宣傳活動

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

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

要求範例

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

curl -X POST "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "buying_type":"AUCTION",
           "name":"YOUR_LEADADS_CAMPAIGN_NAME",
           "objective":"OUTCOME_LEADS",
           "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
將 destination_type 設為 ON_AD
將 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/v21.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_NAME",
           "optimization_goal":"LEAD_GENERATION",
           "destination_type":"ON_AD",
           "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/v21.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/v21.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_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 設為廣告創意圖片的雜湊值
- 將 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/v21.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/v21.0/act_AD_ACCOUNT_ID/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token"="YOUR_PAGE_ACCESS_TOKEN",
           "name":"YOUR_LEADADS_AD_NAME",
           "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/v21.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/v21.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/v21.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/v21.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

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

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

另請參閱

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

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

準備工作

步驟 1：建立宣傳活動

要求範例

步驟 2：建立廣告組合

要求範例

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

要求範例

適用於 Messenger 對話的表格

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

其他問題類型

安排預約時間

身分證明文件

限制

商店定位工具

進階表格設定

新增成效追蹤功能

要求範例

新增提高意願設定

要求範例

篩選出自主潛在顧客

要求範例

回應範例

步驟 4：建立廣告創意

要求範例

採用輪播格式

加入影片

廣告創意回應範例

步驟 5：建立廣告

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

步驟 6：發佈廣告

表格管理

獲取表格清單

要求範例

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

要求範例

獲取問題清單

要求範例

封存表格

要求範例

另請參閱

推廣 API 開發人員文件

Meta 企業商家幫助中心