संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
पेज पर अचानक दिखने वाले विज्ञापन, फ़ुल-स्क्रीन वाले विज्ञापन होते हैं. ये अपने होस्ट ऐप्लिकेशन के इंटरफ़ेस को कवर करते हैं.
आम तौर पर, ये ऐप्लिकेशन के फ़्लो के दौरान स्वाभाविक ट्रांज़िशन पॉइंट पर दिखाए जाते हैं.
जैसे, गतिविधियों के बीच में या गेम के लेवल के बीच में
रोकने के दौरान ये विज्ञापन दिखाए जाते हैं.
जब किसी ऐप्लिकेशन पर पेज पर अचानक दिखने वाला विज्ञापन दिखता है, तो उपयोगकर्ता के पास यह चुनने का विकल्प होता है कि वह
विज्ञापन पर टैप करके डेस्टिनेशन पर जाए या उसे बंद करके ऐप्लिकेशन पर वापस जाए.
केस स्टडी.
इस गाइड में बताया गया है कि Android ऐप्लिकेशन में पेज पर अचानक दिखने वाले विज्ञापनों को कैसे इंटिग्रेट किया जाता है.
ज़रूरी शर्तें
Google Mobile Ads SDK 19.7.0 या इसके बाद का वर्शन.
अपने ऐप्लिकेशन बनाते और टेस्ट करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों
के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें. ऐसा न करने पर आपका खाता निलंबित किया जा सकता है.
टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका यह है कि आप Android पर अचानक दिखने वाले विज्ञापनों के लिए, हमारे खास टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करें:
ca-app-pub-3940256099942544/1033173712
इसे खास तौर पर हर अनुरोध के लिए टेस्ट विज्ञापन दिखाने के लिए कॉन्फ़िगर किया गया है. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, अपने ऐप्लिकेशन में इसका इस्तेमाल किया जा सकता है. बस अपना ऐप्लिकेशन
पब्लिश करने से पहले, यह पक्का कर लें कि आपने इसे अपने विज्ञापन यूनिट आईडी से बदल दिया हो.
Mobile Ads SDK के टेस्ट विज्ञापनों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, विज्ञापन टेस्ट करें देखें.
विज्ञापन लोड करें
पेज पर अचानक दिखने वाले विज्ञापन को लोड करने के लिए, InterstitialAd
स्टैटिक
load() तरीके का इस्तेमाल करें और लोड किया गया विज्ञापन
या कोई संभावित गड़बड़ी पाने के लिए,
InterstitialAdLoadCallback पास करें. ध्यान दें कि दूसरे फ़ॉर्मैट लोड कॉलबैक की तरह,
InterstitialAdLoadCallback,
LoadAdError का इस्तेमाल करके, ज़्यादा फ़िडेलिटी की गड़बड़ी की जानकारी देता है.
FullScreenContentCallback, आपके
InterstitialAd को दिखाने से जुड़े इवेंट मैनेज करता है. InterstitialAd को दिखाने से पहले, कॉलबैक को
इस पर सेट करना न भूलें:
पेज पर अचानक दिखने वाले विज्ञापन, ऐप्लिकेशन के चलने के दौरान थोड़ी-थोड़ी देर में रुकते हुए दिखाए जाने चाहिए.
गेम के अलग-अलग लेवल के बीच में विज्ञापन दिखाना बेहतर होता है या उपयोगकर्ता के किसी टास्क को पूरा करने के बाद.
पेज पर अचानक दिखने वाले विज्ञापन को दिखाने के लिए, show() तरीके का इस्तेमाल करें.
इस बात पर विचार करें कि पेज पर अचानक दिखने वाले विज्ञापन आपके ऐप्लिकेशन के लिए सही तरह के विज्ञापन हैं या नहीं.
अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन, ऐसे ऐप्लिकेशन में सबसे अच्छी तरह काम करते हैं जिनमें नैचुरल ट्रांज़िशन पॉइंट होते हैं.
ऐप्लिकेशन में किसी टास्क के खत्म होने पर, एक पॉइंट बन जाता है. जैसे, कोई इमेज शेयर करना या गेम का कोई लेवल पूरा करना. उपयोगकर्ता को उम्मीद होती है कि उसे थोड़ी देर के लिए काम करना होगा. इस वजह से, पेज पर अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन को दिखाना आसान होता है. इससे, उपयोगकर्ता के अनुभव पर भी कोई असर नहीं पड़ता. अपने ऐप्लिकेशन के वर्कफ़्लो में, इस बात का ध्यान रखें कि आपको
अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन किस पॉइंट पर दिखाए जाएंगे. साथ ही, यह भी ध्यान रखें कि उपयोगकर्ता का जवाब देने की कितनी संभावना है.
पेज पर अचानक दिखने वाले विज्ञापन दिखाते समय उस कार्रवाई को रोकना न भूलें.
अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन कई तरह के होते हैं: टेक्स्ट, इमेज,
वीडियो वगैरह. यह पक्का करना ज़रूरी है कि जब आपका ऐप्लिकेशन पेज पर अचानक दिखने वाले
विज्ञापन दिखाता है, तो वह कुछ संसाधनों का इस्तेमाल भी निलंबित कर देता है, ताकि विज्ञापन उनका फ़ायदा ले सके. उदाहरण के लिए, पेज पर अचानक दिखने वाले विज्ञापन को दिखाने के लिए कॉल करते समय, पक्का करें कि आपने ऐप्लिकेशन से बनाए जा रहे सभी ऑडियो आउटपुट को रोक दिया हो.
कॉन्टेंट लोड होने में लगने वाला समय कम करें.
जिस तरह यह पक्का करना ज़रूरी है कि पेज पर अचानक दिखने वाले विज्ञापन
सही समय पर दिखें, साथ ही यह पक्का करना भी ज़रूरी है कि उपयोगकर्ता
को उनके लोड होने तक इंतज़ार न करना पड़े. कॉल करने से पहले
load() को कॉल करके विज्ञापन लोड करें
show() से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन में, पेज पर अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन पहले से ही पूरी तरह लोड हो.
उपयोगकर्ताओं को विज्ञापनों से न भरें.
आपके ऐप्लिकेशन में पेज पर अचानक दिखने वाले विज्ञापनों की फ़्रीक्वेंसी बढ़ाने से आय बढ़ाने का अच्छा तरीका लग सकता है. हालांकि, इससे उपयोगकर्ता अनुभव में गिरावट आ सकती है
और क्लिक मिलने की दर (सीटीआर) कम हो सकती है. पक्का करें कि लोगों को इतनी ज़्यादा परेशानी न हो कि
वे आपके ऐप्लिकेशन के इस्तेमाल का आनंद न ले पाएं.
सोर्स कोड
MyActivity.java
/*
* Copyright (C) 2013 Google, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.gms.example.interstitialexample;
import android.annotation.SuppressLint;
import android.os.Bundle;
import android.os.CountDownTimer;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.Button;
import android.widget.PopupMenu;
import android.widget.TextView;
import android.widget.Toast;
import androidx.annotation.NonNull;
import com.google.android.gms.ads.AdError;
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.FullScreenContentCallback;
import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
import java.util.concurrent.atomic.AtomicBoolean;
/**
* Main Activity. Inflates main activity xml.
*/
@SuppressLint("SetTextI18n")
public class MyActivity extends AppCompatActivity {
private static final long GAME_LENGTH_MILLISECONDS = 3000;
private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";
private static final String TAG = "MyActivity";
private final AtomicBoolean isMobileAdsInitializeCalled = new AtomicBoolean(false);
private GoogleMobileAdsConsentManager googleMobileAdsConsentManager;
private InterstitialAd interstitialAd;
private CountDownTimer countDownTimer;
private Button retryButton;
private boolean gamePaused;
private boolean gameOver;
private boolean adIsLoading;
private long timerMilliseconds;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_my);
// Log the Mobile Ads SDK version.
Log.d(TAG, "Google Mobile Ads SDK Version: " + MobileAds.getVersion());
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {}
});
googleMobileAdsConsentManager =
GoogleMobileAdsConsentManager.getInstance(getApplicationContext());
googleMobileAdsConsentManager.gatherConsent(
this,
consentError -> {
if (consentError != null) {
// Consent not obtained in current session.
Log.w(
TAG,
String.format(
"%s: %s",
consentError.getErrorCode(),
consentError.getMessage()));
}
startGame();
if (googleMobileAdsConsentManager.canRequestAds()) {
initializeMobileAdsSdk();
}
if (googleMobileAdsConsentManager.isPrivacyOptionsRequired()) {
// Regenerate the options menu to include a privacy setting.
invalidateOptionsMenu();
}
});
// This sample attempts to load ads using consent obtained in the previous session.
if (googleMobileAdsConsentManager.canRequestAds()) {
initializeMobileAdsSdk();
}
// Create the "retry" button, which tries to show an interstitial between game plays.
retryButton = findViewById(R.id.retry_button);
retryButton.setVisibility(View.INVISIBLE);
retryButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
showInterstitial();
}
});
}
public void loadAd() {
// Request a new ad if one isn't already loaded.
if (adIsLoading || interstitialAd != null) {
return;
}
adIsLoading = true;
AdRequest adRequest = new AdRequest.Builder().build();
InterstitialAd.load(
this,
AD_UNIT_ID,
adRequest,
new InterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
// The mInterstitialAd reference will be null until
// an ad is loaded.
MyActivity.this.interstitialAd = interstitialAd;
adIsLoading = false;
Log.i(TAG, "onAdLoaded");
Toast.makeText(MyActivity.this, "onAdLoaded()", Toast.LENGTH_SHORT).show();
interstitialAd.setFullScreenContentCallback(
new FullScreenContentCallback() {
@Override
public void onAdDismissedFullScreenContent() {
// Called when fullscreen content is dismissed.
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
Log.d("TAG", "The ad was dismissed.");
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when fullscreen content failed to show.
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
Log.d("TAG", "The ad failed to show.");
}
@Override
public void onAdShowedFullScreenContent() {
// Called when fullscreen content is shown.
Log.d("TAG", "The ad was shown.");
}
});
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
// Handle the error
Log.i(TAG, loadAdError.getMessage());
interstitialAd = null;
adIsLoading = false;
String error =
String.format(
"domain: %s, code: %d, message: %s",
loadAdError.getDomain(), loadAdError.getCode(), loadAdError.getMessage());
Toast.makeText(
MyActivity.this, "onAdFailedToLoad() with error: " + error, Toast.LENGTH_SHORT)
.show();
}
});
}
private void createTimer(final long milliseconds) {
// Create the game timer, which counts down to the end of the level
// and shows the "retry" button.
if (countDownTimer != null) {
countDownTimer.cancel();
}
final TextView textView = findViewById(R.id.timer);
countDownTimer = new CountDownTimer(milliseconds, 50) {
@Override
public void onTick(long millisUnitFinished) {
timerMilliseconds = millisUnitFinished;
textView.setText("seconds remaining: " + ((millisUnitFinished / 1000) + 1));
}
@Override
public void onFinish() {
gameOver = true;
textView.setText("done!");
retryButton.setVisibility(View.VISIBLE);
}
};
countDownTimer.start();
}
@Override
public void onResume() {
// Start or resume the game.
super.onResume();
resumeGame();
}
@Override
public void onPause() {
super.onPause();
pauseGame();
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.action_menu, menu);
MenuItem moreMenu = menu.findItem(R.id.action_more);
moreMenu.setVisible(googleMobileAdsConsentManager.isPrivacyOptionsRequired());
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
View menuItemView = findViewById(item.getItemId());
PopupMenu popup = new PopupMenu(this, menuItemView);
popup.getMenuInflater().inflate(R.menu.popup_menu, popup.getMenu());
popup.show();
popup.setOnMenuItemClickListener(
popupMenuItem -> {
if (popupMenuItem.getItemId() == R.id.privacy_settings) {
pauseGame();
// Handle changes to user consent.
googleMobileAdsConsentManager.showPrivacyOptionsForm(
this,
formError -> {
if (formError != null) {
Toast.makeText(
this,
formError.getMessage(),
Toast.LENGTH_SHORT).show();
}
resumeGame();
});
return true;
}
return false;
});
return super.onOptionsItemSelected(item);
}
private void showInterstitial() {
// Show the ad if it's ready. Otherwise restart the game.
if (interstitialAd != null) {
interstitialAd.show(this);
} else {
startGame();
if (googleMobileAdsConsentManager.canRequestAds()) {
loadAd();
}
}
}
private void startGame() {
// Hide the button, and kick off the timer.
retryButton.setVisibility(View.INVISIBLE);
createTimer(GAME_LENGTH_MILLISECONDS);
gamePaused = false;
gameOver = false;
}
private void resumeGame() {
if (gameOver || !gamePaused) {
return;
}
// Create a new timer for the correct length.
gamePaused = false;
createTimer(timerMilliseconds);
}
private void pauseGame() {
if (gameOver || gamePaused) {
return;
}
countDownTimer.cancel();
gamePaused = true;
}
private void initializeMobileAdsSdk() {
if (isMobileAdsInitializeCalled.getAndSet(true)) {
return;
}
// Initialize the Mobile Ads SDK.
MobileAds.initialize(
this,
new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
// Load an ad.
loadAd();
}
});
}
}
MainActivity.kt
package com.google.android.gms.example.interstitialexample
import android.os.Bundle
import android.os.CountDownTimer
import android.util.Log
import android.view.Menu
import android.view.MenuItem
import android.view.View
import android.widget.PopupMenu
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.ads.*
import com.google.android.gms.ads.interstitial.InterstitialAd
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback
import com.google.android.gms.example.interstitialexample.databinding.ActivityMainBinding
import java.util.concurrent.atomic.AtomicBoolean
const val GAME_LENGTH_MILLISECONDS = 3000L
const val AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712"
class MainActivity : AppCompatActivity() {
private val isMobileAdsInitializeCalled = AtomicBoolean(false)
private lateinit var binding: ActivityMainBinding
private lateinit var googleMobileAdsConsentManager: GoogleMobileAdsConsentManager
private var interstitialAd: InterstitialAd? = null
private var countdownTimer: CountDownTimer? = null
private var gamePaused = false
private var gameOver = false
private var adIsLoading: Boolean = false
private var timerMilliseconds = 0L
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
binding = ActivityMainBinding.inflate(layoutInflater)
val view = binding.root
setContentView(view)
// Log the Mobile Ads SDK version.
Log.d(TAG, "Google Mobile Ads SDK Version: " + MobileAds.getVersion())
googleMobileAdsConsentManager = GoogleMobileAdsConsentManager.getInstance(this)
googleMobileAdsConsentManager.gatherConsent(this) { consentError ->
if (consentError != null) {
// Consent not obtained in current session.
Log.w(TAG, "${consentError.errorCode}: ${consentError.message}")
}
// Kick off the first play of the "game".
startGame()
if (googleMobileAdsConsentManager.canRequestAds) {
initializeMobileAdsSdk()
}
if (googleMobileAdsConsentManager.isPrivacyOptionsRequired) {
// Regenerate the options menu to include a privacy setting.
invalidateOptionsMenu()
}
}
// This sample attempts to load ads using consent obtained in the previous session.
if (googleMobileAdsConsentManager.canRequestAds) {
initializeMobileAdsSdk()
}
// Set your test devices. Check your logcat output for the hashed device ID to
// get test ads on a physical device. e.g.
// "Use RequestConfiguration.Builder().setTestDeviceIds(Arrays.asList("ABCDEF012345"))
// to get test ads on this device."
MobileAds.setRequestConfiguration(
RequestConfiguration.Builder().setTestDeviceIds(listOf("ABCDEF012345")).build()
)
// Create the "retry" button, which triggers an interstitial between game plays.
binding.retryButton.visibility = View.INVISIBLE
binding.retryButton.setOnClickListener { showInterstitial() }
}
override fun onCreateOptionsMenu(menu: Menu?): Boolean {
menuInflater.inflate(R.menu.action_menu, menu)
menu?.findItem(R.id.action_more)?.apply {
isVisible = googleMobileAdsConsentManager.isPrivacyOptionsRequired
}
return super.onCreateOptionsMenu(menu)
}
override fun onOptionsItemSelected(item: MenuItem): Boolean {
val menuItemView = findViewById<View>(item.itemId)
val activity = this
PopupMenu(this, menuItemView).apply {
menuInflater.inflate(R.menu.popup_menu, menu)
show()
setOnMenuItemClickListener { popupMenuItem ->
when (popupMenuItem.itemId) {
R.id.privacy_settings -> {
pauseGame()
// Handle changes to user consent.
googleMobileAdsConsentManager.showPrivacyOptionsForm(activity) { formError ->
if (formError != null) {
Toast.makeText(activity, formError.message, Toast.LENGTH_SHORT).show()
}
resumeGame()
}
true
}
// Handle other branches here.
else -> false
}
}
return super.onOptionsItemSelected(item)
}
}
private fun loadAd() {
// Request a new ad if one isn't already loaded.
if (adIsLoading || interstitialAd != null) {
return
}
adIsLoading = true
val adRequest = AdRequest.Builder().build()
InterstitialAd.load(
this,
AD_UNIT_ID,
adRequest,
object : InterstitialAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError.message)
interstitialAd = null
adIsLoading = false
val error =
"domain: ${adError.domain}, code: ${adError.code}, " + "message: ${adError.message}"
Toast.makeText(
this@MainActivity,
"onAdFailedToLoad() with error $error",
Toast.LENGTH_SHORT
)
.show()
}
override fun onAdLoaded(ad: InterstitialAd) {
Log.d(TAG, "Ad was loaded.")
interstitialAd = ad
adIsLoading = false
Toast.makeText(this@MainActivity, "onAdLoaded()", Toast.LENGTH_SHORT).show()
}
}
)
}
// Create the game timer, which counts down to the end of the level
// and shows the "retry" button.
private fun createTimer(milliseconds: Long) {
countdownTimer?.cancel()
countdownTimer =
object : CountDownTimer(milliseconds, 50) {
override fun onTick(millisUntilFinished: Long) {
timerMilliseconds = millisUntilFinished
binding.timer.text = "seconds remaining: ${ millisUntilFinished / 1000 + 1 }"
}
override fun onFinish() {
gameOver = true
binding.timer.text = "done!"
binding.retryButton.visibility = View.VISIBLE
}
}
countdownTimer?.start()
}
// Show the ad if it's ready. Otherwise restart the game.
private fun showInterstitial() {
if (interstitialAd != null) {
interstitialAd?.fullScreenContentCallback =
object : FullScreenContentCallback() {
override fun onAdDismissedFullScreenContent() {
Log.d(TAG, "Ad was dismissed.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
interstitialAd = null
}
override fun onAdFailedToShowFullScreenContent(adError: AdError) {
Log.d(TAG, "Ad failed to show.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
interstitialAd = null
}
override fun onAdShowedFullScreenContent() {
Log.d(TAG, "Ad showed fullscreen content.")
// Called when ad is dismissed.
}
}
interstitialAd?.show(this)
} else {
startGame()
if (googleMobileAdsConsentManager.canRequestAds) {
loadAd()
}
}
}
// Hide the button, and kick off the timer.
private fun startGame() {
binding.retryButton.visibility = View.INVISIBLE
createTimer(GAME_LENGTH_MILLISECONDS)
gamePaused = false
gameOver = false
}
private fun pauseGame() {
if (gameOver || gamePaused) {
return
}
countdownTimer?.cancel()
gamePaused = true
}
private fun resumeGame() {
if (gameOver || !gamePaused) {
return
}
createTimer(timerMilliseconds)
gamePaused = true
}
private fun initializeMobileAdsSdk() {
if (isMobileAdsInitializeCalled.getAndSet(true)) {
return
}
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this) { initializationStatus ->
// Load an ad.
loadAd()
}
}
// Resume the game if it's in progress.
public override fun onResume() {
super.onResume()
resumeGame()
}
public override fun onPause() {
super.onPause()
pauseGame()
}
private companion object {
const val TAG = "MainActivity"
}
}
GitHub पर उदाहरण
पेज पर अचानक दिखने वाले विज्ञापनों का उदाहरण:
Java |
Kotlin