Intégrer AppLovin à la médiation

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity Flutter

Ce guide explique comment utiliser GMA Next-Gen SDK pour charger et afficher des annonces AppLovin à l'aide de la médiation AdMob. Il aborde notamment les intégrations en cascade et par enchères. Vous apprendrez à ajouter AppLovin à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK AppLovin et son adaptateur dans une application Android.

Intégrations et formats d'annonces pris en charge

L'adaptateur de médiation pour AppLovin offre les fonctionnalités suivantes :

¹ Le format d'annonce à l'ouverture de l'application n'est disponible que pour les intégrations en cascade.

² La cascade n'est compatible qu'avec les tailles de bannières 320 x 50 et 728 x 90. Les enchères ne sont pas compatibles avec les bannières.

Conditions requises

• Niveau d'API Android 24 ou supérieur

• [Pour les enchères] Pour intégrer tous les formats d'annonces compatibles avec le mode enchères, utilisez l' adaptateur AppLovin 9.4.2.0 ou version ultérieure (la dernière version est recommandée).

• Dernière versionGMA Next-Gen SDK

• Avoir suivi le guide de démarrage sur la médiation

Étape 1 : Configurer les paramètres dans l'UI AppLovin

Inscrivez-vous ou connectez-vous à votre compte AppLovin.

Pour configurer votre bloc d'annonces AdMob, vous aurez besoin de votre clé SDK et de votre clé de rapport AppLovin. Pour les trouver, accédez à l' UI AppLovin > Account (Compte) > Keys (Clés) pour afficher les deux valeurs.

Si vous prévoyez d'intégrer uniquement les enchères, vous pouvez passer à la configuration de vos paramètres de médiation.

Sélectionner une application pour la médiation

Créer une zone

Mettre à jour votre fichier app-ads.txt

Le fichier Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab visant à garantir que l'inventaire publicitaire de votre application est vendu uniquement par l'intermédiaire des canaux de distribution que vous avez autorisés. Pour éviter une perte importante de revenus publicitaires, vous devez implémenter un fichier app-ads.txt. Si vous ne l'avez pas encore fait, configurez un fichier app-ads.txt pour votre application.

Pour implémenter app-ads.txt pour AppLovin, ajoutez AppLovin à votre fichier app-ads.txt.

Activer le mode test

Suivez les instructions du guide sur le mode test de MAX d'AppLovin pour activer les annonces test AppLovin.

Étape 2 : Configurer la demande AppLovin dans l'UI AdMob

Configurer les paramètres de médiation pour votre bloc d'annonces

Vous devez ajouter AppLovin à la configuration de médiation de votre bloc d'annonces.

Tout d'abord, connectez-vous à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à la section Ajouter AppLovin comme source d'annonces.

Pour créer un groupe de médiation, sélectionnez Create Mediation Group (Créer un groupe de médiation).

Saisissez votre format d'annonce et votre plate-forme, puis cliquez sur Continue (Continuer).

Attribuez un nom à votre groupe de médiation et sélectionnez les zones géographiques à cibler. Ensuite, définissez l' état du groupe de médiation sur Enabled (Activé), puis cliquez sur Add Ad Units (Ajouter des blocs d'annonces).

Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annonces AdMob existants. Cliquez ensuite sur Done (OK).

La fiche des blocs d'annonces doit maintenant contenir les blocs d'annonces que vous avez sélectionnés :

Ajouter AppLovin comme source d'annonces

Enchères

Sous la fiche Bidding (Enchères) de la section Ad Sources (Sources d'annonces), sélectionnez Add ad source (Ajouter une source d'annonces). Sélectionnez ensuite AppLovin.

Cliquez sur How to sign a partnership agreement (Comment signer un contrat partenaire) et configurez un partenariat d'enchères avec AppLovin.



Cliquez sur Acknowledge & agree (Reconnaître et accepter), puis sur Continue (Continuer).



Si vous avez déjà une mise en correspondance pour AppLovin, vous pouvez la sélectionner. Sinon, cliquez sur Add mapping (Ajouter une mise en correspondance).



Saisissez ensuite la clé SDK obtenue à la section précédente. Cliquez ensuite sur Done (OK).

Cascade

Sous la fiche Waterfall (Cascade) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces).

Sélectionnez AppLovin et activez le bouton Optimize (Optimiser). Saisissez la clé de rapport obtenue à la section précédente pour configurer l'optimisation des sources d'annonces pour AppLovin. Saisissez ensuite une valeur d'eCPM pour AppLovin, puis cliquez sur Continue (Continuer).



Si vous avez déjà une mise en correspondance pour AppLovin, vous pouvez la sélectionner. Sinon, cliquez sur Add mapping (Ajouter une mise en correspondance).

Saisissez ensuite l' ID de bundle de votre application, ainsi que la clé SDK et l'ID de zone obtenus à la section précédente. Cliquez ensuite sur Done (OK).

Ajouter AppLovin Corp. à la liste des partenaires publicitaires soumis au RGPD et aux réglementations des États américains

Suivez les étapes décrites dans Paramètres liés aux réglementations européennes et Paramètres liés aux réglementations des États américains pour ajouter AppLovin Corp. à la liste des partenaires publicitaires concernés dans l'UI AdMob.

