शुरू करें

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

किसी ऐप्लिकेशन में Google Mobile Ads 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")

    ग्रूवी

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

    ग्रूवी

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.9.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 अनुमति का एलान अपने-आप कर देता है. साथ ही, जब भी विज्ञापन आईडी उपलब्ध होता है, तब यह उसे ऐक्सेस कर पाता है.

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

    <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 को शुरू करें.

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