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

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

वीडियो विज्ञापन की आवाज़ कम या ज़्यादा करने की सेटिंग

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

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

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

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

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

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