यह गाइड उन पब्लिशर के लिए है जो Google Mobile Ads SDK का इस्तेमाल करके, ऐप्लिकेशन ओपन विज्ञापन इंटिग्रेट कर रहे हैं.
ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन, एक खास तरह का विज्ञापन फ़ॉर्मैट है. यह उन पब्लिशर के लिए है जो अपने ऐप्लिकेशन की लोड स्क्रीन से कमाई करना चाहते हैं. ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापनों को किसी भी समय बंद किया जा सकता है. इन्हें इस तरह से डिज़ाइन किया गया है कि जब उपयोगकर्ता आपके ऐप्लिकेशन को फ़ोरग्राउंड में लाएं, तब ये विज्ञापन दिखें.
ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापनों में, स्क्रीन के एक छोटे से हिस्से पर ब्रैंड का नाम अपने-आप दिखता है. इससे उपयोगकर्ताओं को पता चलता है कि वे आपके ऐप्लिकेशन का इस्तेमाल कर रहे हैं. ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन कैसा दिखता है, इसका एक उदाहरण यहां दिया गया है:
ज़रूरी शर्तें
- शुरुआती निर्देश पढ़ें.
हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करें
अपने ऐप्लिकेशन बनाते और उनकी टेस्टिंग करते समय, पक्का करें कि आपने लाइव और प्रोडक्शन विज्ञापनों के बजाय, टेस्ट विज्ञापनों का इस्तेमाल किया हो. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.
टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका यह है कि ऐप्लिकेशन को खोलने पर दिखने वाले विज्ञापनों के लिए, हमारी टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करें:
ca-app-pub-3940256099942544/9257395921
इसे खास तौर पर हर अनुरोध के लिए टेस्ट विज्ञापन दिखाने के लिए कॉन्फ़िगर किया गया है. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, अपने ऐप्लिकेशन में इसका इस्तेमाल किया जा सकता है. हालांकि, ऐप्लिकेशन पब्लिश करने से पहले, इसे अपनी विज्ञापन यूनिट के आईडी से बदलना न भूलें.
Google Mobile Ads SDK के टेस्ट विज्ञापन किस तरह काम करते हैं, इस बारे में ज़्यादा जानने के लिए, टेस्ट विज्ञापन चालू करना लेख पढ़ें.
Application क्लास को बढ़ाना
Application
क्लास को बढ़ाने वाली नई क्लास बनाएं. इससे ऐप्लिकेशन की स्थिति से जुड़े विज्ञापनों को मैनेज करने का एक ऐसा तरीका मिलता है जो लाइफ़साइकल के बारे में जानकारी रखता है. यह सिर्फ़ एक Activity
के बजाय, ज़्यादा जानकारी देता है:
Java
public class MyApplication extends Application
implements ActivityLifecycleCallbacks, DefaultLifecycleObserver {
private AppOpenAdManager appOpenAdManager;
private Activity currentActivity;
@Override
public void onCreate() {
super.onCreate();
this.registerActivityLifecycleCallbacks(this);
ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
appOpenAdManager = new AppOpenAdManager();
}
Kotlin
class MyApplication :
MultiDexApplication(), Application.ActivityLifecycleCallbacks, DefaultLifecycleObserver {
private lateinit var appOpenAdManager: AppOpenAdManager
private var currentActivity: Activity? = null
override fun onCreate() {
super<MultiDexApplication>.onCreate()
registerActivityLifecycleCallbacks(this)
ProcessLifecycleOwner.get().lifecycle.addObserver(this)
appOpenAdManager = AppOpenAdManager()
}
इसके बाद, अपनी AndroidManifest.xml
में यह कोड जोड़ें:
<!-- TODO: Update to reference your actual package name. -->
<application
android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>
उपयोगिता कॉम्पोनेंट लागू करना
आपका विज्ञापन तुरंत दिखना चाहिए. इसलिए, विज्ञापन दिखाने से पहले उसे लोड कर लेना सबसे अच्छा होता है. इससे, जैसे ही उपयोगकर्ता आपके ऐप्लिकेशन में आएगा वैसे ही आपके पास विज्ञापन दिखाने का विकल्प होगा.
ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन लोड करने और दिखाने से जुड़े काम को शामिल करने के लिए, यूटिलिटी कॉम्पोनेंट AppOpenAdManager
लागू करें:
Java
private class AppOpenAdManager {
private static final String LOG_TAG = "AppOpenAdManager";
private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/9257395921";
private AppOpenAd appOpenAd = null;
private boolean isLoadingAd = false;
private boolean isShowingAd = false;
/** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
private long loadTime = 0;
/** Constructor. */
public AppOpenAdManager() {}
Kotlin
private inner class AppOpenAdManager {
private var appOpenAd: AppOpenAd? = null
private var isLoadingAd = false
var isShowingAd = false
/** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
private var loadTime: Long = 0
AppOpenAdManager
का इस्तेमाल करने के लिए, सिंगलटन MyApplication
इंस्टेंस पर सार्वजनिक रैपर के तरीकों को कॉल करें. Application
क्लास, बाकी कोड के साथ इंटरफ़ेस करती है. साथ ही, विज्ञापन को लोड करने और दिखाने का काम मैनेजर को सौंपती है.
विज्ञापन लोड करना
अगला चरण, loadAd()
तरीका लागू करना और विज्ञापन लोड होने से जुड़े कॉलबैक को मैनेज करना है.
Java
Kotlin
AD_UNIT_ID को अपनी विज्ञापन यूनिट के आईडी से बदलें.
विज्ञापन दिखाएं
ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन को लागू करने का सबसे सामान्य तरीका यह है कि ऐप्लिकेशन लॉन्च होने के समय, ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन दिखाया जाए. अगर विज्ञापन तैयार नहीं है, तो ऐप्लिकेशन का कॉन्टेंट दिखाना शुरू करें. साथ ही, ऐप्लिकेशन खोलने पर दिखने वाले अगले विज्ञापन के लिए, पहले से ही कोई विज्ञापन लोड करके रखें. लागू करने के उदाहरणों के लिए, ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन के लिए सलाह देखें.
नीचे दिए गए कोड में, विज्ञापन को दिखाया जाता है और फिर से लोड किया जाता है:
Java
public void showAdIfAvailable(
@NonNull final Activity activity,
@NonNull OnShowAdCompleteListener onShowAdCompleteListener) {
// If the app open ad is already showing, do not show the ad again.
if (isShowingAd) {
Log.d(TAG, "The app open ad is already showing.");
return;
}
// If the app open ad is not available yet, invoke the callback then load the ad.
if (appOpenAd == null) {
Log.d(TAG, "The app open ad is not ready yet.");
onShowAdCompleteListener.onShowAdComplete();
// Load an ad.
return;
}
isShowingAd = true;
appOpenAd.show(activity);
}
Kotlin
fun showAdIfAvailable(activity: Activity, onShowAdCompleteListener: OnShowAdCompleteListener) {
// If the app open ad is already showing, do not show the ad again.
if (isShowingAd) {
Log.d(TAG, "The app open ad is already showing.")
return
}
// If the app open ad is not available yet, invoke the callback then load the ad.
if (appOpenAd == null) {
Log.d(TAG, "The app open ad is not ready yet.")
onShowAdCompleteListener.onShowAdComplete()
// Load an ad.
return
}
isShowingAd = true
appOpenAd?.show(activity)
}
FullScreenContentCallback सेट करना
FullScreenContentCallback
, AppOpenAd
को दिखाने से जुड़े इवेंट मैनेज करता है. AppOpenAd
दिखाने से पहले, पक्का करें कि आपने कॉलबैक सेट किया हो:
Java
appOpenAd.setFullScreenContentCallback(
new FullScreenContentCallback() {
@Override
public void onAdDismissedFullScreenContent() {
// Called when full screen content is dismissed.
Log.d(TAG, "Ad dismissed fullscreen content.");
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
appOpenAd = null;
isShowingAd = false;
onShowAdCompleteListener.onShowAdComplete();
// Load an ad.
}
@Override
public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
// Called when full screen content failed to show.
Log.d(TAG, adError.getMessage());
appOpenAd = null;
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
isShowingAd = false;
onShowAdCompleteListener.onShowAdComplete();
// Load an ad.
}
@Override
public void onAdShowedFullScreenContent() {
Log.d(TAG, "Ad showed fullscreen content.");
}
@Override
public void onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "The ad recorded an impression.");
}
@Override
public void onAdClicked() {
// Called when ad is clicked.
Log.d(TAG, "The ad was clicked.");
}
});
Kotlin
appOpenAd?.fullScreenContentCallback =
object : FullScreenContentCallback() {
override fun onAdDismissedFullScreenContent() {
// Called when full screen content is dismissed.
Log.d(TAG, "Ad dismissed fullscreen content.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
appOpenAd = null
isShowingAd = false
onShowAdCompleteListener.onShowAdComplete()
// Load an ad.
}
override fun onAdFailedToShowFullScreenContent(adError: AdError) {
// Called when full screen content failed to show.
Log.d(TAG, adError.message)
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
appOpenAd = null
isShowingAd = false
onShowAdCompleteListener.onShowAdComplete()
// Load an ad.
}
override fun onAdShowedFullScreenContent() {
Log.d(TAG, "Ad showed fullscreen content.")
}
override fun onAdImpression() {
// Called when an impression is recorded for an ad.
Log.d(TAG, "The ad recorded an impression.")
}
override fun onAdClicked() {
// Called when ad is clicked.
Log.d(TAG, "The ad was clicked.")
}
}
विज्ञापन की समयसीमा खत्म होने की तारीख पर ध्यान दें
यह पक्का करने के लिए कि आपने कोई ऐसा विज्ञापन न दिखाया हो जिसकी समयसीमा खत्म हो गई है, AppOpenAdManager
में एक ऐसा तरीका जोड़ें जो यह जांच करे कि आपके विज्ञापन रेफ़रंस को लोड हुए कितना समय हो गया है. इसके बाद, उस तरीके का इस्तेमाल करके देखें कि विज्ञापन अब भी मान्य है या नहीं.
Java
/** Check if ad was loaded more than n hours ago. */
private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
long dateDifference = (new Date()).getTime() - loadTime;
long numMilliSecondsPerHour = 3600000;
return (dateDifference < (numMilliSecondsPerHour * numHours));
}
/** Check if ad exists and can be shown. */
private boolean isAdAvailable() {
// For time interval details, see: https://support.google.com/admob/answer/9341964
return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
}
Kotlin
/** Check if ad was loaded more than n hours ago. */
private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
val dateDifference: Long = Date().time - loadTime
val numMilliSecondsPerHour: Long = 3600000
return dateDifference < numMilliSecondsPerHour * numHours
}
/** Check if ad exists and can be shown. */
private fun isAdAvailable(): Boolean {
// For time interval details, see: https://support.google.com/admob/answer/9341964
return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
}
मौजूदा गतिविधि को ट्रैक करना
विज्ञापन दिखाने के लिए, आपको Activity
का कॉन्टेक्स्ट देना होगा. सबसे नई गतिविधि को ट्रैक करने के लिए, Application.ActivityLifecycleCallbacks
के लिए रजिस्टर करें और इसे लागू करें.
Java
@Override
public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {}
@Override
public void onActivityStarted(@NonNull Activity activity) {
// An ad activity is started when an ad is showing, which could be AdActivity class from Google
// SDK or another activity class implemented by a third party mediation partner. Updating the
// currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
// one that shows the ad.
if (!appOpenAdManager.isShowingAd) {
currentActivity = activity;
}
}
@Override
public void onActivityResumed(@NonNull Activity activity) {}
@Override
public void onActivityPaused(@NonNull Activity activity) {}
@Override
public void onActivityStopped(@NonNull Activity activity) {}
@Override
public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}
@Override
public void onActivityDestroyed(@NonNull Activity activity) {}
Kotlin
override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}
override fun onActivityStarted(activity: Activity) {
// An ad activity is started when an ad is showing, which could be AdActivity class from Google
// SDK or another activity class implemented by a third party mediation partner. Updating the
// currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
// one that shows the ad.
if (!appOpenAdManager.isShowingAd) {
currentActivity = activity
}
}
override fun onActivityResumed(activity: Activity) {}
override fun onActivityPaused(activity: Activity) {}
override fun onActivityStopped(activity: Activity) {}
override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
override fun onActivityDestroyed(activity: Activity) {}
registerActivityLifecycleCallbacks
आपको सभी Activity
इवेंट सुनने की सुविधा देता है. गतिविधियों के शुरू और बंद होने की जानकारी सुनकर, मौजूदा Activity
के रेफ़रंस को ट्रैक किया जा सकता है. इसके बाद, इसका इस्तेमाल ऐप्लिकेशन ओपन विज्ञापन दिखाने के लिए किया जा सकता है.
ऐप्लिकेशन को फ़ोरग्राउंड में लाने वाले इवेंट को मॉनिटर करने की अनुमति
ऐप्लिकेशन के फ़ोरग्राउंड इवेंट सुनने के लिए, यह तरीका अपनाएं:
अपनी gradle फ़ाइल में लाइब्रेरी जोड़ना
ऐप्लिकेशन के फ़ोरग्राउंड होने के इवेंट की सूचना पाने के लिए, आपको DefaultLifecycleObserver
रजिस्टर करना होगा. ऐप्लिकेशन-लेवल की build फ़ाइल में इसकी डिपेंडेंसी जोड़ें:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:24.5.0") implementation("androidx.lifecycle:lifecycle-process:2.8.3") }
ग्रूवी
dependencies { implementation 'com.google.android.gms:play-services-ads:24.5.0' implementation 'androidx.lifecycle:lifecycle-process:2.8.3' }
लाइफ़साइकल ऑब्ज़र्वर इंटरफ़ेस लागू करना
DefaultLifecycleObserver
इंटरफ़ेस को लागू करके, फ़ोरग्राउंडिंग इवेंट सुने जा सकते हैं.
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन दिखाने के लिए, onStart()
को लागू करें.
Java
@Override
public void onStart(@NonNull LifecycleOwner owner) {
DefaultLifecycleObserver.super.onStart(owner);
// Show the ad (if available) when the app moves to foreground.
appOpenAdManager.showAdIfAvailable(currentActivity);
}
Kotlin
override fun onStart(owner: LifecycleOwner) {
super.onStart(owner)
currentActivity?.let {
// Show the ad (if available) when the app moves to foreground.
appOpenAdManager.showAdIfAvailable(it)
}
}
कोल्ड स्टार्ट और लोडिंग स्क्रीन
अब तक के दस्तावेज़ में यह माना गया है कि ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन सिर्फ़ तब दिखाए जाते हैं, जब उपयोगकर्ता आपके ऐप्लिकेशन को फ़ोरग्राउंड करता है. ऐसा तब होता है, जब ऐप्लिकेशन को मेमोरी में निलंबित कर दिया जाता है. "कोल्ड स्टार्ट" तब होते हैं, जब आपका ऐप्लिकेशन लॉन्च किया जाता है, लेकिन उसे मेमोरी में पहले निलंबित नहीं किया गया था.
कोल्ड स्टार्ट का एक उदाहरण यह है कि जब कोई उपयोगकर्ता पहली बार आपका ऐप्लिकेशन खोलता है. कोल्ड स्टार्ट के दौरान, आपके पास पहले से लोड किया गया ऐसा ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन नहीं होगा जिसे तुरंत दिखाया जा सके. विज्ञापन का अनुरोध करने और विज्ञापन मिलने के बीच में लगने वाले समय की वजह से, ऐसा हो सकता है कि उपयोगकर्ता आपके ऐप्लिकेशन का इस्तेमाल कुछ समय के लिए कर पाएं. इसके बाद, उन्हें अचानक कोई ऐसा विज्ञापन दिखे जो उनके काम का न हो. ऐसा नहीं करना चाहिए, क्योंकि इससे उपयोगकर्ता अनुभव खराब होता है.
कोल्ड स्टार्ट के दौरान ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापनों का इस्तेमाल करने का सबसे अच्छा तरीका यह है कि आप गेम या ऐप्लिकेशन की ऐसेट लोड करने के लिए, लोडिंग स्क्रीन का इस्तेमाल करें. साथ ही, विज्ञापन सिर्फ़ लोडिंग स्क्रीन पर दिखाएं. अगर आपका ऐप्लिकेशन लोड हो गया है और उपयोगकर्ता को ऐप्लिकेशन के मुख्य कॉन्टेंट पर भेज दिया गया है, तो विज्ञापन न दिखाएं.
सबसे सही तरीके
ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापनों की मदद से, ऐप्लिकेशन के पहली बार लॉन्च होने और ऐप्लिकेशन स्विच करने के दौरान, ऐप्लिकेशन की लोडिंग स्क्रीन से कमाई की जा सकती है. हालांकि, सबसे सही तरीकों को ध्यान में रखना ज़रूरी है, ताकि आपके उपयोगकर्ता आपके ऐप्लिकेशन का आनंद ले सकें. सबसे सही तरीका यह है कि:
- उपयोगकर्ताओं के कुछ बार ऐप्लिकेशन इस्तेमाल करने के बाद, उन्हें पहली बार ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन दिखाएं.
- ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन, उन समयों के दौरान दिखाएं जब उपयोगकर्ता आपके ऐप्लिकेशन के लोड होने का इंतज़ार कर रहे हों.
- अगर आपने ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन के नीचे लोड होने वाली स्क्रीन जोड़ी है और विज्ञापन बंद होने से पहले ही लोड होने वाली स्क्रीन लोड हो जाती है, तो हो सकता है कि आपको
onAdDismissedFullScreenContent()
तरीके से लोड होने वाली स्क्रीन को बंद करना पड़े.
GitHub पर मौजूद उदाहरण
अगले चरण
इन विषयों के बारे में जानें: