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

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

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

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

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

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

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

Swift Package Manager

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

Xcode में, File > Add Package Dependencies... पर जाकर, Google Mobile Ads Swift Package इंस्टॉल करें.
दिखने वाले प्रॉम्प्ट में, Google Mobile Ads Swift Package के GitHub रिपॉज़िटरी को खोजें:
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
Google Mobile Ads Swift Package का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि Up to Next Major Version का इस्तेमाल करें.

CocoaPods

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

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

अपने प्रोजेक्ट का Podfile खोलें और अपने ऐप्लिकेशन के target बिल्ड कॉन्फ़िगरेशन में यह लाइन जोड़ें:
```
pod 'Google-Mobile-Ads-SDK'
```
टर्मिनल में, यह कमांड चलाएं:
```
pod install --repo-update
```

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

डाउनलोड करें Google Mobile Ads SDK और Embed & Sign इन फ़्रेमवर्क को अपने Xcode प्रोजेक्ट में डालें:
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
अपने प्रोजेक्ट की बिल्ड सेटिंग में जाकर:
- Runpath Search Paths में /usr/lib/swift पाथ जोड़ें.
- Other Linker Flags में -ObjC लिंकर फ़्लैग जोड़ें.

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

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

एक GADApplicationIdentifier कुंजी. इसकी स्ट्रिंग वैल्यू, Ad Manager यूज़र इंटरफ़ेस (यूआई) में दिखने वाला आपके ऐप्लिकेशन का आईडी होना चाहिए . इसका फ़ॉर्मैट ca-app-pub-################~########## होता है.
एक 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 मोबाइल विज्ञापन SDK को शुरू करने से पहले ऐसा कर लिया हो. 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 में, नेटिव विज्ञापन लागू करने के दो तरीके हैं: नेटिव स्टाइल और कस्टम रेंडरिंग के ज़रिए स्टैंडर्ड नेटिव विज्ञापन.

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

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

इनाम दिया गया

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

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

पुरस्कृत मध्यवर्ती विज्ञापन

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

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

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

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

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

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

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