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

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

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

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

अगर आपके ऐप्लिकेशन में वॉल्यूम कंट्रोल की सुविधा है, जैसे कि कस्टम म्यूज़िक या साउंड इफ़ेक्ट वॉल्यूम, तो 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 की ऑडियो सेशन प्रोग्रामिंग गाइड में देखी जा सकती है. Google Mobile Ads SDK के ऑडियो को मैनेज करने के लिए, audioVideoManager प्रॉपर्टी का इस्तेमाल किया जा सकता है.

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

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

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

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

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 टूल के आने वाले वर्शन में ठीक किया जाता है.

क्रैश रिपोर्टिंग की सुविधा डिफ़ॉल्ट रूप से चालू होती है. अगर आपको एसडीके से जुड़े अपवादों को रिकॉर्ड नहीं करना है, तो 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 को सेट करने का विकल्प होता है. अगर 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");