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

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

विज्ञापन दिखाने और रेवेन्यू जनरेट करने के लिए, अपने iOS ऐप्लिकेशन में Google Mobile Ads SDK को इंटिग्रेट करें. अपने प्रोजेक्ट को तैयार करने के लिए, विज्ञापन के लिए अनुरोध करने से पहले, Google Mobile Ads SDK को इंपोर्ट और शुरू करें.

इस गाइड में, Google Mobile Ads SDK को इंपोर्ट और शुरू करने के साथ-साथ, विज्ञापन फ़ॉर्मैट चुनने के बारे में बताया गया है.

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

आगे बढ़ने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

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

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

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

Swift Package Manager

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

1. Xcode खोलें.
2. फ़ाइल > पैकेज डिपेंडेंसी जोड़ें... पर जाएं.

3. Google Mobile Ads SDK Swift पैकेज इंस्टॉल करें.

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

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

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

CocoaPods

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

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

   pod 'Google-Mobile-Ads-SDK'

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

   pod install --repo-update

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

Google Mobile Ads SDK को मैन्युअल तरीके से डाउनलोड करने के लिए, यह तरीका अपनाएं:

1. डाउनलोड करें Google Mobile Ads SDK.
2. googlemobileadssdkios.zip पैकेज को एक्सट्रैक्ट करें.

3. अपने Xcode प्रोजेक्ट में, ये फ़्रेमवर्क जोड़ें:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

4. अपने टारगेट की सामान्य सेटिंग में, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट पर जाएं.

5. पुष्टि करें कि आपने GoogleMobileAds.xcframework और UserMessagingPlatform.xcframework को एम्बेड करें और साइन करें पर सेट किया है.

6. अपने प्रोजेक्ट की बिल्ड सेटिंग में, यह तरीका अपनाएं:

   • रनपाथ सर्च पाथ में, /usr/lib/swift पाथ जोड़ें.
   • अन्य लिंकर फ़्लैग में, -ObjC लिंकर फ़्लैग जोड़ें.

अपनी Info.plist फ़ाइल अपडेट करना

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

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

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

पूरी जानकारी वाला उदाहरण

<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 को टारगेट करता है, लेकिन वह किसी ऐप्लिकेशन से लिंक नहीं है, तो Google उस ग्रुप को आपके खाते में मौजूद सभी iOS ऐप्लिकेशन पर भेजता है. इस तरीके से, परफ़ॉर्मेंस धीमी हो सकती है.

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

विज्ञापन लोड करने से पहले, Google Mobile Ads SDK शुरू करें. इसके लिए, GADMobileAds.sharedInstance प्रॉपर्टी से start() तरीका कॉल करें. Google Mobile Ads SDK और मीडिएशन अडैप्टर की प्रोसेसिंग पूरी होने या 30 सेकंड बाद, यह तरीका पूरा होने वाला हैंडलर कॉल करता है.

यहां दिए गए उदाहरण में, 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 विज्ञापन पहले से लोड कर सकता है या तीसरे पक्ष के SDK टूल शुरू कर सकता है, जब startWithCompletionHandler: तरीके को कॉल किया जाता है. अगर आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूनाइटेड किंगडम (यूके) या स्विट्ज़रलैंड में मौजूद उपयोगकर्ताओं से सहमति लेनी है, तो अनुरोध के हिसाब से फ़्लैग सेट करें. अगर आपको अनुरोध के हिसाब से फ़्लैग सेट करने हैं, तो पक्का करें कि आपने Google Mobile Ads SDK शुरू करने से पहले, फ़्लैग सेट कर लिए हों.Google Mobile Ads SDK ज़्यादा जानकारी के लिए, टारगेटिंग देखें.

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

Google Mobile Ads SDK इंपोर्ट करने के बाद, लागू करने के लिए कोई विज्ञापन फ़ॉर्मैट चुना जा सकता है.

Ad Manager में ये विज्ञापन फ़ॉर्मैट उपलब्ध हैं:

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