शुरू करें

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

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

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

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

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

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

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

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

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

    ग्रूवी

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

    ग्रूवी

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.5.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="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    /<network_code>~<application_id> की जगह अपना Ad Manager ऐप्लिकेशन आईडी डालें. जांच करते समय, पिछले उदाहरण में दिखाया गया सैंपल ऐप्लिकेशन आईडी इस्तेमाल करें.

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

    Missing application ID.

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

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

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

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