Commencer

L'intégration du SDK Google Mobile Ads dans une application constitue la première étape vers diffuser des annonces et générer des revenus. Une fois le SDK intégré, vous pouvez choisissez un format d'annonce (vidéo native ou avec récompense, par exemple) et suivez la procédure pour le mettre en œuvre.

Avant de commencer

Pour préparer votre application, procédez comme indiqué dans les sections suivantes.

Conditions requises pour l'application

  • Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :

    • Version minimale du SDK : 21 ou supérieur
    • Compilez la version du SDK de 33 ou supérieur

Configurer votre application

  1. Dans votre fichier de paramètres Gradle, incluez le dépôt Maven de Google et Dépôt central Maven:

    Kotlin

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include(":app")

    Groovy

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. Ajouter les dépendances du SDK Google Mobile Ads à votre build au niveau de l'application :

    Kotlin

    dependencies {
      implementation("com.google.android.gms:play-services-ads:23.3.0")
    }

    Groovy

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Ajoutez Ad Manager l'ID de votre application, tel qu'il est identifié dans le Ad Manager à l'interface Web AndroidManifest.xml. Pour ce faire, ajoutez une balise <meta-data> avec android:name="com.google.android.gms.ads.APPLICATION_ID" Vous trouverez l'ID de votre application dans l' Ad Manager interface Web. Pour android:value, insérez votre propre Ad Manager ID d'application, entourée de guillemets.

    <manifest>
      <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    Dans une application réelle, remplacez l'ID de l'application exemple par votre réelle Ad Manager ID de l'application. Vous pouvez utiliser l'exemple d'ID si vous testez simplement le SDK dans une application Hello World.

    Notez également que l'échec de l'ajout de la balise <meta-data> exactement comme les résultats affichés dans un plantage avec le message suivant:

    Missing application ID.
    

    (Facultatif) Déclarer Autorisation AD_ID pour que les versions précédentes fonctionnent avec Android 13.

    Si votre application utilise la version 20.4.0 du SDK Google Mobile Ads ou vous pouvez ignorer cette étape, car le SDK déclare automatiquement com.google.android.gms.permission.AD_ID et peut pour accéder à l'identifiant publicitaire chaque fois qu'il est disponible.

    Pour les applications qui utilisent le SDK Google Mobile Ads version 20.3.0 ou et que vous ciblez Android 13, vous devez ajouter Autorisation com.google.android.gms.permission.AD_ID dans AndroidManifest.xml pour que le SDK Google Mobile Ads accéder à l'identifiant publicitaire:

    <manifest>
     <application>
       <meta-data
           android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
       <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
       <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
     </application>
    </manifest>

    Pour en savoir plus sur la com.google.android.gms.permission.AD_ID déclaration d'autorisation, y compris comment la désactiver, reportez-vous à ce Play de la console.

Initialiser le SDK Google Mobile Ads

Avant de charger les annonces, initialisez le SDK Google Mobile Ads en appelant MobileAds.initialize()

Cette méthode initialise le SDK et appelle un écouteur d'achèvement une fois que les L'initialisation du SDK et de l'adaptateur Google Mobile Ads est terminée, ou après une Délai avant expiration de 30 secondes. Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

Les annonces peuvent être préchargées par le SDK Google Mobile Ads ou les SDK des partenaires de médiation. lors de l'initialisation. Si vous devez obtenir le consentement des utilisateurs en Europe Dans l'Espace économique (EEE), définissez des indicateurs spécifiques à une demande, comme setTagForChildDirectedTreatment() ou setTagForUnderAgeOfConsent(), ou sinon prenez les mesures nécessaires avant de charger les annonces, veillez à le faire avant de le SDK Google Mobile Ads.

Voici un exemple d'appel de la méthode initialize() sur un arrière-plan. thread au sein d'une activité:

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est maintenant importé et vous êtes prêt à mettre en œuvre une annonce. Ad Manager propose différents formats d'annonces. vous pouvez choisir celui qui convient le mieux à l'expérience utilisateur de votre application.

Les blocs de bannières affichent des annonces rectangulaires qui occupent une partie de l'espace mise en page. Elles peuvent s'actualiser automatiquement après un certain délai. Cela signifie Les utilisateurs voient une nouvelle annonce à intervalles réguliers, même s'ils restent dans votre application. Il s'agit également du format d'annonce le plus simple à mettre en œuvre.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles affichent des annonces pleine page dans votre application. Positionnez-les à l'endroit des pauses et des transitions dans l'interface de votre application, par exemple à la fin d'un niveau. dans une application de jeu.

Implémenter des annonces interstitielles

Natif

Les annonces natives vous permettent de personnaliser la façon dont vos composants (titres, titres, etc.) des incitations à l'action sont présentées dans vos applications. En appliquant vous-même un style à l'annonce, vous pouvez : Créez des présentations publicitaires naturelles et discrètes qui plairont à un utilisateur riche expérience.

Google Ad Manager propose deux méthodes pour intégrer des annonces natives: les styles natifs et les annonces natives standards via l'affichage personnalisé.

Les styles natifs ont été conçus pour simplifier l'implémentation des annonces natives, et c'est un excellent choix si vous débutez dans ce format. L'affichage personnalisé a été conçu pour maximiser votre liberté de création de présentations.

Implémenter des styles natifs Implémenter des annonces natives (affichage personnalisé)

Avec récompense

Les blocs d'annonces avec récompense permettent aux utilisateurs de jouer à des jeux, de répondre à des enquêtes ou de regarder des vidéos pour : gagner des récompenses dans l'application, comme des pièces, des vies supplémentaires ou des points ; Vous pouvez définir différentes récompenses selon les blocs d'annonces, et spécifier leurs valeurs et articles reçus par l'utilisateur.

Implémenter des annonces avec récompense

Interstitiel avec récompense

L'interstitiel avec récompense est un nouveau type de format d'annonce incitatif qui vous permet proposer des récompenses, telles que des pièces ou des vies supplémentaires, pour les annonces diffusées automatiquement ; lors des transitions naturelles de l'application.

Contrairement aux annonces avec récompense, les utilisateurs ne sont pas obligés d'activer la diffusion d'annonces avec récompense interstitiel.

Au lieu de l'invite d'activation dans les annonces avec récompense, les interstitiels avec récompense nécessitent un un écran d'introduction qui annonce la récompense et donne aux utilisateurs la possibilité de la désactiver s'ils elle souhaite le faire.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

Les annonces à l'ouverture sont des annonces qui s'affichent lorsque les utilisateurs accèdent à votre l'application. L'annonce se superpose à l'écran de chargement.

Implémenter des annonces à l'ouverture d'une application

Ressources supplémentaires

Le dépôt Google Mobile Ads sur GitHub montre comment utiliser les différents formats d'annonces proposés par cette API.