AdsGram

Русский

English
中文

Русский

English
中文

Оформление

Трекинг ​

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

Макросы, которые раскрывает AdsGram ​

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

  • {campaign_id}
  • {banner_id}
  • {publisher_id}
  • {click_id}
  • {record_data}

ВНИМАНИЕ:

Для работы трекинга обязательным является специальный макрос {record_data}. Без этого макроса отслеживание конверсий работать не будет.

ВАЖНО

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

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

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

ВАЖНО

Если ваша посадочная ссылка открывает TMA через параметр start, используйте, например, следующую ссылку:

https://t.me/[name_of_the_bot]?start=[unique_referral_link]_{campaign_id}_{banner_id}_{publisher_id}_{click_id}_{record_data}

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

Selected macroses

API для подтверждения конверсий ​

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

API Endpoint — это специальный URL, на который ваш сервер отправляет запрос в момент совершения пользователем конверсии. Это позволяет AdsGram в реальном времени получать данные о результатах кампаний.

Endpoint:

https://api.adsgram.ai/confirm_conversion

Параметры запроса: ​

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

    Для того, чтобы получить token необходимо перейти в профиль в правом левом углу и нажать на кнопку Copy. Copy macros

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

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

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

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

Как использовать: ​

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

Пример запроса: ​

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

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

Интеграции с партнерами ​

AdsGram интегрирован с Adjust и AppMetrica. Также возможна работа с ссылками других трекеров, однако в этом случае AdsGram не сможет передавать необходимую информацию в трекер для более детализированной аналитики.

ВАЖНО

Теперь рекламодатели, использующие Adjust и AppMetrica для своего мобильного приложения, могут получить данные о конверсиях, которые совершили пользователи после клика по рекламным баннерам AdsGram.

Работа с Adjust ​

1. Выбор сети ​

В разделе Campaign Lab перейдите в раздел Партнёры

  • Нажмите Новый партнёр.
  • В открывшемся окне в строке поиска введите AdsGram и выберите эту сеть.
  • После выбора нажмите Далее.

2. Выбор приложения ​

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

3. Настройка обмена данными ​

В этом разделе вы настраиваете параметры обмена данными с AdsGram, выбираете, какие события и параметры приложения будут передаваться в AdsGram для анализа.
Подробная инструкция на странице документации Adjust.

4. Получение трекинг-ссылки ​

После настройки всех параметров и маппинга, вы получите уникальную трекинговую ссылку, которую нужно использовать при создании рекламных кампаний в AdsGram.
Также при необходимости вы можете добавить дополнительные параметры, такие как UTM-метки для более точного отслеживания источников трафика.

ВАЖНО

После настройки трекинговых ссылок данные о конверсии пользователей в установки приложения и in-app события после клика по рекламе AdsGram отобразятся только в кабинете Adjust.

Работа с AppMetrica ​

Создание трекера: ​

  1. После регистрации в личном кабинете AppMetrica, интеграции SDK в приложение и настройки отслеживания целевых действий перейдем к созданию трекера.
  2. Укажите название трекера.
  3. Добавьте приложение.

Подробная инструкция на странице документации AppMetrica.

Передача установок: ​

  1. Выберите получателя постбека (AdsGram).
  2. Укажите тип события, которое нужно передавать в AdsGram.
  3. Получите Postback URL — ссылку, при помощи которой события и установки будут передаваться на сервер AdsGram.
  4. После создания постбэков вы получите трекинговую ссылку. Эту ссылку нужно использовать при заведении рекламных кампаний в AdsGram. Также при необходимости вы можете добавить дополнительные параметры, например UTM-метки.

Работа с Keitaro ​

1. Создание трекера в Keitaro ​

  1. После входа в панель управления Keitaro перейдите в раздел Trackers.
  2. Нажмите "Create tracker" или "Новый трекер".
  3. Укажите название трекера и выберите тип "AdsGram" из списка рекламных сетей.
  4. Нажмите "Сохранить" для создания трекера.

