शुरू करें

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

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

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

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

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

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

अपने 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")

    ग्रूवी

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

    ग्रूवी

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

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

  4. अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, AdMob के वेब इंटरफ़ेस में पहचाने गए AdMob ऐप्लिकेशन का आईडी जोड़ें. ऐसा करने के लिए, android:name="com.google.android.gms.ads.APPLICATION_ID" के साथ <meta-data> टैग जोड़ें. 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    किसी असल ऐप्लिकेशन में, सैंपल ऐप्लिकेशन आईडी को अपने असल AdMob ऐप्लिकेशन आईडी से बदलें. अगर Hello World ऐप्लिकेशन में SDK टूल को सिर्फ़ प्रयोग के तौर पर इस्तेमाल किया जा रहा है, तो इस सैंपल आईडी का इस्तेमाल किया जा सकता है.

    साथ ही, यह भी ध्यान रखें कि <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

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

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

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

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

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

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

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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

अन्य संसाधन

GitHub पर Google मोबाइल विज्ञापन डेटा स्टोर करने की जगह में इस एपीआई से ऑफ़र किए जाने वाले अलग-अलग विज्ञापन फ़ॉर्मैट को इस्तेमाल करने का तरीका बताया गया है.