Трекинг Telegram Ads

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

Макросы, которые поддерживаются для веб-ссылок в Telegram Ads

Для детального трекинга используйте макросы. AdsGram автоматически заменит их на реальные данные в вашей трекинговой ссылке.

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {click_id}
• {ip}
• {campaign} — название кампании

ВАЖНО

Эта поддержка распространяется только на веб-ссылки в Telegram Ads. Макросы AdsGram по-прежнему не поддерживаются для ссылок, ведущих на Telegram Mini Apps (TMA), ботов и каналы в Telegram Ads.

ВНИМАНИЕ:

Для корректной работы API подтверждения конверсий для веб-ссылок в кампаниях Telegram Ads в ссылке рекламной кампании должен присутствовать макрос {campaign_id}. Если обязательный макрос отсутствует, отслеживание конверсий работать не будет.

В кампаниях Telegram Ads макросы AdsGram не поддерживаются для ссылок, ведущих на Telegram Mini Apps (TMA), ботов или каналы. Поэтому API подтверждения конверсий нельзя использовать для отслеживания конверсий по таким ссылкам в кампаниях Telegram Ads. Подробнее читайте ниже в разделе Трекинг конверсий для ссылок внутри Telegram в кампаниях Telegram Ads.

ВАЖНО

Макрос {publisher_id} раскрывается только как уникальный идентификатор издателя — без указания его названия или другой идентифицирующей информации.

Пример ссылки с макросами:

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}

Кабинет подсвечивает добавленные в ссылку макросы и пропущенные .

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

Параметры:

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

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

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

  

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

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

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

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

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

1. Выберите кампанию в Telegram Ads. Используйте существующую активную кампанию или создайте новую.
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&campaignid=72156&goaltype=2

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

Замените YOUR_UNIQUE_TOKEN на токен вашего аккаунта, а 72156 — на ID вашей рекламной кампании.

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

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

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

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

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

Трекинг конверсий для ссылок внутри Telegram в кампаниях Telegram Ads

В кампаниях Telegram Ads макросы AdsGram не поддерживаются для ссылок, ведущих на объекты внутри Telegram, и не передаются в такие рекламные ссылки. Поэтому API подтверждения конверсий нельзя использовать для отслеживания конверсий по ссылкам, ведущим на Telegram Mini Apps (TMA), ботов или каналы.

Для ссылок внутри Telegram в кампаниях Telegram Ads целевые события автоматически передаются в Goal 1 по умолчанию:

• TMA — запуск TMA;
• Боты — запуск бота;
• Каналы — подписка на канал.

Конверсии передаются автоматически, поэтому дополнительная настройка не требуется.