Intégration de l'attribution

Adapty peut échanger des informations avec des services tiers pour attribuer les événements d’abonnement à des campagnes marketing spécifiques. Cet échange vous permet de :

Découvrir quelles stratégies marketing génèrent le plus de revenus
Filtrer les graphiques d’abonnement Adapty par attribution
Utiliser les fonctionnalités d’un service tiers pour analyser les données d’abonnement Adapty

Vous pouvez le configurer de deux façons :

L’attribution intégrée nécessite une configuration minimale et permet à Adapty d’échanger des données avec 9 plateformes populaires.
L’attribution manuelle vous oblige à récupérer vous-même les données d’attribution depuis les API de services tiers avant de les envoyer à Adapty.

Tip

Activez Adapty Attribution pour avoir une vue complète de l’économie de votre application.

Adapty Attribution est un tableau de bord web facile à configurer qui consolide les données de différentes sources pour identifier les stratégies d’acquisition d’utilisateurs les plus efficaces.

Warning

Gardez vos données propres : évitez la duplication d’événements et les conflits d’attribution. Suivez les conseils de la section Prévenir les problèmes de données pour vous assurer qu’une nouvelle source de données ne pollue pas vos analytics.

Attribution intégrée

Adapty propose une intégration d’attribution clé en main avec 9 services populaires. Ces plateformes peuvent recevoir automatiquement les données d’abonnement depuis Adapty, traiter chaque achat et renvoyer une attribution appropriée.

Chaque plateforme a son propre fonctionnement, mais les étapes restent simples :

Configurez le partage automatique des données. Autorisez Adapty à communiquer avec la plateforme de votre choix.
Intégrez le SDK Adapty. Certaines plateformes nécessitent du code supplémentaire pour transmettre les données d’attribution.
Désactivez les autres services de partage d’événements et sources d’attribution pour éviter la duplication d’événements et les conflits de données.

Consultez le guide spécifique à votre plateforme pour une présentation détaillée de l’intégration :

Adjust, AppsFlyer, Branch et Singular peuvent également recevoir des événements synthétiques — un signal indiquant qu’un essai ou un abonnement a survécu ses premiers jours. Pour les campagnes Meta et TikTok, Adapty Attribution propose des essais qualifiés à la place.

Note

Si vous souhaitez qu’Adapty élargisse la liste, créez une demande de fonctionnalité et exprimez votre intérêt pour un service particulier.

Attribution manuelle

Si Adapty ne propose pas d’attribution intégrée avec votre service, vous devez écrire votre propre code pour échanger des données avec la source d’attribution.

Récupérez les données depuis le service d’attribution. Utilisez l’API du service pour demander les données d’attribution.
Créez un dictionnaire avec les données d’attribution reçues.

Le dictionnaire peut contenir les clés suivantes :
- status (organic, non-organic, ou unknown)
- channel
- campaign
- ad_group
- ad_set
- creative

Important

Toutes les clés sont optionnelles.
Adapty ignore les clés qui ne figurent pas dans la liste.
La valeur de chaque clé peut comporter jusqu’à 50 caractères.

Exemple :

