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. Щоб підключити:

  • Перейдіть у розділ Collaboration → Partner Marketplace в AppsFlyer
  • Знайдіть AdsGram (маркетингова назва) або adsgram1e_int (технічна назва) та оберіть партнера

2. Налаштування передачі встановлень ​

Відкрийте вкладку Integration:

  • Увімкніть Activate Partner
  • Вимкніть AAP (має бути вимкнено як в налаштуваннях додатку, так і на цій вкладці)
  • Для 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 та додасть необхідні макроси
  • Вкажіть у посиланні ваш package/bundle name, якщо він не вказаний (наприклад: id12345678 або com.app.name)
  • У полі Link, що з'явиться, вкажіть пряме посилання на продукт (Google Play / App Store / RuStore)

7. Примітки: ​

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