Тестирование и устранение неполадок

С помощью этого API можно создавать и удалять тестовые лиды.

Работа с инструментом тестирования

С помощью этого инструмента можно создавать тестовые лиды для своих форм и удалять их. Обратите внимание: инструмент нельзя использовать в режиме разработчика.

Для одной формы можно создать только один тестовый лид. Чтобы создать новый лид, понадобится удалить существующий.

Отладка интеграции обновлений в режиме реального времени

С помощью этого инструмента можно проверить успешность интеграции с функцией Facebook Webhooks. Ниже приводятся инструкции по работе с этим инструментом.

С помощью этого инструмента создаются органические лиды, которые не связаны с рекламой. Для каждой формы можно создать только один лид. Поэтому, чтобы создать новый лид для той же формы, нужно сначала удалить существующий. Для этого нажмите Удалить лид.

Откройте инструмент тестирования.

Выберите одну из них.

В раскрывающемся списке Форма выберите форму, для которой нужно создать лид.

Нажмите Создать лид, чтобы создать лид. По умолчанию создаваемый лид содержит фиктивные данные.

Чтобы настроить отправляемые данные, нажмите Предпросмотр формы.

Чтобы создать лид с пользовательским контентом, введите нужные данные в форме.

После создания лида появится кнопка Отслеживать статус.

Чтобы посмотреть состояние лида, нажмите Отслеживать статус. Передача обновления в режиме реального времени на вашу конечную точку занимает несколько секунд. Пока обновление не будет передано, оно будет находиться в состоянии ожидания. Нажимайте Отслеживать статус, пока статус не изменится.

После передачи лида на конечную точку значение в поле статуса изменится. Если обновление в режиме реального времени передано, будет отображаться состояние успешно.

В случае успешной передачи в таблице появятся полезные данные. Отображаемые полезные данные — это копия данных, которые передает Facebook на вашу конечную точку. Вы можете посмотреть контент и обработать JSON. Если во время отправки обновления в режиме реального времени возникла проблема, будет отображаться состояние ошибка. В таких случаях в столбце error_code указываются сведения о причине проблемы.

Тестирование лидов

После настройки Webhooks для приложения можно протестировать лиды, нажав на кнопку "Тест". Она находится на панели Webhooks для приложения.

Создание тестовых лидов

Чтобы создать тестовый лид, выполните запрос POST к конечной точке /{FORM_ID}/test_leads.

Для выполнения этого запроса должны соблюдаться следующие условия:

для указанной формы для лидов не должно существовать тестовых лидов;
у вас должна быть по крайней мере роль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"

В результате показанных выше вызовов создаются фиктивные лиды, которые не связаны с рекламой.

Получение тестовых лидов

Чтобы получить тестовые лиды, связанные с рекламой для лидов, выполните вызов GET к конечной точке {FORM_ID}/test_leads.

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

Удалить лид может только его владелец.