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 інтегрований з 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.

    Увага

    Щоб отримувати необроблені (вихідні) значення від трекера необхідно додати "_" (нижнє підкреслення) перед макросами. Це актуально лише для трекера 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}.