إعدادات عامة

اختيار النظام الأساسي: Android جديد Android iOS Unity

يوفّر الصف GADMobileAds إعدادات عامة للتحكّم في معلومات معيّنة تجمعها Google 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.
  MobileAds.shared.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

MobileAds.shared.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.

في ما يلي عينة تعليمات برمجية مبسطة تعرض الطريقة المقترَحة إذا كان تطبيقك يشغّل الموسيقى، باستخدام واجهات برمجة التطبيقات أعلاه:

Swift

func setUp() {
  MobileAds.shared.audioVideoManager.delegate = self
  MobileAds.shared.audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.shared.pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.shared.resumeAllMusic()
}

Objective-C

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // Google 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 {
    // Google 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 {

    MobileAds.shared.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");