Premiers pas

Les annonces natives en superposition sont présentées aux utilisateurs à l'aide de composants d'interface utilisateur natifs pour la plate-forme. Ces annonces sont présentées en superposition de l'application. Elles fonctionnent de la même manière que les bannières publicitaires, mais vous pouvez personnaliser leur apparence.

Les annonces natives en superposition sont compatibles avec la médiation et les annonces vidéo. Il s'agit d'un avantage clé par rapport aux annonces natives.

Ce guide vous explique comment implémenter des annonces natives en superposition dans une application Unity, ainsi que certains points importants à prendre en compte.

Prérequis

Avant de continuer, procédez comme suit :

• Configurez Google Mobile Ads Unity Plugin.
• Installez le plug-in Unity 9.0.0 ou version ultérieure.

Toujours tester avec des annonces tests

L'exemple de code suivant contient un ID de bloc d'annonces que vous pouvez utiliser pour demander des annonces tests. Il a été spécialement configuré pour renvoyer des annonces tests plutôt que des annonces de production pour chaque requête, ce qui le rend sûr à utiliser.

Toutefois, une fois que vous avez enregistré une application dans l'interface Web AdMob et créé vos propres ID de bloc d'annonces à utiliser dans votre application, configurez explicitement votre appareil en tant qu'appareil de test lors du développement.

Charger l'annonce native en superposition

Le chargement d'une annonce native en superposition s'effectue à l'aide de la méthode statique Load() sur la classe NativeOverlayAd. L'objet NativeOverlayAd chargé est fourni en tant que paramètre dans le gestionnaire d'achèvement.

Le code suivant utilise NativeOverlayAd pour charger une annonce :

  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/2247696110";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/3986624511";
#else
  private string _adUnitId = "unused";
#endif


private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: "