הגדרות גלובליות

הכיתה 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

אם לאפליקציה יש דרישות מיוחדות, אפשר להגדיר את 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");