הכיתה GADMobileAds
מספקת הגדרות גלובליות לשליטה בחלק
מידע שנאסף על ידי 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.
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
לנכס.
אם אתם לא משתמשים באודיו באפליקציה שלכם, אין צורך להשתמש בממשקי ה-API האלה. פלטפורמת Google Mobile Ads SDK מנהל באופן אוטומטי את קטגוריית הסשן של האודיו הפעלת האודיו. אם מפעילים אודיו באפליקציה ורוצים להפעיל שליטה רבה יותר איך ומתי Google Mobile Ads SDK מפעיל אודיו, תוכלו להשתמש בממשקי ה-API האלה.
במנהל הסרטונים של האודיו אפשר להגדיר את
audioSessionIsApplicationManaged
של YES
אם ברצונך לקבל אחריות על ניהול האודיו
בקטגוריה של הסשן שלך.
אם רוצים לנהל את הקטגוריה של סשן האודיו, אפשר להטמיע
GADAudioVideoManagerDelegate
ומגדירים את delegate
מאפיין במנהל וידאו האודיו כדי לקבל הודעה על מודעות וידאו ואודיו
אירועי הפעלה. לאחר מכן עליך לשנות את הקטגוריה של סשן האודיו
הקטגוריה הרלוונטית בהתאם לתכנות סשן האודיו של Apple
מדריך.
לפניכם דוגמת קוד פשוטה שמראה את הגישה המומלצת אם האפליקציה מפעילה מוזיקה באמצעות ממשקי ה-API שצוינו למעלה:
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
הסכמה להגדרות של קובצי Cookie
אם לאפליקציה יש דרישות מיוחדות, אפשר להגדיר את
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");