अपने Android प्रोजेक्ट में AdMob का इस्तेमाल करना

यह क्विकस्टार्ट गाइड उन पब्लिशर और डेवलपर के लिए है जिन्हें Firebase की मदद से बनाए गए ऐप्लिकेशन से कमाई करने के लिए, AdMob का इस्तेमाल करना है. अगर आपको अपने ऐप्लिकेशन में Firebase को शामिल नहीं करना है, तो स्टैंडअलोन AdMob गाइड पर जाएं.

अगर आपने अब तक AdMob, Firebase, और Google Analytics का एक साथ इस्तेमाल नहीं किया है, तो इसके फ़ायदों के बारे में जानें.

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

• अगर आपके पास पहले से Firebase प्रोजेक्ट और Firebase ऐप्लिकेशन नहीं है, तो Firebase के शुरुआती निर्देश का पालन करें: अपने Android प्रोजेक्ट में Firebase जोड़ें.

• पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू हो:

  • अगर आपको नया Firebase प्रोजेक्ट बनाना है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics को चालू करें.

  • अगर आपके पास कोई मौजूदा Firebase प्रोजेक्ट है, जिसमें Google Analytics चालू नहीं है, तो Google Analytics को चालू किया जा सकता है. इसके लिए, settings > प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब पर जाएं.

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

1. अपने ऐप्लिकेशन को AdMob ऐप्लिकेशन के तौर पर रजिस्टर करें.

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

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

   आपको अपने ऐप्लिकेशन में Mobile Ads SDK टूल जोड़ने के लिए कहा जाएगा. इस टास्क को पूरा करने के लिए, इस गाइड में आगे दिए गए निर्देशों को पढ़ें.

2. अपने AdMob ऐप्लिकेशन को Firebase ऐप्लिकेशन से लिंक करें.

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

   अपने AdMob खाते के ऐप्लिकेशन डैशबोर्ड में जाकर, ये दो चरण पूरे करें:

   1. उपयोगकर्ता मेट्रिक चालू करें, ताकि AdMob आपके AdMob खाते में, चुने गए आंकड़ों के डेटा को प्रोसेस और दिखा सके. AdMob ऐप्लिकेशन को Firebase से लिंक करने के लिए भी यह सेटिंग ज़रूरी है.

   2. अपने AdMob ऐप्लिकेशन को अपने मौजूदा Firebase प्रोजेक्ट और Firebase ऐप्लिकेशन से लिंक करें.

      पक्का करें कि आपने वही पैकेज नाम डाला हो जो आपने Firebase ऐप्लिकेशन के लिए डाला था. अपने Firebase ऐप्लिकेशन के पैकेज का नाम ढूंढने के लिए, settings > प्रोजेक्ट सेटिंग के आपके ऐप्लिकेशन कार्ड पर जाएं.

दूसरा चरण: AndroidManifest.xml फ़ाइल में अपना AdMob ऐप्लिकेशन आईडी जोड़ें

अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, AdMob ऐप्लिकेशन आईडी जोड़ें. इसके लिए, यहां दिखाए गए तरीके से <meta-data> टैग जोड़ें.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

तीसरा चरण: Mobile Ads SDK टूल जोड़ें और उसे शुरू करें

1. Google Mobile Ads SDK टूल की डिपेंडेंसी को अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में जोड़ें:

   implementation("com.google.android.gms:play-services-ads:25.5.0")
   

2. विज्ञापनों को लोड करने से पहले, MobileAds.initialize() तरीके को कॉल करें.

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

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

   Kotlin

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       // ...
       MobileAds.initialize(this)
   }
   MainActivity.kt

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // ...
       MobileAds.initialize(this);
   }
   MainActivity.java

चौथा चरण: उपयोगकर्ता मेट्रिक और Analytics डेटा देखना

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

• अपने AdMob खाते (होम या ऐप्लिकेशन डैशबोर्ड) के उपयोगकर्ता मेट्रिक कार्ड में, इकट्ठा किए गए आंकड़ों के डेटा से मिली उपयोगकर्ता मेट्रिक देखी जा सकती हैं. जैसे, सेशन कितनी देर चला, एआरपीयू, और उपयोगकर्ता को अपने साथ जोड़े रखना.

