Основна мета
Створити систему вирішення ідентичності від початку до кінця, яка створює детерміновані відповідності між номером телефону ↔ ADID (ідентифікатор мобільного пристрою) за допомогою протоколу IAB UID2 та відповідності на основі рекламних кампаній.
Огляд проекту
Це складна платформа вирішення ідентичності з наступним робочим процесом:
Номери телефонів → UID2 токени → Рекламні кампанії → Відстеження показів → Захоплення ADID → Двосторонні відповідності
Ключові компоненти системи:
1. Служба завантаження телефонів
Приймає файли CSV/JSON/Excel з номерами телефонів
Нормалізує до формату E.164
Шифрує та хешує для безпеки
Відстежує партії завантаження з даними валідації
2. Служба конвертації UID2
Конвертує номери телефонів у рекламні токени UID2 через протокол IAB UID2
Керує циклами оновлення токенів (термін дії 90 днів)
Зберігає відповідності в PostgreSQL
Асинхронна обробка через чергу Kafka
3. Менеджер рекламних кампаній (інтеграція Prebid)
Створює недорогі кампанії відстеження, націлені на токени UID2
Стратегія: покази 1x1 піксель для економії витрат
Конфігуровані бюджети, географія та обмеження частоти
Відстежує покази та ефективність кампаній
4. Система відстеження показів
Захоплює ADID з подій показів
Витягує дані пристроїв з запитів на ставки OpenRTB
Підтримує як GET (піксель), так і POST (S2S постбек) відстеження
Логує дані про користувача та геодані
5. Служба відповідностей
Створює та оновлює відносини телефон ↔ ADID
Оцінка впевненості на основі частоти показів
Обробляє кілька ADID для одного телефону (користувачі з кількома пристроями)
Оновлює статус обробки телефону
6. API для пошуку (двосторонні)
Телефон → ADID: Знайти всі ADID, пов'язані з номером телефону
ADID → Телефон: Знайти номер телефону, пов'язаний з ADID
Кешування Redis для пошуків <10ms
Оцінки впевненості та кількість показів
7. Веб-дашборд (Streamlit)
Статистика та метрики системи в реальному часі
Інтерфейс завантаження телефонів
Створення та моніторинг кампаній
Інтерактивний інструмент для пошуку
Аналітика та графіки ефективності
Резюме кінцевих точок API
/api/upload - Завантажити файл з номерами телефонів
/api/create-campaign/{batch_id} - Створити рекламну кампанію з партії
/lookup/phone-to-adid - Знайти ADID за телефоном
/lookup/adid-to-phone - Знайти телефон за ADID
/stats/overview - Статистика системи
/campaigns - Список кампаній
/track - Піксель відстеження показів
Результати
Це повна, готова до виробництва реалізація з:
✅ Повна схема бази даних з індексами та розподілом
✅ Усі мікросервіси реалізовані (завантаження, UID2, кампанії, відстеження)
✅ Двосторонні API для пошуку з кешуванням
✅ Контейнеризація Docker та оркестрація docker-compose
✅ Веб-дашборд з аналітикою в реальному часі
✅ Комплексне оброблення помилок та логування
✅ Тестові кінцеві точки та фреймворк для інтеграційного тестування
Система готова до розгортання з належними обліковими даними API UID2 та виділенням бюджету для кампанії.