Google Mobile Ads SDK सेट अप करना

प्लेटफ़ॉर्म चुनें: Android नई सुविधा Android iOS Unity Flutter

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

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

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

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

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

    • SDK टूल का कम से कम वर्शन 23 या इसके बाद का हो
    • SDK टूल का कंपाइल वर्शन 35 या इसके बाद का हो

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

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

    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 के लिए डिपेंडेंसी जोड़ें:

    Kotlin

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

    Groovy

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

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

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

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

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

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

    <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 को शुरू करना

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

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

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

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

यहां, किसी गतिविधि में बैकग्राउंड थ्रेड पर 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 अब इंपोर्ट हो गया है. अब विज्ञापन लागू किया जा सकता है. Ad Manager में कई तरह के विज्ञापन फ़ॉर्मैट उपलब्ध हैं. इसलिए, ऐसा फ़ॉर्मैट चुनें जो आपके ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही हो.

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

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

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

इनाम दिया गया

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

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

पुरस्कृत मध्यवर्ती विज्ञापन

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

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

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

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

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

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

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

अन्य संसाधन

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