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

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

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

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

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

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

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

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

अपने ऐप्लिकेशन को, AdMob ऐप्लिकेशन के तौर पर रजिस्टर करें. इसके लिए, यह तरीका अपनाएं:

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

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

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

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

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

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.4.0'
    }
    
  3. अपने ऐप्लिकेशन कीAndroidManifest.xml फ़ाइल में AdMob ऐप्लिकेशन आईडी (AdMob यूज़र इंटरफ़ेस (यूआई) से पहचाना गया) जोड़ें. ऐसा करने के लिए, <meta-data> टैग को android:name="com.google.android.gms.ads.APPLICATION_ID" के साथ जोड़ें. 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 ऐप्लिकेशन आईडी का इस्तेमाल करें, न कि ऊपर दिए गए ऐप्लिकेशन आईडी का. अगर आपको नमस्ते वर्ल्ड ऐप्लिकेशन में 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 शुरू करें

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

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

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

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

मध्यवर्ती

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

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

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

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

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

इनाम दिया गया

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

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

दूसरे संसाधन

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