अपने Android प्रोजेक्ट में AdMob के साथ शुरुआत करें

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

यदि आपने अभी तक नहीं किया है, तो AdMob, Firebase और Google Analytics का एक साथ उपयोग करने के सभी लाभों के बारे में जानें।

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

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

  • सुनिश्चित करें कि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है:

    • यदि आप एक नया Firebase प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण कार्यप्रवाह के दौरान Google Analytics को सक्षम करें।

    • यदि आपके पास कोई मौजूदा Firebase प्रोजेक्ट है जिसमें Google Analytics सक्षम नहीं है, तो आप Google Analytics को अपनी > प्रोजेक्ट सेटिंग के एकीकरण टैब से सक्षम कर सकते हैं।

चरण 1: अपना ऐप अपने AdMob खाते में सेट करें

  1. अपने ऐप को AdMob ऐप के रूप में पंजीकृत करें।

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

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

    आपको अपने ऐप में मोबाइल विज्ञापन एसडीके जोड़ने के लिए कहा जाएगा। इस गाइड में बाद में इस कार्य के लिए विस्तृत निर्देश प्राप्त करें।

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

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

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

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

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

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

चरण 2: अपनी AdMob ऐप आईडी को अपनी AndroidManifest.xml फ़ाइल में जोड़ें

नीचे दिखाए गए अनुसार <meta-data> टैग जोड़कर अपने ऐप की AndroidManifest.xml फ़ाइल में अपना 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="ADMOB_APP_ID"/>
    </application>
</manifest>

चरण 3: मोबाइल विज्ञापन SDK जोड़ें और प्रारंभ करें

  1. Google मोबाइल विज्ञापन SDK की निर्भरता को अपने ऐप्लिकेशन के मॉड्यूल (ऐप्लिकेशन-स्तर) build.gradle फ़ाइल में जोड़ें:

    implementation 'com.google.android.gms:play-services-ads:21.0.0'
    
  2. विज्ञापन लोड करने से पहले MobileAds.initialize() विधि को कॉल करें।

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

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

    Java

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

    Kotlin+KTX

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

चरण 4: उपयोगकर्ता मीट्रिक और विश्लेषण डेटा देखें

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

ध्यान दें कि एआरपीयू और एआरपीपीयू मेट्रिक्स को बेहतर ढंग से प्रस्तुत करने के लिए, हो सकता है कि आप इन मीट्रिक्स के लिए आय गणना में ecommerce_purchase नामक एनालिटिक्स कस्टम इवेंट का डेटा शामिल करना चाहें ( जानें कि कैसे )।

चरण 5: (वैकल्पिक) Google Analytics और Firebase की अधिक सुविधाओं का उपयोग करें

ऐप मुद्रीकरण और उपयोगकर्ता जुड़ाव को बेहतर बनाने के लिए अधिक अवसरों और सुविधाओं का लाभ उठाएं:

  • Google Analytics के लिए Firebase SDK जोड़ें और उसका उपयोग करें

  • अपने ऐप्लिकेशन में अन्य Firebase उत्पादों का उपयोग करें

    Google Analytics के लिए Firebase SDK जोड़ने के बाद, अपने ऐप्लिकेशन में विज्ञापनों को अनुकूलित करने के लिए अन्य Firebase उत्पादों का उपयोग करें।

    • रिमोट कॉन्फिग आपको असीमित दैनिक सक्रिय उपयोगकर्ताओं के लिए बिना किसी कीमत के, ऐप अपडेट प्रकाशित किए बिना अपने ऐप के व्यवहार और उपस्थिति को बदलने में सक्षम बनाता है।

    • A/B परीक्षण आपको अपने ऐप्लिकेशन के UI, सुविधाओं, या सहभागिता अभियानों में परिवर्तनों का परीक्षण करने की शक्ति देता है ताकि यह पता लगाया जा सके कि क्या वे परिवर्तनों को व्यापक रूप से लागू करने से पहले आपकी प्रमुख मीट्रिक (जैसे आय और प्रतिधारण) पर प्रभाव डालते हैं।

आरंभ करने के लिए, AdMob ऐप्स के साथ Google Analytics और Firebase का उपयोग करने के लिए मार्गदर्शिका पर जाएं।

चरण 6: अपने ऐप में लागू करने के लिए एक विज्ञापन प्रारूप चुनें

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

डिवाइस स्क्रीन के ऊपर या नीचे दिखाई देने वाले आयताकार विज्ञापन

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

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

मध्य

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

किसी ऐप के निष्पादन के प्रवाह में स्वाभाविक विराम पर मध्यवर्ती विज्ञापनों का सबसे अच्छा उपयोग किया जाता है, जैसे कि किसी गेम के स्तरों के बीच या किसी कार्य के पूरा होने के बाद।

मध्यवर्ती विज्ञापन लागू करें

देशी

अनुकूलन योग्य विज्ञापन जो आपके ऐप के रंगरूप से मेल खाते हैं

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

स्थानीय उन्नत विज्ञापन लागू करें

पुरस्कृत

ऐसे विज्ञापन जो उपयोगकर्ताओं को लघु वीडियो देखने और चलने योग्य विज्ञापनों और सर्वेक्षणों के साथ सहभागिता करने के लिए पुरस्कृत करते हैं

पुरस्कृत (या "इनाम-आधारित") विज्ञापन फ्री-टू-प्ले उपयोगकर्ताओं से कमाई करने में मदद कर सकते हैं।

पुरस्कृत विज्ञापन लागू करें पुरस्कृत विज्ञापन लागू करें (नए एपीआई)
,

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

