Interstitiel avec récompense (bêta)

Les interstitiels avec récompense sont un type Il s'agit d'un format d'annonce incitatif qui vous permet de récompenser les annonces diffusées automatiquement lors des transitions naturelles de l'application. Contrairement aux annonces avec récompense, pour pouvoir regarder un interstitiel avec récompense.

Prérequis

• Suivez le guide de démarrage.

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 des annonces de production pour chaque requête, ce qui vous permet de les utiliser en toute sécurité.

Cependant, une fois que vous avez enregistré une application dans de l'interface Web Ad Manager et créé votre propre bloc d'annonces ID à utiliser dans votre application, configurez explicitement votre appareil en tant que test de l'appareil développement d'applications.

/6499/example/rewarded-interstitial

Initialiser le SDK Mobile Ads

Avant de charger les annonces, demandez à votre application d'initialiser le SDK Mobile Ads en appelant MobileAds.Initialize() Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Si vous utilisez la médiation, attendez que le rappel ait lieu avant de charger les annonces en tant que afin de garantir que tous les adaptateurs de médiation sont initialisés.

Implémentation

Voici les principales étapes à suivre pour intégrer des annonces interstitielles avec récompense:

1. Charger l'annonce interstitielle avec récompense
2. [Facultatif] Valider les rappels de validation côté serveur (SSV)
3. Diffuser l'annonce interstitielle avec récompense avec un rappel associé à la récompense
4. Écouter des événements d'annonces interstitielles avec récompense
5. Nettoyer l'annonce interstitielle avec récompense
6. Précharger la prochaine annonce interstitielle avec récompense

Charger l'annonce interstitielle avec récompense

