Google Mobile Ads SDK सेट अप करना

प्लैटफ़ॉर्म चुनें: Android Android iOS Unity Flutter

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

ज़रूरी शर्तें

• Xcode 16.0 या इसके बाद का वर्शन इस्तेमाल करें
• iOS 13.3 या इसके बाद के वर्शन को टारगेट करें

Google Mobile Ads SDK इंपोर्ट करना

Google Mobile Ads SDK इंपोर्ट करने के लिए, इनमें से कोई एक तरीका अपनाएं.

Swift Package Manager

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ें, यह तरीका अपनाएं:

1. Xcode में, फ़ाइल > पैकेज डिपेंडेंसी जोड़ें... पर जाकर, Google Mobile Ads Swift Package इंस्टॉल करें.

2. दिखने वाले प्रॉम्प्ट में, Google Mobile Ads Swift Package GitHub रिपॉज़िटरी खोजें:

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. Google Mobile Ads Swift Package का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि अगले बड़े वर्शन तक का इस्तेमाल करें.

CocoaPods

आगे बढ़ने से पहले, Podfile बनाने और उनका इस्तेमाल करने के बारे में जानकारी पाने के लिए, CocoaPods का इस्तेमाल करना लेख पढ़ें.

CocoaPods का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. अपने प्रोजेक्ट का Podfile खोलें और अपने ऐप्लिकेशन के target बिल्ड कॉन्फ़िगरेशन में यह लाइन जोड़ें:

   pod 'Google-Mobile-Ads-SDK'

2. टर्मिनल में, यह कमांड चलाएं:

   pod install --repo-update

मैन्युअल तरीके से डाउनलोड करना

1. Download Google Mobile Ads SDK और Embed & Sign इन फ़्रेमवर्क को अपने Xcode प्रोजेक्ट में:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. अपने प्रोजेक्ट की बिल्ड सेटिंग में जाकर:

   • Runpath Search Paths में /usr/lib/swift पाथ जोड़ें.
   • Other Linker Flags में -ObjC लिंकर फ़्लैग जोड़ें.

अपना Info.plist अपडेट करना

अपने ऐप्लिकेशन की Info.plist फ़ाइल अपडेट करें, ताकि इसमें ये दो कुंजियां जोड़ी जा सकें:

1. एक GADApplicationIdentifier कुंजी. इसकी स्ट्रिंग वैल्यू, Ad Manager यूज़र इंटरफ़ेस (यूआई) में दिखने वाला आपके ऐप्लिकेशन का आईडी होना चाहिए . यह आईडी, ca-app-pub-################~########## फ़ॉर्मैट में होता है.

2. एक SKAdNetworkItems कुंजी. इसकी वैल्यू, Google (cstr6suwn9.skadnetwork) और तीसरे पक्ष के उन चुनिंदा खरीदारों के लिए SKAdNetworkIdentifier होनी चाहिए जिन्होंने Google को ये वैल्यू दी हैं.

पूरा स्निपेट

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

SAMPLE_APP_ID की जगह, अपने Ad Manager ऐप्लिकेशन का आईडी डालें. टेस्टिंग के दौरान, पिछले उदाहरण में दिखाया गया सैंपल ऐप्लिकेशन आईडी इस्तेमाल करें.

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

शुरू करनाGoogle Mobile Ads SDK

विज्ञापन लोड करने से पहले, start() तरीके को GADMobileAds.sharedInstance पर कॉल करें. इससे, एसडीके शुरू होता है. साथ ही, शुरू होने की प्रोसेस पूरी होने के बाद (या 30 सेकंड का टाइम आउट होने के बाद), कंप्लीशन हैंडलर को वापस कॉल किया जाता है. start() को जल्द से जल्द कॉल करें.

चेतावनी: विज्ञापन, Google Mobile Ads SDK या मीडिएशन पार्टनर के एसडीके startWithCompletionHandler: को कॉल करने पर पहले से लोड हो सकते हैं. अगर आपको यूरोपीय आर्थिक क्षेत्र (ईईए) के उपयोगकर्ताओं की अनुमति लेनी है, अनुरोध-विशिष्ट फ़्लैग सेट करने हैं (जैसे, tagForChildDirectedTreatment या tag_for_under_age_of_consent), या विज्ञापन लोड करने से पहले कोई अन्य कार्रवाई करनी है, तो पक्का करें कि आपने Google Mobile Ads SDK शुरू करने से पहले ऐसा कर लिया हो.

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
ViewController.swift

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
GoogleMobileAdsConsentManager.swift

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];
ViewController.m

ध्यान दें: अगर मीडिएशन का इस्तेमाल किया जा रहा है, तो विज्ञापन लोड करने से पहले, कंप्लीशन हैंडलर को कॉल किए जाने तक इंतज़ार करें. इससे यह पक्का किया जा सकेगा कि सभी मीडिएशन अडैप्टर शुरू हो गए हैं.

कोई विज्ञापन फ़ॉर्मैट चुनना

Google Mobile Ads SDK अब इंपोर्ट और शुरू हो गया है. अब विज्ञापन लागू किया जा सकता है. Ad Manager में कई तरह के विज्ञापन फ़ॉर्मैट उपलब्ध हैं. इसलिए, ऐसा फ़ॉर्मैट चुनें जो आपके ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही हो.

बैनर

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

Google Ad Manager में, नेटिव विज्ञापन लागू करने के दो तरीके हैं: नेटिव स्टाइल और कस्टम रेंडरिंग के ज़रिए स्टैंडर्ड नेटिव विज्ञापन.

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

नेटिव स्टाइल लागू करना नेटिव विज्ञापन लागू करना (कस्टम रेंडरिंग)

इनाम दिया गया

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

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

इनाम वाला इंटरस्टीशियल

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

उपयोगकर्ताओं को इनाम वाले इंटरस्टीशियल विज्ञापन देखने के लिए, ऑप्ट-इन करना ज़रूरी नहीं होता. इनाम वाले विज्ञापनों के लिए ऐसा करना ज़रूरी है.

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

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

ऐप्लिकेशन काम कर रहा है

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

ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन लागू करना