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

ВНИМАНИЕ

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

Параметры:

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

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

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

  

• tgid — Telegram ID пользователя, совершившего переход по рекламной ссылке.

• campaignid — ID рекламной кампании AdsGram, к которой относится конверсия. Соответствует значению макроса {campaign_id}, передаваемому в рекламной ссылке. AdsGram подставляет значение макроса при переходе пользователя по ссылке.

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

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

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

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

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

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

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&tgid=98110997&goaltype=2&campaignid=72156

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

Замените YOUR_UNIQUE_TOKEN на токен вашего аккаунта, 98110997 — на Telegram ID пользователя, перешедшего по рекламной ссылке, а 72156 — на ID вашей рекламной кампании.

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

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

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

1. Создайте или выберите кампанию и настройте рекламную ссылку в соответствии с документацией. Убедитесь, что в ссылке передаётся макрос {campaign_id}.
2. Дождитесь нескольких кликов по рекламной ссылке.
3. Получите Telegram ID (tgid) пользователя, который перешёл по ссылке выбранной кампании.
4. Отправьте тестовый постбек вручную. Передайте параметр goaltype=1, действительный token, Telegram ID пользователя в параметре tgid и ID тестовой кампании в параметре campaignid.
5. Убедитесь, что запрос обработан успешно, а конверсия появилась в статистике AdsGram для выбранной кампании.

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