Singular est l’une des principales plateformes MMP (Mobile Measurement Partner) qui collecte et présente les données issues des campagnes marketing. Elle aide les entreprises à suivre les performances de leurs campagnes.

Adapty fournit un ensemble complet de données vous permettant de suivre les événements d’abonnement depuis les stores en un seul endroit. Avec Adapty, vous pouvez facilement observer le comportement de vos abonnés, comprendre leurs préférences et utiliser ces informations pour communiquer avec eux de manière ciblée et efficace. Cette intégration vous permet donc de suivre les événements d’abonnement dans Singular et d’analyser précisément les revenus générés par vos campagnes.

Adapty peut envoyer tous les événements d’abonnement configurés dans votre intégration à Singular. Vous pourrez ainsi suivre ces événements dans le tableau de bord Singular. Cette intégration est utile pour évaluer l’efficacité de vos campagnes publicitaires.

Configurer l’intégration

Connecter Adapty à Singular

Pour configurer l’intégration avec Singular, rendez-vous dans Integrations > Singular dans votre Adapty Dashboard, activez le bouton et remplissez les champs.

Les identifiants suivants sont disponibles :

• Singular SDK Key : Obligatoire. La clé SDK de production pour votre application Singular.
• Singular SDK Key (Sandbox) : Facultatif. La clé SDK pour votre application Singular en sandbox. Si elle n’est pas définie, les événements sandbox ne seront pas envoyés à Singular.

Les deux clés se trouvent dans le tableau de bord Singular sous Developer tools -> SDK Keys -> SDK Key (not SDK Secret) :

En dessous des identifiants, vous trouverez trois groupes d’événements que vous pouvez envoyer à Singular depuis Adapty. 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.

Adapty enverra les événements d’abonnement à Singular via une intégration serveur à serveur, ce qui vous permettra de consulter tous les événements d’abonnement dans votre tableau de bord Singular et de les associer à vos campagnes d’acquisition.

Connecter votre application à Singular

L’intégration entre Adapty et Singular est de type serveur à serveur. Il n’est donc pas nécessaire d’ajouter de code supplémentaire à votre application.

Structure des événements

Adapty envoie des événements à Singular via une requête GET avec des paramètres de requête. Chaque événement est structuré comme suit :

{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}

Where:

Paramètre	Type	Description
n	String	Le nom de l’événement (mappé depuis l’événement Adapty).
a	String	Votre clé SDK Singular.
p	String	Plateforme (“iOS” ou “Android”).
i	String	ID de l’application dans le store (Bundle ID).
ip	String	Adresse IP de l’utilisateur.
idfa	String	iOS uniquement. ID for Advertisers (en majuscules).
idfv	String	iOS uniquement. ID for Vendors (en majuscules).
aifa	String	Android uniquement. Google Advertising ID (en minuscules).
andi	String	Android uniquement. Android ID (en minuscules).
asid	String	Android uniquement. App Set ID (en minuscules).
ve	String	Version du système d’exploitation.
att_authorization_status	Integer	iOS uniquement. Statut ATT (ex. : 3 pour autorisé).
custom_user_id	String	Le Customer User ID de l’utilisateur.
utime	Long	Horodatage UNIX de l’événement en secondes.
amt	Float	Montant des revenus.
cur	String	Code de la devise (ex. : “USD”).
purchase_product_id	String	L’ID du produit dans le store.
purchase_transaction_id	String	ID de transaction d’origine.
e	String	Chaîne JSON contenant les détails de l’événement (voir ci-dessous).

Le paramètre e (données d’événement personnalisées) est une chaîne encodée en JSON contenant :

Paramètre	Type	Description
is_revenue_event	Boolean	true si l’événement contient un revenu.
amt	Float	Montant du revenu.
cur	String	Code de devise.
purchase_product_id	String	L’identifiant du produit dans le store.
purchase_transaction_id	String	Identifiant de transaction d’origine.

Dépannage

access_level_updated s’affiche comme échoué dans le flux 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.