---
title: "Asapty"
description: "Découvrez Asapty et son rôle dans l'écosystème d'abonnements d'Adapty."
---
Grâce à l'intégration [Asapty](https://asapty.com/), vous pouvez optimiser vos campagnes Search Ads. Adapty envoie les événements d'abonnement à Asapty, ce qui vous permet d'y créer des tableaux de bord personnalisés basés sur l'attribution Apple Search Ads.
Cette intégration spécifique n'ajoute aucune donnée d'attribution à Adapty, car nous disposons déjà de tout ce dont nous avons besoin directement depuis [ASA](apple-search-ads).
## Configurer l'intégration \{#set-up-integration\}
### Connecter Adapty à Asapty \{#connect-adapty-to-asapty\}
Pour intégrer Asapty, accédez à [Integrations > Asapty](https://app.adapty.io/integrations/asapty) dans le tableau de bord Adapty et renseignez la valeur du champ Asapty ID.
L'Asapty ID se trouve dans la section Settings > General de votre compte Asapty.
### Configurer les événements et les tags \{#configure-events-and-tags\}
Sous les identifiants, vous trouverez trois groupes d'événements que vous pouvez envoyer à Asapty depuis Adapty. Activez simplement ceux dont vous avez besoin. Consultez la liste complète des événements proposés par Adapty [ici](events).
Nous recommandons d'utiliser les noms d'événements par défaut fournis par Adapty. Vous pouvez toutefois les modifier selon vos besoins.
### Connectez votre application à Asapty \{#connect-your-app-to-asapty\}
Une fois les étapes ci-dessus effectuées, Adapty reçoit automatiquement les données d'attribution d'Asapty. Inutile de demander explicitement ces données dans le code de votre application. Pour une meilleure précision des données d'attribution, configurez Asapty pour partager le `customerUserId` avec les données de chaque événement.
## Structure des événements Asapty \{#asapty-event-structure\}
Adapty envoie les événements à Asapty via une requête GET en utilisant des paramètres de requête. Chaque URL d'événement ressemble à ceci :
```
https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7D
```
Paramètres de requête :
| Paramètre | Type | Description |
|:-----------------|:-------|:-----------------------------------------------------|
| `source` | String | Toujours "adapty". |
| `asaptyid` | String | L'identifiant Asapty de vos identifiants. |
| `keywordid` | String | Identifiant de mot-clé Apple Search Ads (si disponible). |
| `adgroupid` | String | Identifiant de groupe d'annonces Apple Search Ads (si disponible). |
| `campaignid` | String | Identifiant de campagne Apple Search Ads (si disponible). |
| `conversiondate` | Long | Horodatage de l'événement en **millisecondes**. |
| `event_name` | String | Le nom de l'événement (mappé depuis l'événement Adapty). |
| `install_time` | Long | Horodatage de l'installation en secondes. |
| `app_name` | String | Le titre de l'application depuis Adapty (si disponible). |
| `json` | String | Chaîne JSON encodée en URL contenant les détails de l'événement (voir ci-dessous). |
Le paramètre `json` est une chaîne JSON encodée en URL contenant les champs suivants :
| Paramètre | Type | Description |
|:--------------------------|:-------|:-------------------------------------------------------------|
| `af_revenue` | String | Montant du revenu sous forme de chaîne. |
| `af_currency` | String | Code de devise (ex. : « USD »). |
| `transaction_id` | String | ID de transaction du store. |
| `original_transaction_id` | String | ID de transaction d'origine du store. |
| `purchase_date` | Long | Horodatage de l'achat en millisecondes. |
| `original_purchase_date` | Long | Horodatage de l'achat d'origine en millisecondes. |
| `environment` | String | `Production` ou `Sandbox`. |
| `vendor_product_id` | String | L'ID du produit dans le store. |
| `profile_country` | String | Code pays basé sur l'adresse IP de l'utilisateur. |
| `store_country` | String | Code pays du store de l'utilisateur. |
## Dépannage \{#troubleshooting\}
### Les événements n'arrivent pas à Adapty \{#events-dont-reach-asapty\}
- Assurez-vous d'avoir configuré [Apple Search Ads](apple-search-ads) dans Adapty et d'avoir [importé vos identifiants](https://app.adapty.io/settings/apple-search-ads) — sans eux, Asapty ne fonctionnera pas.
- Seuls les profils disposant d'une attribution ASA détaillée et non organique transmettront leurs événements à Asapty. Le message "The user profile is missing the required integration data." s'affiche si l'attribution est insuffisante.
- Les profils créés avant la configuration des intégrations ne pourront pas transmettre leurs événements à Asapty.
- Si l'intégration avec Adapty ne fonctionne pas malgré une configuration correcte, vérifiez que le bouton **Receive Apple Search Ads attribution in Adapty** est activé dans l'onglet [**App Settings** -> **Apple Search Ads**](https://app.adapty.io/settings/apple-search-ads).
### `access_level_updated` s'affiche comme échoué dans le fil d'événements \{#access_level_updated-shows-as-failed-in-the-event-feed\}
`access_level_updated` est un **événement réservé aux webhooks**. Adapty ne l'envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.