Premiers pas

Ce guide est destiné aux éditeurs qui souhaitent monétiser une application Flutter.

L'intégration du SDK Google Mobile Ads dans une application Flutter (ce que vous allez faire ici) est la première étape pour diffuser des annonces Ad Manager et générer des revenus. Une fois l'intégration terminée, vous pouvez choisir un format d'annonce pour obtenir des instructions détaillées sur l'implémentation.

Le SDK Google Mobile Ads pour Flutter permet actuellement de charger et d'afficher des bannières, des annonces interstitielles (plein écran), des annonces natives et des annonces avec récompense.

Prérequis

  • Flutter 1.22.0 ou version ultérieure
  • Android
    • Android Studio version 3.2 ou ultérieure
    • Cibler le niveau d'API Android 20 ou supérieur
    • Définissez compileSdkVersion sur 28 ou plus.
  • iOS

Importer le SDK Mobile Ads

Configuration spécifique à la plate-forme

Android

Mettre à jour le fichier AndroidManifest.xml

L'ID d'application Ad Manager doit être inclus dans le AndroidManifest.xml. Dans le cas contraire, un plantage se produit au lancement de l'application.

Ajoutez l'ID d'application Ad Manager (identifié dans l'interface utilisateur d'Ad Manager) au fichier android/app/src/main/AndroidManifest.xml de l'application en ajoutant une balise <meta-data> nommée com.google.android.gms.ads.APPLICATION_ID. Vous trouverez l'ID de votre application dans l'interface utilisateur d'Ad Manager. Pour android:value, insérez votre propre ID d'application Ad Manager entre guillemets, comme indiqué ci-dessous:

<manifest>
    <application>
        <!-- Sample 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>

Utilisez la même valeur value lorsque vous initialisez le plug-in dans votre code Dart.

Pour en savoir plus sur la configuration de AndroidManifest.xml et de l'ID d'application, consultez le guide Android.

iOS

Mettre à jour votre fichier Info.plist

Dans le fichier ios/Runner/Info.plist de votre application, ajoutez une clé GADApplicationIdentifier avec la valeur de chaîne de votre ID d'application Ad Manager (identifié dans l'interface utilisateur d'Ad Manager):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

Vous devez transmettre la même valeur lorsque vous initialisez le plug-in dans votre code Dart.

Pour en savoir plus sur la configuration de Info.plist et de votre ID d'application, consultez le guide iOS.

Initialiser le SDK Mobile Ads

Avant de charger les annonces, demandez à votre application d'initialiser le SDK Mobile Ads en appelant MobileAds.instance.initialize(), qui initialise le SDK et renvoie un Future qui se termine une fois l'initialisation terminée (ou après un délai de 30 secondes). Cette opération ne doit être effectuée qu'une seule fois, idéalement juste avant d'exécuter l'application.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}

Sélectionnez un format d'annonce

Le SDK Mobile Ads est maintenant importé et vous êtes prêt à intégrer une annonce. Ad Manager propose différents formats d'annonces. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application.

Annonces rectangulaires qui s'affichent en haut ou en bas de l'écran de l'appareil. Les bannières restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous débutez dans la publicité mobile, c'est un bon point de départ.

Implémenter une bannière

Interstitiel

Annonces plein écran qui couvrent l'interface d'une application jusqu'à sa fermeture par l'utilisateur Elles sont mieux adaptées aux pauses naturelles dans le flux d'exécution d'une application, par exemple entre deux niveaux d'un jeu ou juste après avoir terminé une tâche.

Intégrer une annonce interstitielle

Natif

Annonces personnalisables qui reflètent l'apparence de votre application. Vous pouvez choisir leur emplacement et leur emplacement afin que la mise en page soit plus cohérente avec l'interface de votre application.

Intégrer une annonce native

Accordé

Annonces qui récompensent les utilisateurs pour avoir regardé de courtes vidéos, et interagi avec des annonces jouables et des enquêtes. Idéal pour monétiser les jeux sans frais.

Intégrer une annonce avec récompense