إعدادات عمومية

توفر فئة GADMobileAds إعدادات عامة للتحكم في معلومات معيّنة يتم جمعها من خلال حزمة SDK لإعلانات الأجهزة الجوّالة.

التحكم في مستوى صوت إعلانات الفيديو

ملاحظة: لا تنطبق عناصر التحكّم في مستوى صوت الفيديو إلا على "إعلانات Google" ولا تتم إعادة توجيهها إلى شبكات التوسّط.

إذا كان تطبيقك يتضمّن عناصر تحكّم في مستوى الصوت، مثل مستويات صوت التطبيق أو المؤثرات الصوتية المخصّصة، إنّ الإفصاح عن مستوى صوت التطبيق لحزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" يتيح لإعلانات الفيديو مراعاة إعدادات مستوى الصوت في التطبيق. يضمن ذلك تلقّي المستخدمين لإعلانات الفيديو بمستوى الصوت المتوقع.

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

بالنسبة إلى أشكال الإعلانات على شاشة فتح التطبيق وإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة، يمكنك الإبلاغ عن الحجم النسبي للتطبيق إلى حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من خلال إعداد السمة 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;
  ...
}

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

بالنسبة إلى أشكال الإعلانات على شاشة فتح التطبيق وإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية بمكافأة، يمكنك إبلاغ حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة بأنّه تم كتم صوت التطبيق من خلال ضبط السمة applicationMuted:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

بشكل تلقائي، يتم ضبط applicationVolume على 1 (مستوى صوت الجهاز الحالي) وapplicationMuted على NO.

تحذير: يؤدي تجاهل تطبيقك إلى تقليل أهلية إعلانات الفيديو وقد يقلل من أرباح الإعلانات في تطبيقك. يجب عدم استخدام واجهة برمجة التطبيقات هذه إلا إذا كان تطبيقك يوفّر للمستخدم عنصر تحكّم مخصّصًا في كتم الصوت، ويظهر قرار المستخدم بشأن كتم الصوت بشكل صحيح في واجهة برمجة التطبيقات.

إعلانات مدمجة مع المحتوى

راجِع GADVideoOptions للحصول على تعليمات عن التحكّم في إعدادات كتم الصوت. بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا تتوفر ميزة التحكم المخصص في مستوى الصوت.

الجلسات الصوتية

تتيح لك الجلسات الصوتية أن تعبّر للنظام عن نواياك بشأن السلوك الصوتي لتطبيقك. يمكنك العثور على معلومات إضافية حول الجلسات الصوتية في دليل برمجة الجلسات الصوتية من Apple. تتوفر خيارات إدارة الملف الصوتي لحزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال الموقع audioVideoManager.

إذا كنت لا تستخدم الصوت في تطبيقك، لن تحتاج إلى استخدام واجهات برمجة التطبيقات هذه. تدير حزمة SDK لإعلانات Google على الأجهزة الجوّالة تلقائيًا فئة الجلسة الصوتية عند تشغيل الصوت. إذا شغّلت الصوت في تطبيقك وكنت تريد مزيدًا من التحكم في كيفية ووقت تشغيل الصوت في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، يمكنك الاستفادة من واجهات برمجة التطبيقات هذه.

في أداة إدارة الفيديوهات الصوتية، يمكنك ضبط السمة audioSessionIsApplicationManaged على YES إذا كنت تريد تحمّل مسؤولية إدارة فئة الجلسات الصوتية بنفسك.

إذا كنت تريد إدارة فئة الجلسة الصوتية، يمكنك تنفيذ GADAudioVideoManagerDelegate وضبط السمة delegate في "مدير الفيديو الصوتي" ليتم إرسال إشعارات إليك بشأن أحداث تشغيل الفيديو والصوت في الإعلانات. عليك بعد ذلك تغيير فئة الجلسة الصوتية إلى الفئة ذات الصلة وفقًا لدليل برمجة الجلسات الصوتية من Apple.

نقطة رئيسية: تضبط حزمة تطوير البرامج (SDK) تلقائيًا فئة الجلسة الصوتية على AVAudioSessionCategoryAmbient عند تشغيل الإعلانات مع كتم صوتها. إذا كنت تفضّل أن يستخدم تطبيقك AVAudioSessionCategoryOptionDuckOthers في هذا السيناريو، عليك استخدام بروتوكول GADAudioVideoManagerDelegate وضبط مدير الفيديو الصوتي audioSessionIsApplicationManaged على YES.

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

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];
}

إعداد تقارير الأعطال

تفحص حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الاستثناءات التي تحدث في تطبيق 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. تتيح حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة تفعيل الإعلانات المحدودة (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");