Grâce à l’intégration Asapty, 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.

Configurer l’intégration

Connecter Adapty à Asapty

Pour intégrer Asapty, accédez à 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

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.

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

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

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

Les événements n’arrivent pas à Adapty

• Assurez-vous d’avoir configuré Apple Search Ads dans Adapty et d’avoir importé vos identifiants — 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.

access_level_updated s’affiche comme échoué dans le fil d’événements

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.