Google Mobile Ads SDK (लेगसी) सेट अप करना

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

Google Mobile Ads SDK (Legacy) को किसी ऐप्लिकेशन में इंटिग्रेट करना, विज्ञापन दिखाने और रेवेन्यू जनरेट करने की दिशा में पहला कदम है. एसडीके को इंटिग्रेट करने के बाद, कोई विज्ञापन फ़ॉर्मैट (जैसे, नेटिव या इनाम वाला वीडियो) चुना जा सकता है. इसके बाद, उसे लागू करने के लिए यह तरीका अपनाएं.

शुरू करने से पहले

अपना ऐप्लिकेशन तैयार करने के लिए, यहां दिए गए सेक्शन में बताया गया तरीका अपनाएं.

ऐप्लिकेशन के लिए ज़रूरी शर्तें

• पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल में इन वैल्यू का इस्तेमाल किया गया हो:

  • एसडीके का वर्शन कम से कम 24 या इसके बाद का होना चाहिए
  • SDK टूल का कंपाइल वर्शन 35 या इससे ज़्यादा होना चाहिए

अपना ऐप्लिकेशन कॉन्फ़िगर करना

1. अपनी Gradle सेटिंग फ़ाइल में, Google की Maven रिपॉज़िटरी और Maven सेंट्रल रिपॉज़िटरी को शामिल करें:

   Kotlin

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include(":app")

   ग्रूवी

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include ':app'

2. अपने ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, Google Mobile Ads SDK (Legacy) के लिए डिपेंडेंसी जोड़ें:

   Kotlin

   dependencies {
     implementation("com.google.android.gms:play-services-ads:25.5.0")
   }

   ग्रूवी

   dependencies {
     implementation 'com.google.android.gms:play-services-ads:25.5.0'
   }

3. अभी सिंक करें पर क्लिक करें. सिंक करने के बारे में ज़्यादा जानने के लिए, प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करना लेख पढ़ें.

4. अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, Ad Manager ऐप्लिकेशन आईडी जोड़ें. यह आईडी, Ad Manager के वेब इंटरफ़ेस में दिखता है. इसके लिए, android:name="com.google.android.gms.ads.APPLICATION_ID" के साथ <meta-data> टैग जोड़ें. Ad Manager के वेब इंटरफ़ेस में, अपना ऐप्लिकेशन आईडी देखा जा सकता है. android:value के लिए, अपना Ad Manager ऐप्लिकेशन आईडी डालें. इसके लिए, कोटेशन मार्क का इस्तेमाल करें.

   <manifest>
     <application>
       <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
       <meta-data
           android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="SAMPLE_APP_ID"/>
     </application>
   </manifest>
   

   SAMPLE_APP_ID को अपने Ad Manager ऐप्लिकेशन आईडी से बदलें. टेस्टिंग के दौरान, पिछले उदाहरण में दिखाए गए सैंपल ऐप्लिकेशन आईडी का इस्तेमाल करें.

   यह भी ध्यान रखें कि अगर <meta-data> टैग को ठीक उसी तरह नहीं जोड़ा जाता है जैसा दिखाया गया है, तो ऐप्लिकेशन क्रैश हो जाता है और यह मैसेज दिखता है:

   Missing application ID.
   

   (ज़रूरी नहीं) पिछले वर्शन के लिए, AD_ID अनुमति का एलान करें, ताकि वे Android 13 के साथ काम कर सकें.

   अगर आपका ऐप्लिकेशन Google Mobile Ads SDK (Legacy) के वर्शन 20.4.0 या इसके बाद के वर्शन का इस्तेमाल करता है, तो इस चरण को छोड़ा जा सकता है. ऐसा इसलिए, क्योंकि SDK टूल, com.google.android.gms.permission.AD_ID अनुमति का एलान अपने-आप करता है. साथ ही, विज्ञापन आईडी उपलब्ध होने पर उसे ऐक्सेस कर सकता है.

   अगर आपके ऐप्लिकेशन Google Mobile Ads SDK (Legacy) के 20.3.0 या इससे पहले के वर्शन का इस्तेमाल करते हैं और Android 13 को टारगेट करते हैं, तो आपको AndroidManifest.xml फ़ाइल में com.google.android.gms.permission.AD_ID अनुमति जोड़नी होगी. ऐसा करने पर ही, Google Mobile Ads SDK (Legacy) विज्ञापन आईडी को ऐक्सेस कर पाएगा:

   <manifest>
    <application>
      <meta-data
          android:name="com.google.android.gms.ads.APPLICATION_ID"
          android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
   
      <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
      <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
   
    </application>
   </manifest>

   com.google.android.gms.permission.AD_ID अनुमति के एलान के बारे में ज़्यादा जानने के लिए, Play Console का यह लेख पढ़ें. इसमें, अनुमति को बंद करने का तरीका भी बताया गया है.

