行銷 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>"

僅限潛在顧客的擁有者可以刪除潛在顧客。