市场营销 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>"

仅该潜在客户的所有者能将其删除。