यदि आपने अभी तक नहीं किया है, तो AdMob, Firebase और Google Analytics का एक साथ उपयोग करने के सभी लाभों के बारे में जानें।

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

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

  • सुनिश्चित करें कि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है:

    • यदि आप एक नया Firebase प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण कार्यप्रवाह के दौरान Google Analytics को सक्षम करें।

    • यदि आपके पास कोई मौजूदा Firebase प्रोजेक्ट है जिसमें Google Analytics सक्षम नहीं है, तो आप Google Analytics को अपनी > प्रोजेक्ट सेटिंग के एकीकरण टैब से सक्षम कर सकते हैं।

चरण 1: अपना ऐप अपने AdMob खाते में सेट करें

  1. अपने ऐप को AdMob ऐप के रूप में पंजीकृत करें।

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

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

    आपको अपने ऐप में मोबाइल विज्ञापन एसडीके जोड़ने के लिए कहा जाएगा। इस गाइड में बाद में इस कार्य के लिए विस्तृत निर्देश प्राप्त करें।

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

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

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

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

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

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

चरण 2: अपनी AdMob ऐप आईडी को अपनी AndroidManifest.xml फ़ाइल में जोड़ें

नीचे दिखाए गए अनुसार <meta-data> टैग जोड़कर अपने ऐप की AndroidManifest.xml फ़ाइल में अपना 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="ADMOB_APP_ID"/>
    </application>
</manifest>

चरण 3: मोबाइल विज्ञापन SDK जोड़ें और प्रारंभ करें

  1. Google मोबाइल विज्ञापन SDK की निर्भरता को अपने ऐप्लिकेशन के मॉड्यूल (ऐप्लिकेशन-स्तर) build.gradle फ़ाइल में जोड़ें:

    implementation 'com.google.android.gms:play-services-ads:21.0.0'
    
  2. विज्ञापन लोड करने से पहले MobileAds.initialize() विधि को कॉल करें।

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

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

    Java

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

    Kotlin+KTX

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

चरण 4: उपयोगकर्ता मीट्रिक और विश्लेषण डेटा देखें

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

ध्यान दें कि एआरपीयू और एआरपीपीयू मेट्रिक्स को बेहतर ढंग से प्रस्तुत करने के लिए, हो सकता है कि आप इन मीट्रिक्स के लिए आय गणना में ecommerce_purchase नामक एनालिटिक्स कस्टम इवेंट का डेटा शामिल करना चाहें ( जानें कि कैसे )।

चरण 5: (वैकल्पिक) Google Analytics और Firebase की अधिक सुविधाओं का उपयोग करें

ऐप मुद्रीकरण और उपयोगकर्ता जुड़ाव को बेहतर बनाने के लिए अधिक अवसरों और सुविधाओं का लाभ उठाएं:

  • Google Analytics के लिए Firebase SDK जोड़ें और उसका उपयोग करें

  • अपने ऐप्लिकेशन में अन्य Firebase उत्पादों का उपयोग करें

    Google Analytics के लिए Firebase SDK जोड़ने के बाद, अपने ऐप्लिकेशन में विज्ञापनों को अनुकूलित करने के लिए अन्य Firebase उत्पादों का उपयोग करें।

    • रिमोट कॉन्फिग आपको असीमित दैनिक सक्रिय उपयोगकर्ताओं के लिए बिना किसी कीमत के, ऐप अपडेट प्रकाशित किए बिना अपने ऐप के व्यवहार और उपस्थिति को बदलने में सक्षम बनाता है।

    • A/B परीक्षण आपको अपने ऐप्लिकेशन के UI, सुविधाओं, या सहभागिता अभियानों में परिवर्तनों का परीक्षण करने की शक्ति देता है ताकि यह पता लगाया जा सके कि क्या वे परिवर्तनों को व्यापक रूप से लागू करने से पहले आपकी प्रमुख मीट्रिक (जैसे आय और प्रतिधारण) पर प्रभाव डालते हैं।

आरंभ करने के लिए, AdMob ऐप्स के साथ Google Analytics और Firebase का उपयोग करने के लिए मार्गदर्शिका पर जाएं।

चरण 6: अपने ऐप में लागू करने के लिए एक विज्ञापन प्रारूप चुनें

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

डिवाइस स्क्रीन के ऊपर या नीचे दिखाई देने वाले आयताकार विज्ञापन

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

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

मध्य

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

किसी ऐप के निष्पादन के प्रवाह में स्वाभाविक विराम पर मध्यवर्ती विज्ञापनों का सबसे अच्छा उपयोग किया जाता है, जैसे कि किसी गेम के स्तरों के बीच या किसी कार्य के पूरा होने के बाद।

मध्यवर्ती विज्ञापन लागू करें

देशी

अनुकूलन योग्य विज्ञापन जो आपके ऐप के रंगरूप से मेल खाते हैं

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

स्थानीय उन्नत विज्ञापन लागू करें

पुरस्कृत

ऐसे विज्ञापन जो उपयोगकर्ताओं को लघु वीडियो देखने और चलने योग्य विज्ञापनों और सर्वेक्षणों के साथ सहभागिता करने के लिए पुरस्कृत करते हैं

पुरस्कृत (या "इनाम-आधारित") विज्ञापन फ्री-टू-प्ले उपयोगकर्ताओं से कमाई करने में मदद कर सकते हैं।

पुरस्कृत विज्ञापन लागू करें पुरस्कृत विज्ञापन लागू करें (नए एपीआई)