# Intégration de Solitics

<Aside type="caution" icon="setting" title="Assistance d'un développeur requise">
 Vous aurez besoin de l'aide de votre équipe de développement pour configurer l'intégration. Veuillez partager ce guide avec eux.
</Aside>

[Solitics](https://solitics.com/) est une plateforme avancée de gestion de données et d'automatisation du marketing en temps réel qui permet aux marques B2C d'offrir des expériences hautement personnalisées à leurs clients. En exploitant les données des clients, les entreprises peuvent augmenter leurs revenus grâce à des taux de conversion et de rétention améliorés, tout en réduisant considérablement les dépenses de développement et d'informatique.

Combinées à Pushwoosh, les capacités de gestion de données de Solitics permettent aux marques de diffuser des messages très ciblés et pertinents à leurs utilisateurs. Cela garantit que les utilisateurs reçoivent du contenu et des offres spécifiquement adaptés à leurs intérêts et à leurs besoins, améliorant ainsi leur expérience globale.

Les marques peuvent également utiliser Solitics pour analyser les données des utilisateurs et identifier les domaines à améliorer dans le parcours utilisateur. En intégrant ces données à Pushwoosh, les marques peuvent envoyer des notifications push pour réengager les utilisateurs qui ont peut-être abandonné leur parcours, les redirigeant vers l'application ou le site web et améliorant ainsi les taux de conversion.

## Cas d'utilisation

Voici quelques cas d'utilisation pratiques qui démontrent comment l'intégration de Solitics et Pushwoosh peut être utilisée pour améliorer l'expérience client et générer des résultats commerciaux :

### Promotions et offres personnalisées

Les entreprises peuvent utiliser les données de Solitics pour analyser les préférences et les comportements des clients. Ensuite, elles peuvent envoyer des notifications push personnalisées via Pushwoosh avec des promotions et des offres sur mesure basées sur les intérêts de chaque individu.

### Stimuler l'engagement

Les entreprises de jeux peuvent configurer Solitics pour surveiller les actions et les réussites des joueurs, puis utiliser Pushwoosh pour envoyer rapidement des notifications push aux joueurs pour les étapes importantes et les événements spéciaux, encourageant ainsi un engagement actif et une participation à des activités spécifiques dans le jeu.

### Alertes de sécurité

Les applications bancaires peuvent garantir la sécurité des données de leurs clients grâce à l'intégration Solitics + Pushwoosh. Elles peuvent configurer Solitics pour surveiller l'activité des comptes et déclencher des alertes en cas de comportement inhabituel. Ensuite, elles peuvent utiliser Pushwoosh pour envoyer des notifications push en temps réel afin d'avertir les clients concernés, les encourageant à agir rapidement pour protéger leurs comptes et prévenir d'éventuels problèmes.

## Configuration de l'intégration

Le processus d'intégration comprend deux étapes principales :

1. Intégrer le SDK Pushwoosh dans votre site web ou votre application mobile.
2. Établir un ID utilisateur qui sert d'identifiant unique pour Solitics et Pushwoosh.

### Prérequis

1. Compte Pushwoosh
2. [Jeton d'accès à l'API Pushwoosh](/fr/developer/api-reference/api-access-token) : Pour permettre la transmission de données à Pushwoosh, vous devez générer un jeton d'accès à l'API Pushwoosh. Pour l'obtenir, allez dans **Paramètres > Accès API** et copiez-le.
3. Code d'application Pushwoosh : De même, vous devrez localiser votre code d'application Pushwoosh pour faciliter le transfert de données vers Pushwoosh. Pour ce faire, trouvez le nom du projet dans le coin supérieur gauche et copiez le code affiché en dessous.
4. [Compte Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
Pour activer l'intégration, enregistrez chaque utilisateur dans Solitics et Pushwoosh en utilisant le même ID de membre. C'est la condition principale pour que l'intégration fonctionne efficacement.
</Aside>

### Configuration de Pushwoosh pour l'intégration

1. Créez un compte Pushwoosh si vous n'en avez pas.
2. Configurez vos projets. [Apprenez-en plus sur la façon de le faire.](/fr/product/first-steps/start-with-your-project/configure-platforms)
3. Ensuite, créez une application dans Pushwoosh et sélectionnez les canaux de communication préférés. Vous pouvez choisir d'utiliser une application existante si vous en avez déjà une.

### Configuration de Solitics pour l'intégration

1. Contactez Solitics ([support@solitics.com](mailto:support@solitics.com)) et demandez d'intégrer votre marque avec Pushwoosh.

Spécifiez les détails suivants :

* Clé API Pushwoosh
* Code d'application Pushwoosh

2. L'équipe de Solitics vous fournira un jeton d'accès pour les futures interactions avec l'API de Solitics.

## Enregistrement de l'utilisateur

Comme souligné précédemment, il est important d'enregistrer les utilisateurs avec des ID utilisateur identiques dans Solitics et Pushwoosh.

<Aside type="note">
Utilisez le même ID de membre unique que votre marque utilise pour l'intégration des membres lors de l'enregistrement pour les notifications push. Cette cohérence garantira non seulement que votre ID de membre est unique, mais rationalisera également le suivi et facilitera le débogage en cas de problème.
</Aside>

### Enregistrement avec Pushwoosh

Pushwoosh propose deux méthodes pour associer un ID utilisateur à un appareil spécifique. Si vous n'utilisez pas ces méthodes, Pushwoosh utilisera automatiquement l'ID matériel de l'appareil comme identifiant de l'utilisateur.

Pour lier un ID utilisateur à un appareil dans Pushwoosh, vous pouvez choisir l'une des méthodes suivantes :

#### `setUserId`

Il s'agit d'une fonction du SDK qui vous permet de définir une valeur de chaîne comme un ID Pushwoosh, qui sera automatiquement mis en correspondance avec un ID matériel (HWID) utilisé par Pushwoosh pour identifier les appareils.

**Android**

<LinkCard title="setUserId – Android" href="https://github.com/Pushwoosh/pushwoosh-android-sdk/blob/master/Documentation/inapp/PushwooshInApp.md#1a69cdb1592ad7640a49ba8bac8a14d54d" />

**iOS**
<LinkCard title="setUserId – iOS" href="https://github.com/Pushwoosh/pushwoosh-ios-sdk/blob/master/Documentation/PushNotificationManager.md#1ad51b323a64cbedb408442f9b52cc39fd" />


#### Méthode API `registerUser`

Cette méthode vous permet d'attribuer à distance un ID utilisateur à un HWID spécifique depuis votre backend.

Des informations détaillées sur l'utilisation de cet appel API peuvent être trouvées [ici](/fr/developer/api-reference/user-centric-api#registeruser).

### S'inscrire avec Solitics

Lorsqu'un utilisateur est enregistré pour les messages push, Solitics doit également en être informé. Pour cela, effectuez la requête HTTP suivante :

**Méthode HTTP :** POST

**Point de terminaison :** `https://api.solitics.com/rest/subscribers/register/app`

**Corps de la requête**

```json
{
 "memberId": "1234567",
 "email": "abcd@solitics.com",
 "token": "GH2TKoXXXXXXXEj1111",
 "key": "1234567”
}
```

**Paramètres du corps**

| Paramètre  | Description                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------- |
| memberID   | Ceci représente l'identifiant unique de l'utilisateur dans Solitics (tel que l'ID CRM)                |
| email      | L'e-mail du membre qui est utilisé pour l'authentification à deux facteurs                                     |
| token      | Le jeton fourni par Solitics pour accéder à l'API push.                                     |
| key        | La clé d'enregistrement push du membre doit correspondre à l'ID utilisateur utilisé pour l'enregistrement avec Pushwoosh. |

Bien que Solitics recommande d'utiliser l'ID de membre comme clé, des exceptions peuvent s'appliquer. Par exemple, si plusieurs applications sont utilisées dans Pushwoosh, une clé différente doit être attribuée à l'utilisateur pour chaque application.

## Test de l'intégration

Une fois que vous avez terminé le processus de configuration, il est crucial d'effectuer un test pour vous assurer que l'intégration fonctionne comme prévu. Suivez ces étapes pour les tests :

1. Créez une promotion Push dans Solitics et enregistrez.

2. Connectez-vous à votre application ou site. Accédez à l'application ou au site web où vous vous attendez à ce que le message push apparaisse. Assurez-vous de vous connecter au compte utilisateur qui a été préalablement enregistré pour les notifications push à la fois dans Solitics et Pushwoosh.

Si vous n'êtes pas sûr du statut d'enregistrement, n'hésitez pas à contacter Solitics à [support@solitics.com](mailto:support@solitics.com) pour confirmation, en incluant les détails sur le statut d'enregistrement de l'utilisateur et l'ID utilisateur associé.

3. Lancez le test. Dans la promotion Solitics, cliquez sur le bouton Test. Entrez l'e-mail, le numéro de téléphone ou l'ID de membre de l'abonné (le destinataire prévu du message push). Cliquez sur Envoyer.

Si toutes les configurations sont correctes, le message push devrait apparaître.