推廣 API

測試與解決疑難

使用此 API 來建立和刪除測試潛在顧客資料。

使用測試工具

您可以使用此工具建立與刪除表格的測試潛在顧客資料；但是，您無法在開發人員模式下使用此工具。

您可以為每個表格建立一項測試潛在顧客資料。您需要刪除一項現有潛在顧客資料，才能建立新資料。

為即時更新整合工具除錯

使用此工具來測試您與 Facebook 的 Webhooks 整合是否成功。以下是使用此工具來為整合工具除錯的步驟。

使用此工具建立的潛在顧客資料是與任何廣告均無關聯的自主潛在顧客。您只能在每份表格中建立一項潛在顧客資料。因此，如要在同一表格重新建立潛在顧客資料，請首先點擊刪除潛在顧客以刪除潛在顧客資料，然後才再次建立。

  1. 前往測試工具。

    2. 下拉式選單會列出您在當中擁有廣告客戶存取權的所有專頁。

  2. 從下拉式選單中選擇一個專頁。

  3. 在表格下拉式選單中，選擇要用於建立潛在顧客資料的表格。

  4. 點擊建立潛在顧客以建立潛在顧客資料。您建立的潛在顧客資料中預設會包含虛設資料。

  5. 點擊預覽表格以自訂傳送的資料。

  6. 在表格級別輸入所需資料，以建立包含自訂內容的潛在顧客資料。

  7. 建立潛在顧客名單後，追蹤狀態按鈕便會出現。

  8. 點擊追蹤狀態以查看潛在顧客的狀態。系統需時數秒才能將 RTU 觸發至您的端點。在這之前，您會看到 RTU 處於處理中狀態。再次點擊追蹤狀態，直至看到狀態變更為止。

當系統將潛在顧客資料推送至您的端點時，狀態欄位便會有所變更。如果系統能成功觸發 RTU，狀態將變為成功。

在成功的情況下，您亦會在表格中看到裝載。此處顯示的裝載是 Facebook 傳送到您端點的內容之副本，因此您應查看有關內容並處理 JSON。如果在傳送 RTU 期間出現問題，狀態將會變為失敗。在這種情況下，error_code 直欄會提供失敗原因的詳情。

潛在顧客資料測試

在為您的應用程式設定 Webhooks 後，您可以按下「測試」按鈕來測試您的潛在顧客資料。此按鈕位於應用程式的 Webhooks 管理中心內。

建立測試潛在顧客資料

您可以向 /{FORM_ID}/test_leads 發出 POST 要求，以建立測試潛在顧客資料。

若要令此要求成功，就需要滿足以下要求：

  • 您不應為指定的名單型廣告表格使用現時的測試潛在顧客資料。
  • 在建立表格的專頁中，您必須具備 Advertiser 或以上的專頁角色。
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

您可以傳送以下參數，以自訂測試潛在顧客資料：

  • field_data：包含 name 和 values 組合的向量參數。
  • custom_disclaimer_responses：包含 checkbox_key 和 is_checked 組合的向量參數。
curl \
  -F "field_data=[{'name': 'favorite_color?', 'values': ['yellow']}, {'name': 'email', 'values': ['test@test.com']}]" \
  -F "custom_disclaimer_responses=[{'checkbox_key': 'my_checkbox', 'is_checked': true}]" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

在上述呼叫中建立的潛在顧客資料均為虛假的潛在顧客資料，因此與任何廣告均無關聯。

查閱測試潛在顧客資料

您可以向 {FORM_ID}/test_leads 端點發出 GET 呼叫，以查閱與名單型廣告相關的測試潛在顧客資料。

curl \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

刪除測試潛在顧客資料

如果您正在測試整合工具，並且想刪除潛在顧客資料以重新提交資料，請發出以下的 API 呼叫：

curl -X DELETE \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<LEAD_ID>"

只有潛在顧客資料的擁有者可以刪除有關資料。