let attribution = [
    "status": "non_organic",
    "channel": "Google Ads",
    "campaign": "Christmas Sale",
    "ad_group": "ad group 1",
    "ad_set": "ad set 1",
    "creative": "creative id 1"
]

   </TabItem>
   <TabItem value="kotlin" label="Android (Kotlin)">

   ```kotlin showLineNumbers
   val attribution = mapOf(
       "status" to "non_organic",
       "channel" to "Google Ads",
       "campaign" to "Christmas Sale",
       "ad_group" to "ad group 1",
       "ad_set" to "ad set 1",
       "creative" to "creative id 1"
   )

    const attribution = {
      status: 'non_organic',
      channel: 'Google Ads',
      campaign: 'Christmas Sale',
      ad_group: 'ad group 1',
      ad_set: 'ad set 1',
      creative: 'creative id 1',
    };

    final attribution = <String, String>{
      'status': 'non_organic',
      'channel': 'Google Ads',
      'campaign': 'Christmas Sale',
      'ad_group': 'ad group 1',
      'ad_set': 'ad set 1',
      'creative': 'creative id 1',
    };

Unity prend les données d’attribution sous forme de chaîne JSON sérialisée, donc construisez le dictionnaire et sérialisez-le :

    using System.Collections.Generic;
    using Newtonsoft.Json;

    var attribution = new Dictionary<string, object> {
        ["status"] = "non_organic",
        ["channel"] = "Google Ads",
        ["campaign"] = "Christmas Sale",
        ["ad_group"] = "ad group 1",
        ["ad_set"] = "ad set 1",
        ["creative"] = "creative id 1"
    };

    var attributionJson = JsonConvert.SerializeObject(attribution);

    val attribution = mapOf(
        "status" to "non_organic",
        "channel" to "Google Ads",
        "campaign" to "Christmas Sale",
        "ad_group" to "ad group 1",
        "ad_set" to "ad set 1",
        "creative" to "creative id 1"
    )

    const attribution = {
      status: 'non_organic',
      channel: 'Google Ads',
      campaign: 'Christmas Sale',
      ad_group: 'ad group 1',
      ad_set: 'ad set 1',
      creative: 'creative id 1',
    };

Définissez les données d’attribution :

Transmettez le dictionnaire d’attribution à la méthode updateExternalAttribution (appelée updateAttribution avant la version 4.1 du SDK). Une fois qu’Adapty a enregistré la valeur d’attribution, vous ne pouvez plus la modifier :

   Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
       if error == nil {
           // attribution data accepted for processing
       }
   }

Wait, I need to re-read the input carefully. The input starts with a Tabs block and contains a TabItem for iOS (Swift) with a code block, then opens a TabItem for Android (Kotlin) but the content is cut off.

Let me output it exactly as given, preserving everything:

Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}

    Adapty.updateExternalAttribution(attribution, AdaptyExternalAttributionProvider.CUSTOM) { error ->
        if (error == null) {
            // attribution data accepted for processing
        }
    }

await adapty.updateExternalAttribution(attribution, 'custom');

   await Adapty().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.custom);

Adapty.UpdateExternalAttribution(
    attributionJson,
    AdaptyExternalAttributionProvider.Custom,
    (error) => {
        // handle the error
    });

    Adapty.updateExternalAttribution(
        attribution,
        AdaptyExternalAttributionProvider.CUSTOM
    ).onSuccess {
        // attribution data accepted for processing
    }.onError { error ->
        // handle the error
    }

await adapty.updateExternalAttribution({ attribution, provider: 'custom' });

Info

appliedExternalAttributionProviders ne rapporte que l’attribution provenant d’Apple Ads. L’attribution des autres fournisseurs est visible sur les profils utilisateurs et disponible dans les filtres de segment, mais pas encore ici.

Paramètres :

attribution (requis) : dictionnaire contenant les données d’attribution.
- provider (requis ; nommé source avant la version 4.1 du SDK) : fournisseur d’attribution. Utilisez la valeur personnalisée si votre fournisseur d’attribution ne prend pas en charge l’attribution intégrée — .custom sur iOS, AdaptyExternalAttributionProvider.CUSTOM sur Android et Kotlin Multiplatform, AdaptyExternalAttributionProvider.Custom sur Unity, AdaptyExternalAttributionProvider.custom sur Flutter, et la chaîne 'custom' sur Capacitor et React Native. Avant la version 4.1 du SDK, passez la chaîne "custom".

Désactivez les autres services de partage d’événements et les sources d’attribution pour éviter la duplication d’événements et les conflits de données.

Prévenir les problèmes de données

Sélectionner une seule source d’attribution

N’activez pas l’intégration d’attribution avec plusieurs plateformes en même temps. Adapty ne peut accepter qu’une seule source d’attribution à la fois, et une fois qu’une valeur d’attribution est enregistrée, elle ne peut pas être écrasée.

Si vous activez plusieurs sources d’attribution, Adapty sélectionnera la source contenant le plus de données — pas nécessairement les meilleures.

Par exemple, l’attribution Apple Search Ads non organique sera toujours prioritaire sur iOS. Pour désactiver l’attribution Apple Search Ads, ouvrez l’onglet App Settings -> Apple Search Ads et désactivez le commutateur Receive Apple Search Ads attribution.

Éviter la duplication des événements

Si vous utilisez Adapty pour partager des données d’abonnement en temps réel avec vos services d’attribution, vous devez désactiver les autres services qui remplissent le même rôle. Si vous avez connecté votre compte Facebook à AppsFlyer, Adjust ou Branch, ceux-ci transmettront automatiquement vos événements à ces services, sauf si vous désactivez cette option.

Les événements dupliqués peuvent fausser vos analyses et rendre l’interprétation des données difficile. Une fois le partage d’événements Adapty configuré, désactivez les fonctionnalités de transfert d’événements des services tiers.