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

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

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

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

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

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

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

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance().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

GADMobileAds.sharedInstance().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() {
  GADMobileAds.sharedInstance().audioVideoManager.delegate = self
  GADMobileAds.sharedInstance().audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The 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()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The 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()
}

Objective-C

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

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // The 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 {
    // The 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 {

    GADMobileAds.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 सेट किया जा सकता है. अगर gad_has_consent_for_cookies प्राथमिकता को शून्य पर सेट किया जाता है, तो Google Mobile Ads SDK, सीमित विज्ञापन (एलटीडी) को चालू करता है.

Swift

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

Objective-C

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