Marketing API

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

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

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

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

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

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

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

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

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

    2. В раскрывающемся списке перечислены все страницы, к которым у вас есть доступ с правами рекламодателя.

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

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

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

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

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

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

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

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

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

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

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

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

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

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