लर्निंग शुरू करें

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

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

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

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

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

    • 19 या उससे ज़्यादा का minSdkVersion
    • 28 या उससे ज़्यादा का compileSdkVersion

अपने AdMob खाते में ऐप्लिकेशन सेट अप करना

नीचे दिए गए चरणों को पूरा करके अपने ऐप्लिकेशन को AdMob ऐप्लिकेशन के तौर पर रजिस्टर करें:

  1. किसी AdMob खाते में साइन इन करें या साइन अप करें.

  2. AdMob के साथ अपना ऐप्लिकेशन रजिस्टर करें. इस चरण को एक खास AdMob ऐप्लिकेशन आईडी के साथ AdMob ऐप्लिकेशन बनाया जाता है. इस गाइड को बाद में इस गाइड की ज़रूरत पड़ेगी.

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

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

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

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.0.0'
    }
    
  3. अपनी ऐप्लिकेशन'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> टैग न जोड़ पाने पर, मैसेज के साथ क्रैश हो जाता है:

    The Google Mobile Ads SDK was initialized incorrectly.
    

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

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

    जो ऐप्लिकेशन Google मोबाइल विज्ञापन SDK के वर्शन 20.3.0 या इससे पहले के वर्शन का इस्तेमाल कर रहे हैं और Android 13 को टारगेट कर रहे हैं उनके लिए, आपको Google मोबाइल विज्ञापन 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 मोबाइल विज्ञापन SDK टूल शुरू करना

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

MobileAds.initialize()को कॉल करने पर, विज्ञापन 'Google मोबाइल विज्ञापन SDK टूल' या मीडिएशन पार्टनर SDK टूल से पहले से लोड किए जा सकते हैं. अगर आपको यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं की सहमति लेनी है, तो खास तौर पर अनुरोध के लिए फ़्लैग सेट करें, जैसे कि tagForChildDirectedTreatment या tag_for_under_age_of_consent. इसके अलावा, विज्ञापनों को लोड करने से पहले कार्रवाई करें, तो पक्का करें कि आपने Google मोबाइल विज्ञापन SDK टूल शुरू करने से पहले ऐसा किया हो.

किसी ऐक्टिविटी में initialize() तरीके को कॉल करने का तरीका यहां दिया गया है:

mainActivity (उदाहरण)

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

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

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

मध्यवर्ती

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

पेज पर अचानक दिखने वाले विज्ञापनों को लागू करना

नेटिव विज्ञापन

आपके ऐप्लिकेशन के लुक और बनावट से मेल खाने वाले विज्ञापन. आप यह तय कर सकते हैं कि उन्हें कैसे और कहां रखा जाए, ताकि लेआउट आपके ऐप्लिकेशन के डिज़ाइन के मुताबिक हो.

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

इनाम दिया गया

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

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

अन्य संसाधन

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