# Integração com mParticle

<Aside type="caution" icon="setting" title="Assistência de desenvolvedor necessária">
 Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.
</Aside>

## Visão geral da integração

[mParticle](https://www.mparticle.com/) é uma plataforma para gerenciar dados de clientes coletados de aplicativos móveis, web e outras fontes.

Se você usa o mParticle para armazenar dados de clientes, pode configurar facilmente a integração com o Pushwoosh. Isso permitirá que você crie campanhas direcionadas, personalizadas e eficazes no Pushwoosh usando dados do mParticle.

Você pode enviar os seguintes dados do mParticle para o Pushwoosh:

*   **Atributos do usuário**: nome, localização, dispositivo, preferências, comportamento, etc. Esses dados serão salvos no Pushwoosh como [Tags](/pt/product/audience-data-and-segmentation/user-data-tags/tags/) e seus valores para cada usuário. O tipo de dado para cada Tag é identificado automaticamente.
*   **Eventos**: cada Evento configurado no mParticle será transferido para o Pushwoosh e salvo como o [Evento](/pt/product/audience-data-and-segmentation/events/default-events/) com o mesmo nome e tags, se houver. O Pushwoosh também receberá informações sobre quais Eventos cada usuário acionou.
*   **Segmentos**: todos os Públicos (Audiences) do mParticle baseados em atributos de usuário e Eventos acionados podem ser transferidos para o Pushwoosh como Segmentos. Você pode usá-los para criar campanhas altamente direcionadas. Se um segmento de Público (Audience) for atualizado no mParticle, esse segmento também será atualizado no Pushwoosh. A frequência de atualização dos segmentos do mParticle é configurada no lado do mParticle.

<Aside type="note">
Observe que as Tags e os Eventos no mParticle não devem ter o mesmo nome das Tags e Eventos padrão no Pushwoosh. Se os nomes coincidirem, os dados podem não ser transmitidos.
</Aside>

Os dados não são transferidos de volta do Pushwoosh para o mParticle, mas planejamos adicionar essa opção no futuro, então fique atento.

## Configurando a integração

<Aside type="note">
Para configurar a integração do mParticle e do Pushwoosh, você não precisa integrar o SDK do Pushwoosh em seu aplicativo. Isso só é necessário se você criar campanhas que incluam mensagens in-app.
</Aside>

1.  [Na interface do mParticle](https://app.mparticle.com/login), vá para a seção **Directory** e encontre o **Pushwoosh** na lista. Passe o mouse sobre o ícone e clique em **Setup**.

<img src="/integrations-mparticle-integration-1.webp" alt="Encontrando o Pushwoosh no Diretório do mParticle"/>

2.  Selecione as saídas (Outputs) de **Event** e **Audience** e clique em **Configure**:

<img src="/integrations-mparticle-integration-2.webp" alt="Selecionando saídas de Evento e Público (Audience) no mParticle" width="375"/>

3.  Na página que se abre (**Setup** → **Outputs**), clique no ícone de mais na linha **Pushwoosh Default Group**:

<img src="/integrations-mparticle-integration-3.webp" alt="Grupo Padrão do Pushwoosh nas saídas do mParticle"/>

Insira qualquer nome de configuração (por exemplo, _Integração Pushwoosh_), o código do aplicativo Pushwoosh e a chave de API. Clique em **Save**.

<details>

<summary>Onde posso encontrar o código do aplicativo e a chave de API?</summary>

Você pode encontrar o código do aplicativo no canto superior esquerdo da interface do Pushwoosh, logo abaixo do nome do projeto:

<img src="/integrations-mparticle-integration-4.webp" alt="Encontrando o código do aplicativo na interface do Pushwoosh" data-size="original"/>

Para encontrar a chave de API, vá para **Configurações** → **Acesso à API**:

<img src="/integrations-mparticle-integration-5.webp" alt="Seção de Acesso à API nas configurações do Pushwoosh" data-size="original"/>

</details>

<img src="/integrations-mparticle-integration-6.webp" alt="Configurações para a integração com o Pushwoosh" width="375"/>

Agora mude para a aba **Audience** e repita esses passos para a linha **Pushwoosh Default**:

<img src="/integrations-mparticle-integration-7.webp" alt="Configuração da aba Audience no mParticle"/>

4.  Vá para **Connections** → **Connect** e clique na Entrada (Input) que você deseja integrar com o Pushwoosh.

<img src="/integrations-mparticle-integration-8.webp" alt="Seção de Conexões na interface do mParticle"/>

Clique em **Connect Output**, selecione **Pushwoosh** e ative a conexão.

<img src="/integrations-mparticle-integration-9.webp" alt="Conectando a saída do Pushwoosh no mParticle"/>

Repita esses passos para cada Entrada (Input) que você deseja integrar com o Pushwoosh.

Se tudo estiver configurado corretamente, o Pushwoosh começará a receber dados do mParticle, e você poderá criar [jornadas do cliente](/pt/product/customer-journey/pushwoosh-journey-overview) e enviar [notificações push](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) usando os dados do cliente do mParticle.