Étape 3 : Importer le SDK et l'adaptateur AppLovin

Intégration d'Android Studio (recommandée)

Dans le fichier Gradle au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes :

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:applovin:13.6.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:applovin:13.6.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Intégration manuelle

• Téléchargez le SDK Android AppLovin , extrayez le applovin-sdk-x.y.z.jar, puis ajoutez-le à votre projet.

• Accédez aux artefacts de l'adaptateur AppLovin dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur AppLovin, puis ajoutez-le à votre projet.

Étape 4 : Implémenter les paramètres de confidentialité sur le SDK AppLovin

Consentement des utilisateurs de l'UE et RGPD

Pour respecter les Règles relatives au consentement de l'utilisateur dans l'UE de Google, vous devez fournir certaines informations à vos utilisateurs situés dans l'Espace économique européen (EEE), au Royaume-Uni et en Suisse, et obtenir leur consentement pour l'utilisation de cookies ou d'autres méthodes de stockage local lorsque la loi l'exige, ainsi que pour la collecte, le partage et l'utilisation de données à caractère personnel à des fins de personnalisation des annonces. Ces règles reflètent les exigences de la directive vie privée et communications électroniques de l'UE, et celles du Règlement général sur la protection des données (RGPD). Il vous incombe de vérifier que le consentement est transmis à chaque source d'annonces de votre chaîne de médiation. Google ne peut pas transmettre automatiquement le choix de l'utilisateur à ces réseaux.

Depuis la version 12.0.0, AppLovin est compatible avec la lecture de la chaîne de consentement à partir des préférences partagées et la définition de l'état de consentement en conséquence.

Si vous n'utilisez pas le SDK AppLovin version 12.0.0 ou ultérieure, ou si vous n'utilisez pas de CMP qui écrit la chaîne de consentement dans les préférences partagées , vous pouvez utiliser la méthode setHasUserConsent. L'exemple suivant transmet des informations sur le consentement au SDK AppLovin. Vous devez définir ces options avant d'initialiser GMA Next-Gen SDK pour qu'elles soient correctement transmises au SDK AppLovin.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

Pour en savoir plus, consultez les paramètres de confidentialité d'AppLovin.

Déclarer les utilisateurs enfants

À partir du SDK AppLovin 13.0.0, AppLovin n'est plus compatible avec les indicateurs d'utilisateur soumis à des restrictions d'âge. Vous ne pouvez pas initialiser ni utiliser le SDK AppLovin en lien avec un "enfant" tel que défini par les lois applicables. Pour en savoir plus, consultez la documentation d'AppLovin sur l'interdiction des données sur les enfants ou l'utilisation des services pour les enfants ou des applications exclusivement destinées aux enfants .

L'adaptateur AppLovin version 13.0.0.1 ou ultérieure désactive automatiquement la médiation AppLovin pour les applications qui déclarent l'un des paramètres suivants avec le GMA Next-Gen SDK :

• Paramètre destiné aux enfants

• Utilisateurs n'ayant pas atteint l'âge minimal requis

Lois sur la confidentialité des États américains

Les lois sur la confidentialité des États américains exigent d'offrir aux utilisateurs le droit de s'opposer à la "vente" de leurs "informations personnelles" (selon la définition de ces termes par la loi). Cette possibilité doit être proposée via un lien bien visible indiquant "Do Not Sell My Personal Information" (Ne pas vendre mes informations personnelles) et figurant sur la page d'accueil du "vendeur". Le guide de conformité aux lois sur la confidentialité des États américains vous permet d'activer le traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque réseau publicitaire de votre chaîne de médiation. Vous devez donc identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de participer à la vente d'informations personnelles et suivre les conseils propres à chacun pour assurer la conformité.

Le SDK AppLovin inclut la méthode setDoNotSell pour permettre aux éditeurs de refuser la vente d'informations personnelles.

L'exemple suivant transmet ces informations sur le consentement au SDK AppLovin. Vous devez définir ces options avant d'initialiser GMA Next-Gen SDK pour qu'elles soient correctement transmises au SDK AppLovin.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

Pour en savoir plus, consultez la documentation sur la confidentialité d'AppLovin's.

Étape 5 : Ajouter le code requis

Aucun code supplémentaire n'est requis pour l'intégration d'AppLovin.

Étape 6 : Tester votre implémentation

Activer les annonces test

Enregistrez votre appareil de test pour AdMob et activez le mode test dans l'UI AppLovin.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test d' AppLovin, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces AppLovin (enchères) et AppLovin (cascade).

Étapes facultatives

Paramètres spécifiques au réseau

L'adaptateur AppLovin est compatible avec setMuteAudio(), qui permet de désactiver l'audio des annonces vidéo. Cette méthode peut être appelée à partir d'un objet AppLovinExtras.Builder() :

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Optimisations

Codes d'erreur

Si l'adaptateur ne reçoit pas d'annonce d'AppLovin, les éditeurs peuvent vérifier l' erreur sous-jacente dans la réponse d'annonce à l'aide de ResponseInfo.getAdSourceResponses() dans les classes suivantes :

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

Voici les codes et les messages associés que génère l'adaptateur AppLovin lorsque le chargement d'une annonce échoue :