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

הסיווג 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 יתועדו, תוכלו להשבית את התכונה הזו באמצעות קריאה ל-method 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");