• Firebase कंसोल के Analytics डैशबोर्ड में, एग्रीगेट किए गए आंकड़े और अहम मेट्रिक की खास जानकारी देखी जा सकती है. अगर आपने Google Analytics के लिए Firebase SDK टूल जोड़ा है, तो आपके पास विज्ञापन कैंपेन के लिए कन्वर्ज़न मार्क करने और कस्टम ऑडियंस बनाने का विकल्प भी है. इसके लिए, Firebase कंसोल पर जाएं.

ध्यान दें कि एआरपीयू और एआरपीपीयू मेट्रिक को बेहतर तरीके से दिखाने के लिए, आपको इन मेट्रिक के रेवेन्यू का हिसाब लगाने में, ecommerce_purchase नाम के Analytics कस्टम इवेंट का डेटा शामिल करना पड़ सकता है. इसका तरीका जानें.

पांचवां चरण: (ज़रूरी नहीं) Google Analytics और Firebase की ज़्यादा सुविधाओं का इस्तेमाल करना

ऐप्लिकेशन से होने वाली कमाई और उपयोगकर्ता की दिलचस्पी बढ़ाने के लिए, ज़्यादा अवसरों और सुविधाओं का फ़ायदा लें:

• Google Analytics के लिए Firebase SDK टूल जोड़ना और उसका इस्तेमाल करना

  • अपने ऐप्लिकेशन में कस्टम इवेंट लॉगिंग लागू करें.

  • कस्टम विज्ञापन कैंपेन के लिए कन्वर्ज़न मार्क करें.

  • एआरपीयू और एआरपीपीयू मेट्रिक के लिए, रेवेन्यू के हिसाब में ecommerce_purchase इवेंट का डेटा शामिल करें.

  ज़्यादा जानने के लिए, AdMob ऐप्लिकेशन के साथ Google Analytics और Firebase का इस्तेमाल करने की गाइड पर जाएं.

• अपने ऐप्लिकेशन में Firebase के अन्य प्रॉडक्ट इस्तेमाल करना

  Google Analytics के लिए Firebase SDK टूल जोड़ने के बाद, अपने ऐप्लिकेशन में विज्ञापनों को ऑप्टिमाइज़ करने के लिए, Firebase के अन्य प्रॉडक्ट इस्तेमाल करें.

  • Remote Config की मदद से, ऐप्लिकेशन के काम करने के तरीके और लुक में बदलाव किया जा सकता है. इसके लिए, ऐप्लिकेशन का अपडेट पब्लिश करने की ज़रूरत नहीं होती.

  • A/B Testing की मदद से, अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई), सुविधाओं या यूज़र ऐक्टिविटी बढ़ाने वाले कैंपेन में किए गए बदलावों को टेस्ट किया जा सकता है. इससे आपको यह जानने में मदद मिलती है कि इन बदलावों को बड़े पैमाने पर लागू करने से पहले, क्या इनसे आपकी मुख्य मेट्रिक (जैसे, रेवेन्यू और उपयोगकर्ता को जोड़े रखना) पर कोई असर पड़ता है.

• अपने ऐप्लिकेशन से विज्ञापन दिखाकर होने वाली कमाई को ऑप्टिमाइज़ करना

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

  • नए विज्ञापन फ़ॉर्मैट को इस्तेमाल करने के लिए टेस्ट करना (खास जानकारी | लागू करना).

  • विज्ञापनों की फ़्रीक्वेंसी ऑप्टिमाइज़ करना (खास जानकारी | लागू करने का तरीका).

छठा चरण: अपने ऐप्लिकेशन में इस्तेमाल करने के लिए कोई विज्ञापन फ़ॉर्मैट चुनना

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

बैनर

आयताकार विज्ञापन, जो डिवाइस की स्क्रीन पर सबसे ऊपर या सबसे नीचे दिखते हैं

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

मध्यवर्ती

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

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

स्थानीय

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

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

इनाम पाने वाले

ऐसे विज्ञापन जिनमें इनाम पाने के लिए उपयोगकर्ताओं को छोटे-छोटे वीडियो देखने होते हैं. इसके अलावा, उन्हें 'गेम खेलने देने वाले विज्ञापन' से इंटरैक्ट करना होता है या फिर सर्वे में हिस्सा लेना होता है

इनाम वाले (या "इनाम पर आधारित") विज्ञापनों की मदद से, मुफ़्त में खेले जाने वाले गेम के उपयोगकर्ताओं से कमाई की जा सकती है.