Intégrer AppLovin à la médiation

Sélectionnez une plate-forme : Android iOS Unity Flutter Android (ancienne version)

Ce guide explique comment utiliser le Google Mobile Ads Flutter Plugin pour charger et afficher des annonces AppLovin à l'aide de la médiation. Il aborde notamment les intégrations par enchères et en cascade. 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 Flutter.

Intégrations et formats d'annonces pris en charge

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

Intégration
Enchères
Cascade
Formats
Ouverture de l'application  1
Bannière  2
Interstitiel
Accordé

1 L'intégration en cascade est en version bêta fermée.

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

Prérequis

Avant de continuer, vérifiez les points suivants :

  • Dernière version de Google Mobile Ads Flutter Plugin.
  • Framework Flutter version 3.7.0 ou ultérieure.
  • Pour le déploiement sur Android
    • Niveau d'API Android 24 ou version ultérieure.
  • Pour le déploiement sur iOS
    • Cible de déploiement iOS 13.0 ou version ultérieure
  • Un projet Flutter fonctionnel configuré avec Google Mobile Ads Flutter Plugin. Pour en savoir plus, consultez Configurer Google Mobile Ads Flutter Plugin.
  • Configurez 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 Ad Manager, vous aurez besoin de votre clé SDK et de votre clé de rapport AppLovin. Pour les trouver, accédez à l'interface utilisateur 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

    Enchères

    Cette étape n'est pas requise pour les intégrations en mode enchères.

    Cascade

    Dans l'interface utilisateur d'AppLovin, sélectionnez Applications dans la section Monetization (Monétisation) pour accéder à vos applications enregistrées. Sélectionnez l'application que vous souhaitez utiliser avec la médiation dans la liste des applications disponibles.

    Créer une zone

    Enchères

    Cette étape n'est pas requise pour les intégrations en mode enchères.

    Cascade

    Dans l'interface utilisateur d'AppLovin, sélectionnez Zones dans la section Monetization (Monétisation) pour accéder aux ID de zone enregistrés. Si vous avez déjà créé les zones requises pour votre application, passez à l'étape 2. Pour créer un ID de zone, cliquez sur Créer une zone.

    Saisissez le nom de l'ID de zone, sélectionnez Android comme Plate-forme, puis choisissez le Type d'annonce.

    Configurez la tarification de la zone en sélectionnant CPM fixe ou Optimisé par AppLovin. Vous pouvez configurer les CPM par pays pour l'option CPM fixe. Ensuite, cliquez sur Enregistrer.

    Android

    iOS

    Une fois la zone créée, l'ID de zone se trouve dans la colonne ID de zone.

    Android

    iOS

    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, créez un fichier app-ads.txt pour Ad Manager.

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

    Activer le mode test

    Suivez les instructions du guide Mode test MAX d'AppLovin pour activer les annonces test AppLovin.

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

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

    Android

    Suivez les instructions de l'étape 2 du guide pour Android.

    iOS

    Suivez les instructions de l'étape 2 du guide pour iOS.

    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 Ad Manager.

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

    Intégration via pub.dev

    Ajoutez la dépendance suivante avec les dernières versions de l'adaptateur et du SDK AppLovin dans le fichier pubspec.yaml de votre package :

    dependencies:
  gma_mediation_applovin: ^2.6.4

    Intégration manuelle

    Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour AppLovin, extrayez le fichier téléchargé, puis ajoutez le dossier du plug-in extrait (et son contenu) à votre projet Flutter. Ensuite, référencez le plug-in dans votre fichier pubspec.yaml en ajoutant la dépendance suivante :

    dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

    Pour respecter les règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez fournir certaines informations à vos utilisateurs 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 formes 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.

    La version 1.0.0 et les versions ultérieures de l'adaptateur Flutter AppLovin permettent de transmettre les signaux de consentement RGPD du SDK UMP et des plates-formes de gestion du consentement qui s'intègrent à la spécification de consentement supplémentaire de Google.

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

    Déclarer des utilisateurs enfants

    AppLovin n'autorise pas l'initialisation du SDK AppLovin en lien avec un enfant. Pour en savoir plus, consultez la documentation d'AppLovin sur l'interdiction de collecter des données sur les enfants ou d'utiliser les services pour les enfants ou les applications ciblant exclusivement les enfants pour Android ou iOS.

    Le plug-in de médiation Flutter Google Mobile Ads pour AppLovin (version 9.1.0 ou ultérieure) désactive automatiquement la médiation vers AppLovin pour les applications qui déclarent un utilisateur enfant à l'aide de l'un des paramètres suivants :

    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 plug-in de médiation Google Mobile Ads pour AppLovin inclut la méthode GmaMediationApplovin.setDoNotSell(). L'exemple de code suivant montre comment transmettre les informations de consentement au SDK AppLovin. Vous devez définir ces options avant d'initialiser le SDK Google Mobile Ads pour qu'elles soient correctement transmises au SDK AppLovin.

    import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

    Étape 5 : Ajouter le code requis

    Android

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

    iOS

    Intégration de SKAdNetwork

    Suivez la documentation d'AppLovin pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.

    Étape 6 : Testez votre implémentation

    Activer les annonces test

    Enregistrez votre appareil de test pour Ad Manager 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 permet de transmettre un objet AppLovinMediationExtras à la demande d'annonce pour définir des paramètres spécifiques au réseau. L'exemple de code suivant montre comment désactiver l'audio sur les annonces vidéo à l'aide du paramètre isMuted :

    AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

    Optimisations

    L'ajout d'un appel à GmaMediationApplovin.initializeSdk('sdkKey') à votre activité de lancement permet à AppLovin de suivre les événements dès le démarrage de l'application.

    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 dans les classes suivantes :

    Android

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

    iOS

    GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

    Android

    Code d'erreur Motif
    -1009 à -1, 204 Le SDK AppLovin a renvoyé une erreur. Pour en savoir plus, consultez la documentation AppLovin.
    101 La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec AppLovin.
    103 Le contexte est nul.
    104 Le jeton d'enchère AppLovin est vide.
    105 Plusieurs annonces ont été demandées pour la même zone. AppLovin ne peut charger qu'une seule annonce à la fois par zone.
    106 L'annonce n'est pas prête à être diffusée.
    108 L'adaptateur AppLovin n'est pas compatible avec le format d'annonce demandé.
    109 Le contexte n'est pas une instance d'activité.
    110 La clé du SDK est manquante.
    112 L'utilisateur est un enfant.
    113 L'ID du bloc d'annonces est manquant.

    iOS

    Code d'erreur Motif
    -1009 à -1, 204 Le SDK AppLovin a renvoyé une erreur. Pour en savoir plus, consultez la documentation d'AppLovin.
    101 La taille d'annonce demandée ne correspond pas à une taille de bannière acceptée par AppLovin.
    102 Les paramètres du serveur AppLovin configurés dans l'interface utilisateur d'Ad Manager sont manquants ou non valides.
    103 Échec de l'affichage de l'annonce AppLovin.
    104 Plusieurs annonces ont été demandées pour la même zone. AppLovin ne peut charger qu'une seule annonce à la fois par zone.
    105 Clé SDK AppLovin introuvable.
    107 Le jeton d'enchère est vide.
    108 L'adaptateur AppLovin n'est pas compatible avec le format d'annonce demandé.
    110 AppLovin a envoyé un rappel de chargement réussi, mais n'a chargé aucune annonce.
    111 Impossible de récupérer l'instance du SDK AppLovin.
    112 L'utilisateur est un enfant.
    113 L'instance partagée du SDK AppLovin n'a pas été initialisée.
    114 Le SDK AppLovin ne parvient pas à renvoyer le jeton d'enchère.
    115 L'ID du bloc d'annonces est manquant. Impossible de charger l'annonce.
    116 L'annonce n'est pas prête. Impossible d'afficher l'annonce.

    Journal des modifications de l'adaptateur de médiation Flutter AppLovin

    Version 2.6.5 (en cours)

    Version 2.6.4

    Version 2.6.3

    Version 2.6.2

    Version 2.6.1

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 8.0.0.

    Version 2.6.0

    Version 2.5.2

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 7.0.0

    Version 2.5.1

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.5.0

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.4.0

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.3.2

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.3.1

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.3.0

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.2.1

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.2.0

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 6.0.0

    Version 2.1.0

    • Conçu et testé avec le plug-in Google Mobile Ads Flutter version 5.3.1

    Version 2.0.0

    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 5.3.1

    Version 1.2.0

    • Conçu et testé avec le plug-in Google Mobile Ads Flutter version 5.1.0

    Version 1.1.0

    • Conçu et testé avec le plug-in Google Mobile Ads Flutter version 5.1.0

    Version 1.0.0

    • Version initiale.
    • Conçu et testé avec le plug-in Flutter Google Mobile Ads version 5.0.0.