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

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

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

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

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

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

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

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");