Le chargement d'une annonce interstitielle avec récompense s'effectue à l'aide de l'élément statique Load(). sur la classe RewardedInterstitialAd. La méthode de chargement nécessite une annonce un identifiant d'unité, un objet AdManagerAdRequest et un code qui est appelé lorsque le chargement de l'annonce réussit ou échoue. La partie chargée L'objet RewardedInterstitialAd est fourni en tant que paramètre dans la saisie semi-automatique . L'exemple ci-dessous montre comment charger un RewardedInterstitialAd.

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/6499/example/rewarded-interstitial";

  private RewardedInterstitialAd _rewardedInterstitialAd;

  /// <summary>
  /// Loads the rewarded interstitial ad.
  /// </summary>
  public void LoadRewardedInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_rewardedInterstitialAd != null)
      {
            _rewardedInterstitialAd.Destroy();
            _rewardedInterstitialAd = null;
      }

      Debug.Log("Loading the rewarded interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdManagerAdRequest();
      adRequest.Keywords.Add("unity-admob-sample");

      // send the request to load the ad.
      RewardedInterstitialAd.Load(_adUnitId, adRequest,
          (RewardedInterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("rewarded interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Rewarded interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _rewardedInterstitialAd = ad;
          });
  }

Avertissement :Une tentative de chargement d'une nouvelle annonce à partir du blocage de la finalisation de la demande d'annonce l'échec du chargement d'une annonce est vivement déconseillé. Si vous devez charger une annonce à partir de l'annonce bloquer la saisie semi-automatique des requêtes, limitez le nombre de tentatives de chargement des annonces afin d'éviter demandes d'annonces ayant échoué en cas de connectivité réseau limitée, par exemple

Conseil: Vous pouvez utiliser les appels de volume d'annonces pour créer un cache d'annonces préchargées avant ont l'intention de les diffuser, de sorte que les annonces puissent s'afficher en cas de besoin sans latence. Les annonces expirent au bout d'une heure. Vous devez donc vider ce cache et actualiser toutes les heures.

[Facultatif] Valider les rappels de validation côté serveur (SSV)

Applications nécessitant des données supplémentaires lors de la validation côté serveur les rappels doivent utiliser la fonctionnalité de données personnalisées des annonces interstitielles avec récompense. Toute valeur de chaîne définie sur un objet d'annonce avec récompense est transmise à custom_data paramètre de requête du rappel SSV. Si aucune valeur de données personnalisées n'est définie, le La valeur du paramètre de requête custom_data ne sera pas incluse dans le rappel SSV.

L'exemple de code suivant montre comment définir les options de validation côté serveur après la L'annonce interstitielle avec récompense est chargée.

// send the request to load the ad.
RewardedInterstitialAd.Load(_adUnitId,
                            adRequest,
                            (RewardedInterstitialAd ad, LoadAdError error) =>
    {
        // If the operation failed, an error is returned.
        if (error != null || ad == null)
        {
            Debug.LogError("Rewarded interstitial ad failed to load an ad " +
                           " with error : " + error);
            return;
        }

        // If the operation completed successfully, no error is returned.
        Debug.Log("Rewarded interstitial ad loaded with response : " +
                   ad.GetResponseInfo());
        
        // Create and pass the SSV options to the rewarded ad.
        var options = new ServerSideVerificationOptions
                              .Builder()
                              .SetCustomData("SAMPLE_CUSTOM_DATA_STRING")
                              .Build()
        ad.SetServerSideVerificationOptions(options);
        
});

Si vous souhaitez définir une chaîne de récompense personnalisée, vous devez le faire avant d'afficher la annonce.

Important :La chaîne de récompense personnalisée est % d'échappement et peut nécessiter un décodage lorsqu'il est analysé à partir du rappel SSV.

Diffuser l'annonce interstitielle avec récompense avec un rappel associé à la récompense

Lorsque vous présentez votre annonce, vous devez fournir un rappel pour gérer la récompense pour l'utilisateur. Les annonces ne peuvent être diffusées qu'une seule fois par chargement. Utilisez la méthode CanShowAd() pour vérifier que l'annonce est prête à être diffusée

Le code suivant présente la meilleure méthode pour afficher une récompense votre annonce interstitielle.

public void ShowRewardedInterstitialAd()
{
    const string rewardMsg =
        "Rewarded interstitial ad rewarded the user. Type: {0}, amount: {1}.";

    if (rewardedInterstitialAd != null && rewardedInterstitialAd.CanShowAd())
    {
        rewardedInterstitialAd.Show((Reward reward) =>
        {
            // TODO: Reward the user.
            Debug.Log(String.Format(rewardMsg, reward.Type, reward.Amount));
        });
    }
}

Important :Avant de diffuser une annonce interstitielle avec récompense auprès des utilisateurs, vous devez Présentez à l'utilisateur un écran d'introduction qui présente un message clair sur la récompense et une option permettant d'ignorer l'annonce avant qu'elle ne commence. En savoir plus

Écouter des événements d'annonces interstitielles avec récompense

Pour personnaliser davantage le comportement de votre annonce, vous pouvez intégrer un certain nombre les événements du cycle de vie de l'annonce. Écouter ces événements en enregistrant un délégué comme indiqué ci-dessous.

private void RegisterEventHandlers(RewardedInterstitialAd ad)
{
    // Raised when the ad is estimated to have earned money.
    ad.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Rewarded interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    ad.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Rewarded interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    ad.OnAdClicked += () =>
    {
        Debug.Log("Rewarded interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    ad.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);
    };
}

Nettoyer l'annonce interstitielle avec récompense

Lorsque vous avez terminé avec un RewardedInterstitialAd, veillez à appeler la méthode Destroy() avant d'y déposer votre référence:

_rewardedInterstitialAd.Destroy();

Cela indique au plug-in que l'objet n'est plus utilisé et la mémoire qu'il occupée peut être récupérée. L'échec de l'appel de cette méthode entraîne des fuites de mémoire.

Précharger la prochaine annonce interstitielle avec récompense

RewardedInterstitialAd est un objet à usage unique. Cela signifie qu'une fois qu'une annonce avec récompense l'annonce interstitielle s'affiche, l'objet ne peut pas être réutilisé. Pour en demander un autre annonce interstitielle avec récompense, vous devrez charger une nouvelle RewardedInterstitialAd .

Afin de préparer une annonce interstitielle avec récompense pour la prochaine opportunité d'impression, préchargez l'annonce interstitielle avec récompense une fois que l'élément OnAdFullScreenContentClosed ou OnAdFullScreenContentFailed événement d'annonce est déclenché.

private void RegisterReloadHandler(RewardedInterstitialAd ad)
{
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
}

Ressources supplémentaires

• Exemple HelloWorld: Une implémentation minimale de tous les formats d'annonces.