Інтеграція: що це таке і як інтегруватися з Admitad

Що таке інтеграція

Системна інтеграція — це процес операційного об’єднання двох різних незалежних систем: наприклад, вашого сайту чи застосунку та системи Admitad.

Якщо ви плануєте приєднатися до партнерської програми Admitad, ви повинні інтегрувати свою систему з Admitad, щоб мати змогу:

Відстежувати цільові дії ваших відвідувачів сайту чи користувачів застосунку.
Надсилати звіти про активність у Admitad.

У таких звітах про цільові дії міститиметься наступна інформація: код програми, код дії, код винагороди, номер замовлення, сума замовлення та інші деталі дії.

Система Admitad збереже всі дані, які надішлете ваш сайт та/або застосунок, і відстежить вебмайстера, з рекламної платформи якого користувач перейшов на ваш сайт і виконав цільову дію. Це гарантує правильне призначення цільової дії.

Правильне налаштування процесу інтеграції гарантує, що всі цільові дії користувачів будуть коректно зареєстровані та правильно призначені вебмайстерам.

Таким чином, ви зможете контролювати витрати за вашу партнерську програму, а ваші вебмайстери отримають повну і своєчасну винагороду.

Детальніше про інтеграцію мобільного застосунку.

Методи інтеграції з Admitad

Не всі методи інтеграції забезпечують точне відстеження дій. Наприклад, якщо дані про замовлення передаються в Admitad із сайту рекламодавця через браузер користувача, частина з них може бути втрачена через налаштування конфіденційності браузера та роботу блокувальників реклами — у результаті вебмайстери не отримають свою заслужену винагороду за залучені замовлення.

Пріоритетні методи інтеграції S2S

Щоб дані про дії не втрачались під час передачі, рекомендуємо надсилати їх безпосередньо в Admitad з основного джерела — тобто там, де формуються замовлення. Це називається сервер-до-сервера (S2S) відстеженням.

Основним джерелом даних може бути:

сервер, на якому розміщені бази даних із замовленнями;
CRM, у якій формуються замовлення;
CMS, у якій формуються замовлення.

Пріоритетні методи інтеграції з Admitad:

Інтеграція через postback-запит із сервера, CRM чи CMS.
Інтеграція через XML-файл — експорт замовлень із сервера, CRM або CMS в XML-файл, до якого Admitad має доступ за посиланням.
Інтеграція через API — якщо у вас є власний API або плануєте його розробити.
Інтеграція через плагін Shopify — якщо ваш сайт створено на платформі Shopify.

Рекомендуємо обрати один із цих методів інтеграції, оскільки лише вони повністю забезпечують передачу даних. Якщо технічні можливості вашого сайту не дозволяють це зробити, зверніться до розробника і попросіть налаштувати для вас S2S-з'єднання. Ми, у свою чергу, готові надати йому консультацію щодо логіки реалізації.

Небажані методи інтеграції

Окрім S2S-з'єднання можливі й інші методи інтеграції, але вони пов’язані з ризиками втрати даних. Тому ми не рекомендуємо їх використовувати, хоча технічно це можливо.

З 1 червня 2025 року Admitad переходить на новий стандарт інтеграції та застосовуватиме розрахунок Loss Adjustment для незареєстрованих замовлень, спричинених браузерними методами відстеження, як-от GTM, Tag Tag та іншими подібними типами інтеграції.
Наполегливо рекомендуємо переходити на нові стандарти інтеграції вже зараз, щоб забезпечити коректне відстеження і уникнути можливих розбіжностей у доходах. Наша команда готова допомогти із переходом. Детальніше читайте тут.

До небажаних методів інтеграції належать:

Будь-яка frontend-інтеграція — коли дані про дію передаються не із сервера, а з сайту через браузер користувача. Обмеження браузера (наприклад, блокувальники реклами) призводять до того, що частина даних не буде передана.
Інтеграція через сторонні системи веб-аналітики, наприклад Google Analytics 4. Такі системи також отримують статистику не із сервера, а з сайту.
Використання платформи трекінгу: Affise, Trackier тощо. Хоча дані передаються із трекінг-платформи в Admitad через S2S, сама платформа зазвичай отримує ці дані через браузер користувача.

Вибір методу інтеграції

Для точного відстеження цільових дій рекомендуємо обирати пріоритетні методи інтеграції, описані нижче. В іншому вибір залежить від технічних можливостей вашого сайту.

Схема вибору методу інтеграції

Пріоритетні методи позначені зеленим, небажані — червоним.

Якщо технічні можливості вашого сайту не дають змоги одразу обрати пріоритетний метод інтеграції, зверніться до розробника і попросіть налаштувати для вас S2S-з'єднання. Ми, у свою чергу, готові надати йому консультації щодо логіки реалізації.

Особливості та переваги методів інтеграції

Пріоритетні методи

