# Интеграция с mParticle

<Aside type="caution" icon="setting" title="Требуется помощь разработчика">
 Для настройки интеграции вам потребуется помощь команды разработчиков. Пожалуйста, поделитесь с ними этим руководством.
</Aside>

## Обзор интеграции

[mParticle](https://www.mparticle.com/) — это платформа для управления данными о клиентах, собранными из мобильных приложений, веба и других источников.

Если вы используете mParticle для хранения данных о клиентах, вы можете легко настроить интеграцию с Pushwoosh. Это позволит вам создавать целевые, персонализированные и эффективные кампании в Pushwoosh, используя данные из mParticle.

Вы можете отправлять следующие данные из mParticle в Pushwoosh:

*   **Атрибуты пользователя**: имя, местоположение, устройство, предпочтения, поведение и т.д. Эти данные будут сохранены в Pushwoosh как [Теги](/ru/product/audience-data-and-segmentation/user-data-tags/tags/) и их значения для каждого пользователя. Тип данных для каждого Тега определяется автоматически.
*   **События**: каждое Событие, настроенное в mParticle, будет передано в Pushwoosh и сохранено как [Событие](/ru/product/audience-data-and-segmentation/events/default-events/) с тем же именем и тегами, если они есть. Pushwoosh также получит информацию о том, какие События вызвал каждый пользователь.
*   **Сегменты**: все Аудитории mParticle, основанные на атрибутах пользователей и вызванных Событиях, могут быть переданы в Pushwoosh как Сегменты. Вы можете использовать их для создания высокотаргетированных кампаний. Если сегмент Аудитории обновляется в mParticle, этот сегмент также будет обновлен в Pushwoosh. Частота обновления сегментов mParticle настраивается на стороне mParticle.

<Aside type="note">
Обратите внимание, что Теги и События в mParticle не должны называться так же, как стандартные Теги и События в Pushwoosh. Если имена совпадают, данные могут не передаваться.
</Aside>

Данные не передаются обратно из Pushwoosh в mParticle, но мы планируем добавить эту возможность в будущем, так что следите за обновлениями.

## Настройка интеграции

<Aside type="note">
Для настройки интеграции mParticle и Pushwoosh вам не нужно интегрировать Pushwoosh SDK в ваше приложение. Это требуется только в том случае, если вы создаете кампании, включающие in-app сообщения.
</Aside>

1.  [В интерфейсе mParticle](https://app.mparticle.com/login) перейдите в раздел **Directory** и найдите в списке **Pushwoosh**. Наведите курсор на иконку и нажмите **Setup**.

<img src="/integrations-mparticle-integration-1.webp" alt="Поиск Pushwoosh в Directory mParticle"/>

2.  Выберите оба варианта вывода — **Event** и **Audience** — и нажмите **Configure**:

<img src="/integrations-mparticle-integration-2.webp" alt="Выбор вывода Event и Audience в mParticle" width="375"/>

3.  На открывшейся странице (**Setup** → **Outputs**) нажмите на значок плюса в строке **Pushwoosh Default Group**:

<img src="/integrations-mparticle-integration-3.webp" alt="Pushwoosh Default Group в Outputs mParticle"/>

Введите любое имя конфигурации (например, _Pushwoosh integration_), код приложения Pushwoosh и API-ключ. Нажмите **Save**.

<details>

<summary>Где найти код приложения и API-ключ?</summary>

Код приложения можно найти в левом верхнем углу интерфейса Pushwoosh, прямо под названием проекта:

<img src="/integrations-mparticle-integration-4.webp" alt="Поиск кода приложения в интерфейсе Pushwoosh" data-size="original"/>

Чтобы найти API-ключ, перейдите в **Settings** → **API Access**:

<img src="/integrations-mparticle-integration-5.webp" alt="Раздел API Access в настройках Pushwoosh" data-size="original"/>

</details>

<img src="/integrations-mparticle-integration-6.webp" alt="Настройки конфигурации для интеграции с Pushwoosh" width="375"/>

Теперь переключитесь на вкладку **Audience** и повторите эти шаги для строки **Pushwoosh Default**:

<img src="/integrations-mparticle-integration-7.webp" alt="Настройка вкладки Audience в mParticle"/>

4.  Перейдите в **Connections** → **Connect** и нажмите на Input, который вы хотите интегрировать с Pushwoosh.

<img src="/integrations-mparticle-integration-8.webp" alt="Раздел Connections в интерфейсе mParticle"/>

Нажмите **Connect Output**, выберите **Pushwoosh** и активируйте соединение.

<img src="/integrations-mparticle-integration-9.webp" alt="Подключение вывода Pushwoosh в mParticle"/>

Повторите эти шаги для каждого Input, который вы хотите интегрировать с Pushwoosh.

Если все настроено правильно, Pushwoosh начнет получать данные из mParticle, и вы сможете создавать [Customer Journeys](/ru/product/customer-journey/pushwoosh-journey-overview) и отправлять [push-уведомления](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/), используя данные о клиентах из mParticle.