テストとトラブルシューティング

このAPIを使って、テストリードを作成したり削除したりできます。

テストツールの使用

このツールを使うと、フォームのテストリードを作成および削除できます。ただし、このツールを開発者モードで使うことはできません。

フォームごとに作成できるテストリードは1つだけです。新しいリードを作成するには、既存のリードを削除する必要があります。

リアルタイムアップデート統合のデバッグ

このツールを使用して、FacebookのWebhooksとの統合が正常に行われているかどうかをテストします。このツールを使用して統合をデバッグするための手順は次のとおりです。

1. テストツールに移動します。

ドロップダウンに、広告主としてアクセスできるすべてのページがリストされます。


2. ドロップダウンからページを選択します。


3. [フォーム]ドロップダウンで、リードの作成に使用するフォームを選択します。


4. [リードの作成]をクリックして、リードを作成します。デフォルトでは、作成されるリードにはダミーデータが含まれます。


5. 送信されるデータをカスタマイズするには、[フォームのプレビュー]をクリックします。


6. カスタムコンテンツが含まれるリードを作成するには、フォームレベルで必要なデータを入力します。


7. リードが作成されると、[ステータスのトラッキング]ボタンが表示されます。


8. [ステータスのトラッキング]をクリックすると、リードのステータスが表示されます。ご使用のエンドポイントに対してRTUが起動するまで数秒かかります。起動までの間、RTUのステータスは[保留中]になります。ステータスが変わるまで、[ステータスのトラッキング]のクリックを繰り返します。

リードのテスト

アプリのWebhooksをセットアップした後、[テスト]ボタンを使ってリードをテストできます。このボタンは、アプリのWebhooksダッシュボード内にあります。

テストリードの作成

/{FORM_ID}/test_leadsにPOSTリクエストを送信することによって、テストリードを作成できます。

このリクエストが正常に実行されるには、次の要件を満たしている必要があります。

• 指定のリード獲得広告フォームに既存のテストリードが存在してはなりません。
• フォームを作成したページに対して、Advertiser以上のページの管理権限を持っている必要があります。
• API呼び出しでページアクセストークンを使用する必要があります。

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