Reklamy z nagrodą

Wybierz platformę: Android (beta) Nowy-wybrany Android iOS Unity Flutter

Reklamy z nagrodą umożliwiają przekazywanie użytkownikom wirtualnych nagród w aplikacji w zamian za interakcje z reklamami wideo i reklamami demonstracyjnymi gier oraz za wypełnianie ankiet.

Wymagania wstępne

  • Skonfiguruj GMA Next-Gen SDK.

    • Zawsze testuj reklamy testowe

    Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie reklam rzeczywistych. Jeśli tego nie zrobisz, możemy zawiesić Twoje konto.

    Najłatwiejszym sposobem na wczytanie reklam testowych jest użycie naszego specjalnego identyfikatora jednostki reklamowej na potrzeby reklam z nagrodą na Androida:

    /21775744923/example/rewarded

    Został on specjalnie skonfigurowany tak, aby zwracać reklamy testowe w odpowiedzi na każde żądanie. Możesz go używać w swoich aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj tylko, aby przed opublikowaniem aplikacji zastąpić go własnym identyfikatorem jednostki reklamowej.

    Więcej informacji o reklamach testowych GMA Next-Gen SDK znajdziesz w artykule Włączanie reklam testowych.

    Wczytywanie reklamy

    Aby wczytać reklamę, GMA Next-Gen SDK oferuje te opcje:

    Wczytywanie za pomocą interfejsu API do wczytywania pojedynczych reklam

    Poniższy przykład pokazuje, jak wczytać pojedynczą reklamę:

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize GMA Next-Gen SDK.
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/rewarded"
  }
}

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "/21775744923/example/rewarded";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize GMA Next-Gen SDK.
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

    Wczytywanie za pomocą interfejsu API do wstępnego wczytywania reklam

    Aby rozpocząć wstępne wczytywanie, wykonaj te czynności:

    1. Zainicjuj konfigurację wstępnego wczytywania za pomocą żądania reklamy.

    2. Uruchom wstępne wczytywanie reklam z nagrodą za pomocą identyfikatora jednostki reklamowej i konfiguracji wstępnego wczytywania:

    Kotlin

    private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  RewardedAdPreloader.start(adUnitId, preloadConfig)
}

    RewardedAdSnippets.kt

    Java

    private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  RewardedAdPreloader.start(adUnitId, preloadConfig);
}

    RewardedAdSnippets.java

    Gdy reklama będzie gotowa do wyświetlenia, sondowanie reklamy z wstępnego wczytywania:

    Kotlin

    // Polling returns the next available ad and loads another ad in the background.
val ad = RewardedAdPreloader.pollAd(adUnitId)
    RewardedAdSnippets.kt

    Java

    // Polling returns the next available ad and loads another ad in the background.
final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);
    RewardedAdSnippets.java

    Ustawianie elementu RewardedAdEventCallback

    Element RewardedAdEventCallback obsługuje zdarzenia związane z wyświetlaniem elementu RewardedAd. Zanim wyświetlisz reklamę z nagrodą, ustaw wywołanie zwrotne:

    Kotlin

    // Listen for ad events.
rewardedAd?.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Rewarded ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Rewarded ad did dismiss.
      rewardedAd = null
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Rewarded ad failed to show.
      rewardedAd = null
    }

    override fun onAdImpression() {
      // Rewarded ad did record an impression.
    }

    override fun onAdClicked() {
      // Rewarded ad did record a click.
    }
  }

    Java

    // Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

      @Override
      public void onAdImpression() {
        // Rewarded ad did record an impression.
        RewardedAdEventCallback.super.onAdImpression();
      }

      @Override
      public void onAdClicked() {
        // Rewarded ad did record a click.
        RewardedAdEventCallback.super.onAdClicked();
      }
    }
);

    Wyświetl reklamę

    Aby wyświetlić reklamę z nagrodą, użyj metody show(). Do obsługi zdarzeń związanych z nagrodami użyj obiektu OnUserEarnedRewardListener.

    Kotlin

    // Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

    Java

    // Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

    Najczęstsze pytania

    Czy wywołanie inicjujące ma limit czasu?
    Po 10 sekundach pakiet GMA Next-Gen SDK wywołuje element OnInitializationCompleteListener, nawet jeśli sieć zapośredniczenia nie zakończyła jeszcze inicjowania.
    Co się stanie, jeśli niektóre sieci zapośredniczenia nie będą gotowe, gdy otrzymam wywołanie zwrotne inicjowania?

    Zalecamy wczytywanie reklamy w wywołaniu zwrotnym elementu OnInitializationCompleteListener. Nawet jeśli sieć zapośredniczenia nie jest gotowa, GMA Next-Gen SDK nadal wysyła do niej żądanie reklamy. Jeśli więc sieć zapośredniczenia zakończy inicjowanie po upływie limitu czasu, nadal może obsługiwać przyszłe żądania reklam w tej sesji.

    Możesz nadal sondować stan inicjowania wszystkich adapterów w sesji aplikacji, wywołując metodę MobileAds.getInitializationStatus().

    Jak sprawdzić, dlaczego dana sieć zapośredniczenia nie jest gotowa?

    Metoda AdapterStatus.getDescription() opisuje, dlaczego adapter nie jest gotowy do obsługi żądań reklam.

    Czy wywołanie zwrotne onUserEarnedReward() jest zawsze wywoływane przed wywołaniem zwrotnym onAdDismissedFullScreenContent()?

    W przypadku reklam Google wszystkie wywołania onUserEarnedReward() występują przed wywołaniem onAdDismissedFullScreenContent(). W przypadku reklam wyświetlanych w ramach zapośredniczeniakolejność wywołań zwrotnych zależy od implementacji pakietu SDK sieci reklamowej firmy zewnętrznej. W przypadku pakietów SDK sieci reklamowych, które udostępniają pojedyncze wywołanie zwrotne z informacjami o nagrodzie, adapter zapośredniczenia wywołuje metodę onUserEarnedReward() przed metodą onAdDismissedFullScreenContent().

    Przykład

    Pobierz i uruchom przykładową aplikację , która pokazuje, jak używać GMA Next-Gen SDK.