2. Настройка постбэка в Keitaro ​

  1. В настройках созданного трекера перейдите в раздел "Postback" или "API Integration".
  2. В поле "Postback URL" введите адрес эндпоинта AdsGram:
    https://api.adsgram.ai/confirm_conversion
  3. Добавьте обязательные параметры запроса:
    token=YOUR_UNIQUE_TOKEN&record={record_data}
    Где YOUR_UNIQUE_TOKEN — токен из вашего профиля AdsGram.

3. Настройка кампании в AdsGram ​

  1. Скопируйте Click URL из настроек трекера Keitaro (пример: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
  2. В кабинете AdsGram при создании кампании вставьте эту ссылку в поле Click URL.
  3. Дополните ссылку обязательными макросами AdsGram:
    https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}
  4. Убедитесь, что макрос {record_data} присутствует в итоговой ссылке.

4. Настройка целей (Goals) в Keitaro ​

  1. В настройках трекера Keitaro перейдите в раздел "Goals" или "Конверсии".
  2. Создайте новую цель (goal) или выберите существующую.
  3. Для созданной цели активируйте отправку постбэка на указанный ранее URL.
  4. Настройте условия срабатывания (при подтверждении конверсии, при определенном статусе).

Работа с Kochava ​

1. Создание трекера в Kochava ​

  1. После входа в панель управления Kochava перейдите в раздел Apps & Assets.
  2. Нажмите "Add New" и выберите "App" для создания нового приложения-трекера.
  3. Заполните обязательные поля:
    • Platform: Выберите платформу приложения (iOS, Android, Web).
    • App Name: Укажите название приложения.
    • Store ID: Введите ID приложения в магазине (App Store ID, Package Name и т.д.).
  4. Нажмите "Save" для создания приложения.

2. Настройка партнерской интеграции ​

  1. В карточке созданного приложения перейдите в раздел "Partner Management".
  2. Нажмите "Add Partner".
  3. В списке партнеров найдите и выберите "AdsGram".
  4. Нажмите "Next" для перехода к настройкам.

3. Настройка параметров интеграции ​

  1. В разделе "Integration Settings" выберите тип отслеживания (Click-Through, View-Through или Hybrid).
  2. Активируйте опцию "Server-to-Server Postbacks".
  3. В поле "Postback URL" введите адрес эндпоинта AdsGram:
    https://api.adsgram.ai/confirm_conversion
  4. Добавьте параметры в "Postback Parameters":
    • Обязательный параметр: {record_data} (будет автоматически подставлен Kochava).
    • Добавьте параметр: token со значением YOUR_UNIQUE_TOKEN (токен из профиля AdsGram).
  5. Настройте макросы для передачи данных:
    • {campaign_id} → campaign_id
    • {click_id} → click_id
    • {publisher_id} → publisher_id

4. Настройка кампании в AdsGram ​

  1. Вернитесь в раздел Kochava "Tracking Links" и создайте трекинг-ссылку (пример: https://your-app.kochava.com/install?data={encrypted_data}).
  2. В кабинете AdsGram при создании кампании вставьте эту ссылку в поле Click URL.
  3. Дополните ссылку обязательными макросами AdsGram через параметры:
    https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}
  4. Убедитесь, что макрос {record_data} присутствует в финальной ссылке.

5. Настройка событий (Events) в Kochava ​

  1. В панели Kochava перейдите в раздел "Events".
  2. Создайте новое событие или выберите стандартное (например, install, purchase).
  3. Для выбранного события настройте отправку постбэка:
    • Активируйте "Send Postback".
    • Выберите созданную интеграцию с AdsGram.
    • Настройте фильтры и условия срабатывания.
  4. Сохраните конфигурацию событий.

6. Проверка интеграции ​

  1. Используйте "Test Mode" в Kochava для проверки установок.
  2. Проверьте входящие запросы в логах Kochava и AdsGram.
  3. Убедитесь в корректной передаче параметра record_data.