Настройка постбеков о конверсиях для веб-ссылок

ВНИМАНИЕ

Инструкции в этом разделе не применимы к кампаниям в Telegram Ads. Подробнее о настройке постбеков для веб-ссылок в Telegram Ads читайте в этом разделе.

Параметры:

• token — Уникальный токен, связанный с вашим аккаунтом AdsGram. Доступен в рекламном кабинете. При необходимости его можно сгенерировать повторно.

  Где получить token:

  1. Откройте рекламный кабинет AdsGram.
  2. Нажмите на профиль в правом верхнем углу.
  3. Найдите параметр token и скопируйте его, нажав на кнопку .

  

• record — Уникальное для каждого клика/показа значение макроса {record_data}, автоматически подставляемое AdsGram в трекинговую ссылку.

• goaltype — Параметр, указывающий тип конверсии (этап воронки), который помогает сегментировать различные целевые действия пользователя. Принимает целочисленные значения от 1 до 3.

  Использование goaltype:

  1. Определите этапы воронки в вашем продукте или сервисе.
  2. Сопоставьте этапы со значениями goaltype:
     • 1. Регистрация
     • 2. Первый депозит/покупка
     • 3. Повторный депозит/покупка
  3. Настройте отправку конверсий на нужных этапах пользовательского пути.
  4. Добавьте параметр goaltype к вашему API-запросу при отправке.
  5. Используйте данные в аналитике для детального анализа эффективности по разным типам конверсий.

Как настроить отправку конверсий:

1. Выберите кампанию. Используйте существующую активную кампанию или создайте новую.
2. Настройте рекламную ссылку. Убедитесь, что в ней присутствует макрос {record_data}.
3. Получите token. Скопируйте уникальный токен из рекламного кабинета AdsGram.
4. Настройте отправку постбеков. На стороне вашего сервера отправляйте API-запрос в AdsGram, когда пользователь выполняет целевое действие.
5. Передавайте правильный тип конверсии. Указывайте соответствующее значение goaltype, если хотите различать этапы воронки.
6. Проверьте интеграцию. Выполните тестовый сценарий из раздела Тестирование интеграции и убедитесь, что конверсии поступают в статистику AdsGram.

Пример API-запроса:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a&goaltype=2

В примере передаётся конверсия типа 2 (например, первый депозит или покупка).

Замените YOUR_UNIQUE_TOKEN на токен вашего аккаунта, а 7f3a1b6c5d2e4f8a — на значение макроса {record_data} из рекламной ссылки.

Ожидаемый ответ: 200 OK — успешная регистрация конверсии.

Тестирование интеграции

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

1. Создайте или выберите кампанию и настройте рекламную ссылку в соответствии с документацией. Убедитесь, что в ссылке передаётся макрос {record_data}.
2. Дождитесь нескольких кликов по рекламной ссылке.
3. Отправьте тестовый постбек вручную, передав параметр goaltype=1. В параметре token укажите действительный token, в параметре record — фактическое значение макроса {record_data} из рекламной ссылки, по которой был совершён переход.
4. Убедитесь, что запрос обработан успешно, а конверсия появилась в статистике AdsGram для выбранной кампании.

• Конверсия появилась в статистике — интеграция успешно настроена и работает.
• Сервер вернул ошибку — проверьте URL запроса, token, значения параметров record и goaltype.
• Запрос выполнен успешно, но конверсия не появилась — статистика обновляется раз в час. Если спустя час данные не появились, напишите в поддержку AdsGram или своему менеджеру. К обращению обязательно приложите логи запроса и ответа.