अपने iOS प्रोजेक्ट में AdMob का इस्तेमाल शुरू करें

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

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

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

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

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

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

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

  ध्यान दें: अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसे जोड़ें. Google Analytics के लिए Firebase SDK टूल जोड़ने के
  फ़ायदों के बारे में ज़्यादा जानें.

पहला चरण: अपने 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 ऐप्लिकेशन का बंडल आईडी ढूंढने के लिए, > प्रोजेक्ट सेटिंग में मौजूद आपके ऐप्लिकेशन कार्ड पर जाएं.

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

अपने ऐप्लिकेशन की Info.plist फ़ाइल में, GADApplicationIdentifier कुंजी जोड़ें. इसकी स्ट्रिंग वैल्यू, आपके AdMob ऐप्लिकेशन आईडी की वैल्यू होनी चाहिए.

अहम जानकारी: यह चरण, Google Mobile Ads SDK के 7.42.0 वर्शन के बाद से ज़रूरी है. अगर आपने यह Info.plist एंट्री नहीं जोड़ी, तो आपका ऐप्लिकेशन क्रैश हो जाएगा और आपको यह मैसेज दिखेगा: "The Google Mobile Ads SDK was initialized incorrectly."

इस बदलाव को प्रोग्राम के ज़रिए किया जा सकता है:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

इसके अलावा, प्रॉपर्टी की सूची के एडिटर में जाकर भी इसमें बदलाव किया जा सकता है:

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

1. अपने प्रोजेक्ट के Podfile में, Google Mobile Ads SDK टूल के लिए डिपेंडेंसी जोड़ें:

   pod 'Google-Mobile-Ads-SDK'
   

2. विज्ञापनों को लोड करने से पहले, GADMobileAds.sharedInstance पर startWithCompletionHandler: मेथड को कॉल करें.

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

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

   • यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं से सहमति लेना
   • अनुरोध से जुड़े फ़्लैग सेट करें. जैसे, tagForChildDirectedTreatment या tag_for_under_age_of_consent

   ज़्यादा जानने के लिए, AdMob दस्तावेज़ पढ़ें.

   यहां startWithCompletionHandler: में startWithCompletionHandler: तरीके को कॉल करने का तरीका बताया गया है:AppDelegate

   Swift

   import Firebase
   import GoogleMobileAds
   ...
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate {
   
     var window: UIWindow?
   
     func application(_ application: UIApplication,
         didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
   
       // Use Firebase library to configure APIs.
       FirebaseApp.configure()
   
       // Initialize the Google Mobile Ads SDK.
       GADMobileAds.sharedInstance().start(completionHandler: nil)
   
       return true
     }
   
   }
   

   Objective-C

   @import Firebase;
   @import GoogleMobileAds;
   ...
   
   @implementation AppDelegate
   
   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Use Firebase library to configure APIs.
     [FIRApp configure];
     // Initialize the Google Mobile Ads SDK.
     [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
     return YES;
   }
   
   @end
   

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

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

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

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

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

आम तौर पर, डेटा एक घंटे में दिखने लगता है. हालांकि, कभी-कभी इसमें 48 घंटे तक लग सकते हैं.

पांचवां चरण: (ज़रूरी नहीं) 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 के दस्तावेज़ में मौजूद बटन पर क्लिक करें.

बैनर

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

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

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

मध्यवर्ती

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

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

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

स्थानीय

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

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

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

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

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

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

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

इनाम वाले विज्ञापन (नए एपीआई) लागू करना