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

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

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

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

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

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

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

    • एसडीके का वर्शन कम से कम 24 या इसके बाद का हो
    • एसडीके का कंपाइल वर्शन कम से कम 35 या इसके बाद का हो

अपने AdMob खाते में ऐप्लिकेशन सेट अप करना

अपने ऐप्लिकेशन को AdMob के ज़रिए विज्ञापन दिखाने वाले ऐप्लिकेशन के तौर पर रजिस्टर करने के लिए, यह तरीका अपनाएं:

  1. AdMob खाते मेंसाइन इन करें या उसके लिए साइन अप करें.

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

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

  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")

    Groovy

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

    Groovy

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

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

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

    <manifest>
  <application>
    <!-- Sample AdMob 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 को अपने AdMob ऐप्लिकेशन आईडी से बदलें. टेस्टिंग के दौरान, पिछले उदाहरण में दिखाया गया सैंपल ऐप्लिकेशन आईडी इस्तेमाल करें.

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

    Missing application ID.

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

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

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

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

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

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

शुरू होने पर, Google Mobile Ads SDK (Legacy) या मीडिएशन पार्टनर के एसडीके विज्ञापन पहले से लोड कर सकते हैं. अगर आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके या स्विट्ज़रलैंड के उपयोगकर्ताओं से सहमति लेनी है, तो अनुरोध के हिसाब से फ़्लैग सेट करें. जैसे, 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();

Kotlin

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

विज्ञापन फ़ॉर्मैट चुनना

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

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

बैनर विज्ञापन लागू करना

मध्यवर्ती

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

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

मूल भाषा वाला

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

नेटिव विज्ञापन लागू करना

इनाम दिया गया

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

इनाम वाले विज्ञापन लागू करना

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

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

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

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

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

ऐप्लिकेशन काम कर रहा है

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

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

अन्य संसाधन

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