GADMobileAds
क्लास, Mobile Ads SDK से इकट्ठा की गई कुछ जानकारी को कंट्रोल करने के लिए ग्लोबल सेटिंग उपलब्ध कराती है.
वीडियो विज्ञापन की आवाज़ कम या ज़्यादा करने की सेटिंग
अगर आपके ऐप्लिकेशन में कस्टम म्यूज़िक या साउंड इफ़ेक्ट वॉल्यूम जैसे खुद के वॉल्यूम कंट्रोल हैं, तो ऐप्लिकेशन की वॉल्यूम की जानकारी 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 प्रोग्रामिंग
गाइड के मुताबिक, ऑडियो सेशन की कैटगरी को सही कैटगरी में बदलना चाहिए.
यहां एक सरल कोड सैंपल दिया गया है, जो ऊपर दिए गए एपीआई का इस्तेमाल करके, अगर आपका ऐप्लिकेशन संगीत चलाता है, तो सुझाया गया तरीका दिखाता है:
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");