# 🌐 Интеграция рекламной платформы

Ниже описаны шаги для внедрения рекламной платформы на вашем сайте или приложении. Некоторые этапы требуют принятия решений, например, выбор способа передачи событий и запуска кампаний: через **JS-скрипт**, **API** или **SDK**. Наша команда поддержки поможет подобрать оптимальное решение в зависимости от ваших бизнес-потребностей.

!!!
Если вы уже интегрировали платформу персонализации, то для запуска Retail Media вам не требуется дополнительная интеграция. Чтобы получить доступ к возможностям модуля, обратитесь к вашему менеджеру. 
!!!

---

## 🚀 Шаги интеграции

### 1. Синхронизация товарного каталога

Каталог товаров необходим для:

- Показа рекламных кампаний с товарами

📖 **Подробнее о синхронизации каталога:**  
[Требования к фидам](/Integration/products_catalogues/general_reqs.md)

### 2. Установка кода на всех этапах пути пользователя

Для отслеживания взаимодействий пользователей и запуска кампаний необходимо установить **JS-скрипт**, реализовать серверную интеграцию через **API** или подключить **SDK** в мобильное приложение.

📖 Подробнее:  
- [JS-скрипт](/Integration/web_integration/web_integration.md)  
- [API](/Integration/api_integration/api_integration.md)
- [iOS SDK](/Integration/SDK/sdk_ios.md)
- [Android SDK](/Integration/SDK/sdk_android.md)
- [Flutter SDK](/Integration/SDK/ask_flutter.md)

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

Отслеживайте ключевые действия пользователей: 

- Покупки.  
- Добавление товаров в корзину.  
- Регистрации.  
- Входы в систему и прочие значимые взаимодействия.  

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

📖 Подробнее:  
- [JS-скрипт](/Integration/web_integration/web_integration.md)  
- [API](/Integration/api_integration/api_integration.md)
- [iOS SDK](/Integration/SDK/sdk_ios.md)
- [Android SDK](/Integration/SDK/sdk_android.md)
- [Flutter SDK](/Integration/SDK/ask_flutter.md)

### 4. Установка first-party cookies (только для сайтов)

Для корректного отслеживания пользователей **JS-скрипт** платформы использует файлы cookie и local storage. Убедитесь, что cookie устанавливается сервером вашего домена. Это предотвратит блокировку отслеживания из-за политики браузеров.

📖 Подробнее:  
[Проброска cookie](/Integration/web_integration/cookie.md)

---

## 💡 Варианты интеграции

Платформа поддерживает четыре варианта интеграции, каждый из которых подходит для определённых задач и бизнес-потребностей.

### 🌐 Web-интеграция

**Описание:** Установка JS-скрипта на сайт.  

**Преимущества:**  
- Быстрый старт.  
- Возможность создавать кампании через интерфейс без привлечения разработчиков.

**Недостатки:**  
- Ограничение только на web-платформы.

📖 Подробнее: [Web-интеграция](/Integration/web_integration/web_integration.md)

### 🔄 API-интеграция

**Описание:** Взаимодействие с платформой через серверные запросы.

**Преимущества:**  
- Минимальное влияние на производительность.  
- Кампании работают на web, мобильных приложениях, кассовых терминалах, киосках и других устройствах.  
- Прозрачное управление данными.  
- Возможность обходиться без cookies.

**Недостатки:**  
- Требуется участие разработчиков для запуска новых кампаний.

📖 Подробнее: [API-интеграция](/Integration/api_integration/api_integration.md)

### 📱 SDK-интеграция

**Описание:** Интеграция через мобильный SDK для iOS, Android и Flutter-приложений.

**Преимущества:**  
- Нативная интеграция в мобильное приложение.  
- Поддержка запуска кампаний и передачи событий.
- Готовые SDK-гайды для основных мобильных платформ.

**Недостатки:**  
- Требуется участие мобильных разработчиков.  

📖 Подробнее:  
- [iOS SDK](/Integration/SDK/sdk_ios.md)
- [Android SDK](/Integration/SDK/sdk_android.md)
- [Flutter SDK](/Integration/SDK/ask_flutter.md)

### ⚡ Hybrid-интеграция

**Описание:** Гибридный подход сочетает возможности Web и API интеграций для достижения максимальной производительности и гибкости.

- **Основные кампании** рендерятся через API на сервере, включая персонализированный контент в HTML-разметку. Это исключает мигание и задержки.  
- **Web-кампании** используются для быстрого тестирования гипотез.

📖 Подробнее: [Hybrid-интеграция](/Integration/hybrid_integration/hybrid_integrations.md)

=== 📝 Пример выбора подхода
**Ситуация:**  
Вы хотите быстро запустить кампанию с минимальными затратами на разработку.  
**Решение:** Используйте **Web-интеграцию**.  

**Ситуация:**  
Необходимо интегрировать кампании в мобильное приложение.  
**Решение:** Используйте **SDK-интеграцию** или **API-интеграцию** в зависимости от архитектуры приложения.
===