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

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

Использование инструмента тестирования

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

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

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

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

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

  • В раскрывающемся списке перечислены все страницы, к которым у вас есть доступ с правами рекламодателя. Выберите одну из них.
  • В раскрывающемся списке "Form" (Форма) выберите форму, для которой нужно создать лид.
  • Чтобы создать лид, нажмите кнопку "Create Lead" (Создать лид). По умолчанию создаваемый лид содержит фиктивные данные.
  • Чтобы настроить отправляемые данные, нажмите Preview Form (Предпросмотр формы).
  • Чтобы создать лид с индивидуально настроенным содержимым, введите нужные данные в форме.
  • После создания лида появится кнопка Track Status (Отслеживать состояние).
  • Чтобы просмотреть состояние лида, нажмите кнопку Track Status. Передача обновления в режиме реального времени в ваш эндпойнт занимает несколько секунд. Пока обновление не будет передано, оно будет находиться в состоянии ожидания. Нажимайте кнопку "Track Status", пока состояние не изменится.
  • После передачи лида в эндпойнт значение в поле состояния изменится. Если обновление в режиме реального времени передано успешно, состояние изменится на success (успех).
  • В случае успешной передачи в таблице также можно будет просмотреть копию данных в формате JSON, передаваемых из Facebook в ваш эндпойнт.
  • Если во время отправки обновления в режиме реального времени возникла проблема, состояние изменится на failed (ошибка). В таких случаях в столбце error_code приводится подробное описание причины проблемы.

Учебное видео

Посмотрите видео, в котором демонстрируется работа с инструментом отладки обновлений в режиме реального времени.

Отправка фиктивных данных

Чтобы протестировать запрос обновлений в режиме реального времени, можно выполнить следующий вызов:

curl \
-F "object_id=<PAGE_ID>" \
-F "object=page" \
-F "field=leadgen" \
-F "access_token=<ACCESS_TOKEN>" \
-F 'custom_fields={"page_id": <PAGE_ID>}' \
"https://graph.facebook.com/<API_VERSION>/<APP_ID>/subscriptions_sample"

Будут получены фиктивные данные, похожие на настоящие.

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

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

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

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

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

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

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

Имейте в виду, что удалить лид может только его владелец.