Intégrer AppLovin à la médiation AdMob

Ce guide explique comment utiliser le Google Mobile Ads SDK for React Native pour charger et afficher des annonces AppLovin à l'aide de la médiation. Il aborde notamment les intégrations d'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 React Native.

Intégrations et formats d'annonces pris en charge

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

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

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 :

É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'interface utilisateur AppLovin > Account (Compte) > Keys (Clés).

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. Les CPM peuvent être configurés par pays pour l'option CPM fixe. Ensuite, cliquez sur Enregistrer.

Android

iOS

Une fois la zone créée, son ID est indiqué 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, 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 Mode test MAX d'AppLovin pour activer les annonces tests AppLovin.

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

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 AdMob.

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

Dans le répertoire racine de votre projet, installez l'adaptateur de médiation Google Mobile Ads SDK for React Native pour AppLovin. Effectuer les actions suivantes :

  1. Copiez le fichier tar de l'adaptateur Google Mobile Ads SDK for React Native du répertoire gma-sdk-react-native/adapters/applovin/ dans le répertoire local_packages/ de votre projet. Si vous ne disposez pas du dossier adapters, consultez la section Prérequis.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/applovin/gma-mediation-applovin-0.1.0.tgz local_packages/

    Remplacez EXTRACT_DIR par le chemin d'accès au répertoire dans lequel vous avez extrait l'archive.

  2. Installez le package de l'adaptateur à l'aide de votre gestionnaire de packages préféré :

    npm

    npm install ./local_packages/gma-mediation-applovin-0.1.0.tgz

    fil

    yarn add ./local_packages/gma-mediation-applovin-0.1.0.tgz

É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 aux utilisateurs de l'Espace économique européen (EEE), du Royaume-Uni et de la Suisse. Vous devez également obtenir leur consentement pour l'utilisation de cookies ou d'autres types de stockage local lorsque la loi l'exige, ainsi que pour la collecte, le partage et l'utilisation de données à caractère personnel pour la 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 0.1.0 et les versions ultérieures de l'adaptateur AppLovin React Native 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 au SDK AppLovin. Pour en savoir plus, consultez Consentement au TCF v2.

Déclarer des utilisateurs enfants

AppLovin n'est pas compatible avec l'initialisation du SDK AppLovin pour 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 Google Mobile Ads React Native pour AppLovin désactive automatiquement la médiation vers AppLovin pour les applications qui déclarent un utilisateur enfant à l'aide de l'option Définir le traitement selon l'âge.

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 AppLovinMediation.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 { AppLovinMediation } from '@google/gma-mediation-applovin';
// ...

AppLovinMediation.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 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 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 :

import { AdRequest } from '@google/mobile-ads';
import { AppLovinMediationExtras } from '@google/gma-mediation-applovin';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new AppLovinMediationExtras({
      isMuted: true, // Mute audio for AppLovin ads
    }),
  ],
};

Optimisations

En ajoutant un appel à à votre activité de lancement, vous permettez à 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 à -1204 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 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 ID du bloc d'annonces manquant.

iOS

Code d'erreur Motif
-1009 à -1204 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 compatible avec AppLovin.
102 Les paramètres du serveur AppLovin configurés dans l'interface utilisateur d'AdMob 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é du 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 ID du bloc d'annonces manquant. Impossible de charger l'annonce.
116 L'annonce n'est pas prête. Impossible d'afficher l'annonce.

Version 0.1.0

  • Version initiale.