शुरू करें

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

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

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

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

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

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

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

  1. प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, अपने buildscript और allprojects सेक्शन में Google की Maven डेटा स्टोर करने की जगह और Maven सेंट्रल का डेटा स्टोर करने की जगह शामिल करें:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. अपने मॉड्यूल की ऐप्लिकेशन-लेवल gradle फ़ाइल में, Google Mobile Ads SDK के लिए डिपेंडेंसी जोड़ें, आम तौर पर app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    असली ऐप्लिकेशन में, सैंपल ऐप्लिकेशन आईडी को अपने असलAd Manager ऐप्लिकेशन आईडी से बदलें. अगर 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 शुरू करने से पहले ऐसा करें.

यहां दिए गए उदाहरण में बताया गया है कि किसी गतिविधि में 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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

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

    MobileAds.initialize(this) {}
  }
}

कोई विज्ञापन फ़ॉर्मैट चुनें

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

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

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

मध्यवर्ती

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

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

नेटिव लेआउट

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

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

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

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

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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

ज़्यादा रिसॉर्स

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