शुरू करें

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

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

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

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

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

    • SDK टूल का वर्शन कम से कम 21 या इसके बाद का होना चाहिए
    • 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:23.6.0")
}

    ग्रूवी

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

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

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

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

    Missing application ID.

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

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

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

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

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

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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

अन्य संसाधन

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