AdsGram

Русский

English
中文
Español
Português
Türkçe
العربية
فارسی
Français
Українська
Bahasa Indonesia
हिंदी

Русский

English
中文
Español
Português
Türkçe
العربية
فارسی
Français
Українська
Bahasa Indonesia
हिंदी

Оформление

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

AdsGram поддерживает интеграцию с популярными системами атрибуции и трекинга. С их помощью вы можете отслеживать переходы, установки и действия пользователей после взаимодействия с рекламой AdsGram, а также передавать данные о конверсиях обратно в AdsGram, что позволяет оптимизировать кампании на стоимость конверсий (tCPA).

Доступны следующие интеграции:

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

Работа с Adjust ​

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

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

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

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

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

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

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

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

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

5. Передача данных о конверсиях ​

По умолчанию данные о действиях пользователей передаются из Adjust в AdsGram и автоматически распределяются по соответствующим целям:

  • Сессии (Sessions) - в Goal 1
  • Установки (Installs) - в Goal 2

ВАЖНО

Для запуска tCPA-кампании необходимо получить не менее 10 конверсий по выбранной цели. Например, если кампания запускается на Goal 2, необходимо получить не менее 10 конверсий по Goal 2.

Работа с 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 и параметр record, значение которого должно соответствовать имени параметра record, указанному в Tracking Link.

    Например, если в Tracking Link вы передаёте макрос AdsGram следующим образом:

    https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

    то в постбэке Keitaro необходимо указать:

    https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

    Где:

    • YOUR_UNIQUE_TOKEN — токен из вашего профиля AdsGram
    • record — параметр, который вы передаёте в Tracking Link
    • {_record} — макрос, который передаёт исходное значение параметра record в постбэк

    ВНИМАНИЕ:

    Чтобы получать необработанные (исходные) значения от трекера необходимо добавить “_” (нижнее подчеркивание) перед макросами. Это актуально только для трекера Keitaro и необходимо для предотвращения XSS-атак.

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.

Работа с AppsFlyer ​

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

После настройки интеграции AdsGram будет получать:

  • установки приложения (Installs) - они автоматически передаются в Цель 1
  • все остальные In-App Events - они автоматически передаются в Цель 2

Дополнительная настройка или маппинг событий на цели в AdsGram не требуется. Например, если из AppsFlyer передаются события registration, purchase, deposit и т. д., все они автоматически учитываются в Цели 2.

ВАЖНО

tCPA-кампании можно запускать только на Цель 1, то есть оптимизировать их можно только на установки приложения. In-App Events, передаваемые в Цель 2, не могут использоваться в качестве цели для tCPA-кампании.

1. Подключение AdsGram через Integrated Partners ​

AdsGram является интегрированным партнёром AppsFlyer. Для подключения:

  • В панели AppsFlyer перейдите в Collaboration → Partner Marketplace
  • В строке поиска введите AdsGram (маркетинговое имя) или adsgram1e_int (техническое имя) и выберите партнёра

2. Настройка передачи установок ​

Откройте вкладку Integration:

  • Активируйте переключатель Activate Partner
  • Отключите AAP (отключается в двух местах: в app settings и на этой вкладке)
  • Для Install Postback выберите: This partner only. В этом случае AdsGram будет получать установки, которые были привлечены через AdsGram. В AdsGram такие установки будут учитываться в Цели 1

ВАЖНО

Если вы хотите запускать кампанию с оптимизацией на установки, убедитесь, что установки передаются в AdsGram и отображаются в Цели 1. tCPA-кампании на установки можно запускать только на Цель 1.

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

Настройте постбэки для in-app событий (покупки, регистрации и др.) в блоке In-App Event Postbacks:

  • Добавьте события:
    • purchase - покупки
    • af_complete_registration - регистрации
  • В поле for users from укажите This partner only
  • В AdsGram передаётся только само событие без его параметров и дохода, поэтому в поле Including можно выбрать No values & no revenue

Рекомендуется:

  • Разрешить настройку интеграции (кроме постбэков событий)
  • Разрешить настройку постбэков событий (для корректного маппинга)

Остальные разрешения (доступ к retention-отчётам, событиям, доходу и т.д.) — по необходимости.

После настройки нажмите Save Integration.

4. Настройка Tracking Link ​

Откройте вкладку Tracking Link:

  • AppsFlyer автоматически сформирует ссылку для AdsGram и добавит необходимый идентификатор партнёра: pid=adsgram1e_int
  • 4 макроса AdsGram будут заполняться автоматически (af_storeid, c и др.)
  • При необходимости добавьте статичные параметры как дополнительные
  • В разделе Click-through attribution выберите окно атрибуции (по умолчанию 7 дней, можно изменить)

5. Настройка Permissions ​

Откройте вкладку Permissions и включите обязательные разрешения:

  • Доступ к приложениям в дашборде
  • Агрегированные конверсии
  • События
  • Protect360

👉 Нажмите Save Integration

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

При создании кампании в AdsGram:

  • Вставьте Click link в поле Link и система автоматически сгенерирует AppsFlyer tracking link и добавит необходимые макросы
  • Укажите в ссылке ваш package/bundle name, если он не указан (например: id12345678 или com.app.name)
  • В появившемся поле Link укажите прямую ссылку на продукт (Google Play / App Store / RuStore)

7. Особенности: ​

  • Настройки применяются ко всем баннерам в рамках кампании
  • Рекламодатель отвечает за корректность параметров ссылки и атрибуцию
  • При использовании собственной ссылки обязательно укажите прямую ссылку на продукт в поле Link