ग्लोबल सेटिंग

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

GADMobileAds क्लास, Google Mobile Ads SDK से इकट्ठा की गई कुछ जानकारी को कंट्रोल करने के लिए, ग्लोबल सेटिंग उपलब्ध कराती है.

वीडियो विज्ञापन के वॉल्यूम को कंट्रोल करना

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

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

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

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

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.applicationVolume = 0.5
  ...
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

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

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

Swift

MobileAds.shared.applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

डिफ़ॉल्ट रूप से, applicationVolume की वैल्यू 1 (डिवाइस का मौजूदा वॉल्यूम) और applicationMuted की वैल्यू NO पर सेट होती है.

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

नेटिव विज्ञापन

म्यूट करने की सेटिंग को कंट्रोल करने के निर्देशों के लिए, GADVideoOptions देखें. नेटिव विज्ञापनों के लिए, वॉल्यूम कंट्रोल करने की कस्टम सेटिंग उपलब्ध नहीं है.

ऑडियो सेशन

ऑडियो सेशन की मदद से, सिस्टम को यह बताया जा सकता है कि आपके ऐप्लिकेशन के ऑडियो के व्यवहार के लिए आपकी क्या प्राथमिकताएं हैं. ऑडियो सेशन के बारे में ज़्यादा जानकारी, Apple की ऑडियो सेशन प्रोग्रामिंग गाइड में देखी जा सकती है. audioVideoManager प्रॉपर्टी की मदद से, Google Mobile Ads SDK ऑडियो को मैनेज किया जा सकता है.

अगर आपके ऐप्लिकेशन में ऑडियो का इस्तेमाल नहीं किया जाता है, तो आपको इन एपीआई का इस्तेमाल करने की ज़रूरत नहीं है. Google Mobile Ads SDK ऑडियो चलाने पर, ऑडियो सेशन की कैटगरी को अपने-आप मैनेज करता है. अगर आपके ऐप्लिकेशन में ऑडियो चलाया जाता है और आपको यह कंट्रोल करना है कि Google Mobile Ads SDK ऑडियो कब और कैसे चलाए, तो इन एपीआई का इस्तेमाल किया जा सकता है.

अगर आपको ऑडियो सेशन की कैटगरी को खुद मैनेज करना है, तो ऑडियो वीडियो मैनेजर पर, audioSessionIsApplicationManaged प्रॉपर्टी को YES पर सेट करें.

अगर आपको ऑडियो सेशन की कैटगरी को मैनेज करना है, तो लागू करें GADAudioVideoManagerDelegate . साथ ही, विज्ञापन के वीडियो और ऑडियो चलाने के इवेंट की सूचना पाने के लिए, ऑडियो वीडियो मैनेजर पर delegate प्रॉपर्टी सेट करें. इसके बाद, Apple की ऑडियो सेशन प्रोग्रामिंग गाइड के मुताबिक, ऑडियो सेशन की कैटगरी को सही कैटगरी में बदलें.

ध्यान दें: डिफ़ॉल्ट रूप से, SDK टूल, म्यूट किए गए विज्ञापन चलाते समय, ऑडियो सेशन की कैटगरी को AVAudioSessionCategoryAmbient पर सेट करता है. अगर आपको इस स्थिति में अपने ऐप्लिकेशन के लिए AVAudioSessionCategoryOptionDuckOthers का इस्तेमाल करना है, तो आपको GADAudioVideoManagerDelegate प्रोटोकॉल लागू करना होगा. साथ ही, ऑडियो वीडियो मैनेजर audioSessionIsApplicationManaged को YES पर सेट करना होगा.

यहां कोड का एक आसान नमूना दिया गया है. इसमें, ऊपर दिए गए एपीआई का इस्तेमाल करके, यह दिखाया गया है कि अगर आपका ऐप्लिकेशन संगीत चलाता है, तो कौनसे तरीके का इस्तेमाल करना चाहिए:

Swift

func setUp() {
  MobileAds.shared.audioVideoManager.delegate = self
  MobileAds.shared.audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.shared.pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.shared.resumeAllMusic()
}

Objective-C

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  [MyAppObject.sharedInstance pauseAllMusic];
}

- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
    // Google Mobile Ads SDK is notifying your app that it has stopped playing
    // audio. Depending on your design, you could resume music here.
  [MyAppObject.sharedInstance resumeAllMusic];
}

क्रैश रिपोर्ट

Google Mobile Ads SDK iOS ऐप्लिकेशन में होने वाली गड़बड़ियों की जांच करता है. साथ ही, अगर ये गड़बड़ियां SDK टूल की वजह से हुई हैं, तो उन्हें रिकॉर्ड करता है. इसके बाद, SDK टूल के आने वाले वर्शन में इन गड़बड़ियों को ठीक किया जाता है.

क्रैश रिपोर्टिंग की सुविधा, डिफ़ॉल्ट रूप से चालू रहती है. अगर आपको SDK टूल से जुड़ी गड़बड़ियों को रिकॉर्ड नहीं करना है, तो disableSDKCrashReporting तरीके को कॉल करके, इस सुविधा को बंद किया जा सकता है. इस तरीके को कॉल करने का सबसे सही समय, ऐप्लिकेशन लॉन्च होने के दौरान होता है:

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.disableSDKCrashReporting()
    return true
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

कुकी की सेटिंग के लिए सहमति

अगर आपके ऐप्लिकेशन के लिए खास ज़रूरतें हैं, तो ज़रूरी नहीं है कि आप NSUserDefaults gad_has_consent_for_cookies सेट करें. Google Mobile Ads SDK अगर gad_has_consent_for_cookies प्राथमिकता को शून्य पर सेट किया जाता है, तो विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा (एलटीडी) चालू करता है.

Swift

UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")

Objective-C

NSUserDefaults.standardUserDefaults().setObject(Int(0),
    forKey: "gad_has_consent_for_cookies");