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

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

テストツールの使用

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

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

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

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

このツールを使用して作成したリードは、どの広告にも関連付けられていないオーガニックリードです。1つのフォームで作成できるリードは1つだけです。そのため、同じフォームでリードを再作成する場合は、[リードの削除]をクリックしてリードを削除した上で、もう一度作成します。

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

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

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

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

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

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

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

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

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

リードがエンドポイントにプッシュされると、ステータスフィールドが変化します。RTUが正常に起動すると、ステータスは[成功]になります。

成功した場合は、表にペイロードも表示されます。ここに表示されるペイロードは、Facebookによってエンドポイントに送信された内容のコピーです。コンテンツを確認し、JSONを処理します。RTUの送信時に問題が発生した場合は、ステータスが[失敗]になります。その場合、error_code列に失敗の原因に関する詳細情報が示されます。

リードのテスト

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

テストリードの作成

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

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

  • 指定のリード獲得広告フォームに既存のテストリードが存在してはなりません。
  • フォームを作成したページに対して、Advertiser以上のページの管理権限を持っている必要があります。
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

次のパラメーターを渡すことにより、テストリードのコンテンツをカスタマイズできます。

  • field_data: namevaluesのペアが指定されたベクトルパラメーター。
  • custom_disclaimer_responses: checkbox_keyis_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>"

リードを削除できるのは、そのリードの所有者だけです。