Reklamy pełnoekranowe z nagrodą (beta)

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Reklama pełnoekranowa z nagrodą to format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji. Reklamy tego typu wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji. W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na wyświetlenie reklamy pełnoekranowej z nagrodą.

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads Unity Plugin.

Zawsze przeprowadzaj testy z użyciem reklam testowych

Poniższy przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do żądania reklam testowych. Został on specjalnie skonfigurowany tak, aby w odpowiedzi na każde żądanie zwracać reklamy testowe, a nie produkcyjne, dzięki czemu jest bezpieczny w użyciu.

Jednak po zarejestrowaniu aplikacji w interfejsie internetowym AdMob i utworzeniu własnych identyfikatorów jednostek reklamowych do użycia w aplikacji musisz podczas jej tworzenia wyraźnie skonfigurować swoje urządzenie jako urządzenie testowe.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Zainicjuj Google Mobile Ads Unity Plugin

Zanim aplikacja wczyta reklamy, musi zainicjować Google Mobile Ads Unity Plugin, wywołując funkcję MobileAds.Initialize(). Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

Jeśli korzystasz z zapośredniczenia, przed wczytaniem reklam poczekaj na wywołanie zwrotne, aby mieć pewność, że wszystkie adaptery zapośredniczenia zostały zainicjowane.

Implementacja

Główne etapy integracji reklam pełnoekranowych z nagrodą:

1. Wczytywanie reklamy pełnoekranowej z nagrodą
2. [Opcjonalnie] Sprawdzanie wywołań zwrotnych weryfikacji po stronie serwera (SSV)
3. Wyświetlanie reklamy pełnoekranowej z nagrodą i wywołaniem zwrotnym dotyczącym nagrody
4. Nasłuchiwanie zdarzeń reklam pełnoekranowych z nagrodą
5. Wyczyść reklamę pełnoekranową z nagrodą
6. Wstępne wczytywanie następnej reklamy pełnoekranowej z nagrodą

Wczytywanie reklamy pełnoekranowej z nagrodą

Reklamę pełnoekranową z nagrodą wczytuje się za pomocą statycznej metody Load() w klasie RewardedInterstitialAd. Metoda wczytywania wymaga identyfikatora jednostki reklamowej, obiektu AdRequest i procedury obsługi zakończenia, która jest wywoływana, gdy wczytywanie reklamy się powiedzie lub nie. Wczytany obiekt RewardedInterstitialAd jest podawany jako parametr w procedurze obsługi zakończenia. Przykład poniżej pokazuje, jak wczytać RewardedInterstitialAd.

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

  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 AdRequest();
      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;
          });
  }

Ostrzeżenie: zdecydowanie odradzamy próby wczytania nowej reklamy z bloku zakończenia żądania reklamy, gdy nie udało się wczytać reklamy. Jeśli musisz wczytać reklamę z bloku zakończenia żądania reklamy, ogranicz liczbę ponownych prób wczytania, aby uniknąć ciągłych nieudanych żądań reklamy w sytuacjach takich jak ograniczone połączenie sieciowe.

Wskazówka: Możesz używać wywołań wczytywania reklam, aby utworzyć pamięć podręczną wstępnie załadowanych reklam, zanim chcesz je wyświetlić. Dzięki temu reklamy będą wyświetlane bez opóźnień, gdy będzie to konieczne. Reklamy wygasają po godzinie, dlatego należy co godzinę czyścić pamięć podręczną i wczytywać nowe reklamy.

[Opcjonalnie] Sprawdzanie wywołań zwrotnych weryfikacji po stronie serwera (SSV)

Aplikacje, które wymagają dodatkowych danych w wywołaniach zwrotnych weryfikacji po stronie serwera, powinny korzystać z funkcji danych niestandardowych reklam pełnoekranowych z nagrodą. Każda wartość ciągu znaków ustawiona w obiekcie reklamy z nagrodą jest przekazywana do parametru zapytania custom_data wywołania zwrotnego SSV. Jeśli nie ustawiono żadnej wartości danych niestandardowych, wartość parametru zapytania custom_data nie zostanie uwzględniona w wywołaniu zwrotnym SSV.

Poniższy przykładowy kod pokazuje, jak ustawić opcje SSV po załadowaniu reklamy pełnoekranowej z nagrodą.

// 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);
        
});

Jeśli chcesz ustawić niestandardowy ciąg znaków nagrody, musisz to zrobić przed wyświetleniem reklamy.

Ważne: niestandardowy ciąg znaków nagrody jest zakodowany procentowo i może wymagać dekodowania podczas analizowania z wywołania zwrotnego SSV.

Wyświetlanie reklamy pełnoekranowej z nagrodą i wywołaniem zwrotnym dotyczącym nagrody

Podczas wyświetlania reklamy musisz podać wywołanie zwrotne, aby obsłużyć nagrodę dla użytkownika. Reklamy mogą być wyświetlane tylko raz na każde wczytanie. Użyj metody CanShowAd(), aby sprawdzić, czy reklama jest gotowa do wyświetlania.

Poniższy kod przedstawia najlepszą metodę wyświetlania reklamy pełnoekranowej z nagrodą.

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));
        });
    }
}

Ważna uwaga: zanim zaczniesz wyświetlać użytkownikom reklamę pełnoekranową z nagrodą, musisz wyświetlić ekran początkowy, który zawiera jasny komunikat o nagrodzie i opcję pominięcia reklamy, zanim się ona rozpocznie. Więcej informacji

Nasłuchiwanie zdarzeń reklam pełnoekranowych z nagrodą

Aby dodatkowo dostosować zachowanie reklamy, możesz podłączyć się do wielu zdarzeń w cyklu życia reklamy. Aby nasłuchiwać tych zdarzeń, zarejestruj obiekt delegowany, jak pokazano poniżej.

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);
    };
}

Wyczyść reklamę pełnoekranową z nagrodą

Gdy skończysz korzystać z obiektu RewardedInterstitialAd, przed usunięciem odwołania do niego wywołaj metodę Destroy():

_rewardedInterstitialAd.Destroy();

Dzięki temu wtyczka dowie się, że obiekt nie jest już używany i można odzyskać zajmowaną przez niego pamięć. Jeśli nie wywołasz tej metody, dojdzie do wycieków pamięci.

Wstępne wczytywanie następnej reklamy pełnoekranowej z nagrodą

RewardedInterstitialAd jest obiektem jednorazowego użytku. Oznacza to, że po wyświetleniu reklamy pełnoekranowej z nagrodą nie można ponownie użyć obiektu. Aby wysłać żądanie wyświetlenia kolejnej reklamy pełnoekranowej z nagrodą, musisz wczytać nowy obiekt RewardedInterstitialAd.

Aby przygotować pełnoekranową reklamę z nagrodą na kolejną możliwość realizacji wyświetlenia, wstępnie wczytaj ją po wywołaniu zdarzenia reklamowego OnAdFullScreenContentClosed lub OnAdFullScreenContentFailed.

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();
    };
}

Dodatkowe materiały

• Przykład HelloWorld: minimalna implementacja wszystkich formatów reklam.