Google Mobile Ads SDK (Legacy) को शुरू करना

विज्ञापनों को लोड करने से पहले, MobileAds.initialize() को कॉल करके Google Mobile Ads SDK (Legacy) को शुरू करें.

यह तरीका, SDK टूल को शुरू करता है और Google Mobile Ads SDK (Legacy) और अडैप्टर, दोनों के शुरू होने के बाद या 30 सेकंड के टाइम आउट के बाद, पूरा होने पर काम आने वाले लिसनर को कॉल करता है. यह काम सिर्फ़ एक बार करना होता है. आम तौर पर, ऐप्लिकेशन लॉन्च करते समय.

अगर मीडिएशन का इस्तेमाल किया जा रहा है, तो विज्ञापन लोड करने से पहले, कंप्लीशन हैंडलर के कॉल होने तक इंतज़ार करें. इससे यह पक्का होता है कि सभी मीडिएशन अडैप्टर शुरू हो गए हैं.

शुरू होने पर, Google Mobile Ads SDK (Legacy) या मीडिएशन पार्टनर के SDK टूल, विज्ञापनों को पहले से लोड कर सकते हैं. अगर आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूनाइटेड किंगडम (यूके) या स्विट्ज़रलैंड के उपयोगकर्ताओं से सहमति लेनी है, तो अनुरोध के हिसाब से कोई भी फ़्लैग सेट करें. जैसे, setTagForChildDirectedTreatment() या setTagForUnderAgeOfConsent(), या विज्ञापन लोड करने से पहले कोई कार्रवाई करें. साथ ही, पक्का करें कि आपने Google Mobile Ads SDK (Legacy) को शुरू करने से पहले ऐसा किया हो.

यहां किसी ऐक्टिविटी में बैकग्राउंड थ्रेड पर, initialize() तरीके को कॉल करने का उदाहरण दिया गया है:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}
MyActivity.kt

कोई विज्ञापन फ़ॉर्मैट चुनें

Google Mobile Ads SDK (Legacy) अब इंपोर्ट हो गया है और विज्ञापन लागू करने के लिए तैयार है. Ad Manager में कई अलग-अलग विज्ञापन फ़ॉर्मैट उपलब्ध हैं. इसलिए, आपके पास अपने ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही फ़ॉर्मैट चुनने का विकल्प होता है.

बैनर

बैनर विज्ञापन यूनिट में रेक्टैंगल के आकार वाले विज्ञापन दिखाए जाते हैं. ये विज्ञापन, ऐप्लिकेशन के लेआउट का कुछ हिस्सा घेरते हैं. वे तय समय अवधि के बाद अपने-आप रीफ़्रेश हो सकते हैं. इसका मतलब है कि उपयोगकर्ताओं को समय-समय पर एक नया विज्ञापन दिखेगा, भले ही वे आपके ऐप्लिकेशन में एक ही स्क्रीन का इस्तेमाल करें. साथ ही, ये सबसे आसानी से लागू किए जा सकने वाले विज्ञापन फ़ॉर्मैट भी हैं.

बैनर विज्ञापनों का इस्तेमाल करना

मध्यवर्ती

इंटरस्टीशियल विज्ञापन यूनिट, आपके ऐप्लिकेशन में पूरे पेज को कवर करने वाले विज्ञापन दिखाती हैं. इन्हें अपने ऐप्लिकेशन के इंटरफ़ेस में इस तरह सेट करें कि वे तय समय और ट्रांज़िशन के दौरान दिखें. जैसे, किसी गेमिंग ऐप्लिकेशन में लेवल पूरा होने के बाद.

अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापनों का इस्तेमाल करना

मूल भाषा वाला

नेटिव विज्ञापन ऐसे विज्ञापन होते हैं जिनमें हेडलाइन और कॉल-टू-ऐक्शन जैसी ऐसेट को अपने ऐप्लिकेशन में दिखाने के तरीके को पसंद के मुताबिक बनाया जा सकता है. विज्ञापन को खुद स्टाइल करके, नैचुरल और बिना रुकावट वाले विज्ञापन प्रज़ेंटेशन बनाए जा सकते हैं. इससे उपयोगकर्ताओं को बेहतर अनुभव मिल सकता है.

Google Ad Manager में नेटिव विज्ञापनों को लागू करने के दो तरीके हैं: नेटिव स्टाइल और कस्टम रेंडरिंग की मदद से स्टैंडर्ड नेटिव विज्ञापन.

नेटिव स्टाइल को नेटिव विज्ञापनों को लागू करने की प्रोसेस को आसान बनाने के लिए डिज़ाइन किया गया है. अगर आप इस फ़ॉर्मैट का इस्तेमाल पहली बार कर रहे हैं, तो यह आपके लिए एक बेहतरीन विकल्प है. कस्टम रेंडरिंग को इस तरह से डिज़ाइन किया गया है कि आपको प्रज़ेंटेशन बनाने में ज़्यादा से ज़्यादा आज़ादी मिले.

नेटिव स्टाइल लागू करना नेटिव विज्ञापन (कस्टम रेंडरिंग) लागू करना

इनाम दिया गया

इनाम वाली विज्ञापन यूनिट की मदद से, उपयोगकर्ता गेम खेल सकते हैं, सर्वे में हिस्सा ले सकते हैं या वीडियो देख सकते हैं. इससे उन्हें इन-ऐप्लिकेशन इनाम मिलते हैं. जैसे, कॉइन, ज़्यादा लाइफ़ या पॉइंट. अलग-अलग विज्ञापन यूनिट के लिए, अलग-अलग इनाम तय किए जा सकते हैं. साथ ही, यह भी बताया जा सकता है कि उपयोगकर्ताओं को मिलने वाले इनाम की वैल्यू और आइटम क्या हैं.

इनाम वाले विज्ञापन दिखाना

इनाम वाला इंटरस्टीशियल विज्ञापन

इनाम वाले इंटरस्टीशियल विज्ञापन, नए तरह से तैयार किए गए विज्ञापन फ़ॉर्मैट हैं. इनकी मदद से, ऐप्लिकेशन में स्वाभाविक तौर पर हुए ट्रांज़िशन के दौरान दिखने वाले विज्ञापनों के लिए, सिक्के या खेलने के कुछ और मौके जैसे इनाम दिए जाते हैं.

इनाम वाले विज्ञापनों के उलट, उपयोगकर्ताओं को इनाम वाला इंटरस्टीशियल विज्ञापन देखने के लिए, शामिल होना ज़रूरी नहीं होता.

इनाम वाले विज्ञापनों में शामिल होने के प्रॉम्प्ट के बजाय, इनाम वाले इंटरस्टीशियल विज्ञापनों के लिए एक इंट्रो स्क्रीन की ज़रूरत होती है जिस पर इनाम से जुड़ी सूचना दिखती है. अगर उपयोगकर्ता चाहें, तो वे बाहर होने का विकल्प चुन सकते हैं.

इनाम वाले इंटरस्टीशियल विज्ञापनों को लागू करना

ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन

ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन, एक ऐसा विज्ञापन फ़ॉर्मैट है जो तब दिखता है, जब उपयोगकर्ता आपके ऐप्लिकेशन को खोलते हैं या उस पर वापस आते हैं. यह विज्ञापन, लोड हो रही स्क्रीन को ओवरले करता है.

ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन लागू करना

अन्य संसाधन

GitHub पर मौजूद Google Mobile Ads रिपॉज़िटरी से पता चलता है कि इस एपीआई से मिलने वाले अलग-अलग विज्ञापन फ़ॉर्मैट का इस्तेमाल कैसे किया जाता है.