Postback-інтеграція
XML-інтеграція
Власна API-інтеграція
Інтеграція через плагін Shopify

Налаштування дедуплікації та cross-device трекінгу доступні у всіх цих методах інтеграції.

Дедуплікація — це метод обробки даних для усунення дублікатів одних і тих самих даних, зокрема цільових дій. Цей метод також застосовується для визначення платних джерел трафіку й призначення відповідних замовлень.
Платні джерела трафіку — це сторонні ресурси, за допомогою яких ви залучаєте клієнтів на певних умовах (наприклад, оплата за відвідування сайту, перегляд реклами, застосунок, реєстрацію чи покупку). Сюди належать таргетована реклама, контекстна реклама, спонсорські публікації у блогерів тощо.
Cross-device трекінг — це технологія, яка дозволяє відстежувати цільові дії користувачів на різних пристроях. Детальніше

Postback-інтеграція

У межах postback-інтеграції ваш сервер надсилатиме запит або postback на сервер Admitad з даними цільових дій, здійснених користувачами вашого сайту.

Сервер Admitad аналізує ці дані й здійснює розрахунки з вебмайстрами.

Переваги:

Оскільки містить приватний авторизаційний ключ, postback забезпечує безпечну передачу даних. За необхідності можна перевірити логи, щоб з’ясувати джерело запиту.
Серверна (back-end) postback-інтеграція — це найбільш точний спосіб отримання й надсилання даних конверсій, захищений від будь-яких змін на стороні front-end.

Недоліки:

Для впровадження потрібен доступ до серверної частини сайту.

Детальніше про postback-інтеграцію.

XML-інтеграція

За XML-інтеграції всі дані про цільові дії користувачів експортуються в файл XML зі спеціальною структурою. Сервер Admitad із вказаною періодичністю звертатиметься до цього файлу й передаватиме нові дані для аналізу.

Переваги:

Можна обмежити доступ до файлу, захистивши його логіном і паролем.
Якщо налаштувати інтеграцію коректно, вебмайстри будуть отримувати інформацію про дії з мінімальною затримкою.
У разі технічних проблем ви зможете відновити втрачені дані про активність із аналітики Admitad.

Недоліки:

Дані можуть відображатися із затримкою у випадку довгої черги на обробку XML-файлу.

Детальніше про XML-інтеграцію.

API-інтеграція

Якщо ваш сайт працює з власним API, надішліть документацію по API спеціалісту Integration Services, щоб він міг розробити індивідуальний підхід до інтеграції вашого сайту.

Переваги:

Гнучке налаштування умов збору даних.
Мінімальні доопрацювання вашого API.
Можливість налаштування дедуплікації та cross-device трекінгу.

Недоліки:

Найбільш трудомісткий спосіб впровадження інтеграції, потребує команди розробників для реалізації та тестування коду.

Небажані методи

З 1 червня 2025 року Admitad переходить на новий стандарт інтеграції та застосовуватиме розрахунок Loss Adjustment для незареєстрованих замовлень, спричинених браузерними методами відстеження, як-от GTM, Tag Tag та іншими подібними типами інтеграції.
Наполегливо рекомендуємо переходити на нові стандарти інтеграції вже зараз, щоб забезпечити коректне відстеження й уникнути можливих розбіжностей у доходах. Наша команда готова допомогти із переходом. Детальніше читайте тут.

Початок роботи з інтеграцією

1. Перш ніж інтегруватися, переконайтеся, що ви додали щонайменше одну цільову дію та її винагороду до своєї програми. Інакше процес не спрацює.

Якщо у вас є персональний менеджер, він додасть дії та винагороди за вас.
Якщо менеджера у вас немає, вам потрібно додати дії та винагороди в Actions (Program → Traffic settings → Actions and rewards). Див. цю інструкцію по додаванню дій.

2. Далі відкрийте особистий кабінет, перейдіть у Integration (Program → Integration) та натисніть Next.

3. Виберіть метод інтеграції, який найкраще вам підходить:

Готова інтеграція через плагін, якщо ви обираєте інтеграцію CMS-сайту на базі WordPress або Shopify.
Кастомні інтеграції, якщо ви обираєте інтеграцію через postback, XML, tracking code чи Google Analytics API.

4. Виберіть ваш метод інтеграції та натисніть Next.

5. На сторінці Integration Settings є такі розділи:

Your program integration settings: тут можна перевірити вимоги до налаштування інтеграції вашої програми.
Deduplication settings: тут посилання на інструкцію по налаштуванню дедуплікації.
Integration testing: тут ви знайдете тестове посилання, за яким можна перевірити, чи інтеграція пройшла успішно і чи правильно налаштоване відстеження цільових дій для вашого сайту.

6. Перейдіть до інструкцій і дотримуйтесь усіх кроків для обраного вами методу інтеграції.

Інструкції для пріоритетних методів інтеграції:

Інструкції для небажаних методів інтеграції: