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

הסיווג MobileAds מספק הגדרות גלובליות ל-Google Mobile Ads SDK.

בקרת עוצמת הקול של מודעות וידאו

אם לאפליקציה יש פקדי עוצמת קול משלה (כמו עוצמת קול מותאמת אישית של מוזיקה או אפקטים קוליים), כשמציגים את עוצמת הקול של האפליקציה ב-Google Mobile Ads SDK, מודעות וידאו יכולות לפעול בהתאם להגדרות עוצמת הקול של האפליקציה. כך ניתן להבטיח שהמשתמשים יקבלו מודעות וידאו עם עוצמת האודיו הצפויה.

עוצמת הקול של המכשיר נקבעת באמצעות לחצני עוצמת הקול או באמצעות פס ההזזה של עוצמת הקול ברמת מערכת ההפעלה, קובע את עוצמת הקול לפלט האודיו של המכשיר. עם זאת, האפליקציות יכולות לשנות באופן עצמאי את עוצמת הקול ביחס לעוצמת הקול של המכשיר, כדי להתאים את חוויית האודיו. בפורמטים של מודעות בפתיחת אפליקציה, מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מעברון מתגמלות, אפשר לדווח ל-SDK על נפח האפליקציה היחסי באמצעות השיטה setAppVolume() הסטטית. הערכים החוקיים של נפח המודעות נעים בין 0.0 (שקטה) ל-1.0 (עוצמת הקול הנוכחית של המכשיר). הדוגמה הבאה ממחישה איך לדווח ל-SDK על נפח האפליקציה היחסי:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, צריך להשתמש בשיטה setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

כברירת מחדל, עוצמת הקול של האפליקציה מוגדרת ל-1 (עוצמת הקול הנוכחית של המכשיר), והאפליקציה לא מושתקת.

הערה: מודעות וידאו שלא כשירות להצגה עם אודיו מושתק לא יוחזרו עבור בקשות להצגת מודעות שנשלחות כשעוצמת הקול של האפליקציה מדווחת כמושתקת או מוגדרת לערך 0. זה עלול להגביל את ההצגה של קבוצת משנה מתוך המאגר הרחב יותר של מודעות וידאו.

מודעות מותאמות

במאמר VideoOptions מפורטות הוראות לשליטה בהגדרות ההשתקה. בשלב זה, אין תמיכה בבקרת עוצמת קול מותאמת אישית במודעות מותאמות.

הסכמה לשימוש בקובצי cookie

אם לאפליקציה יש דרישות מיוחדות, אפשר להגדיר את המאפיין האופציונלי SharedPreferences gad_has_consent_for_cookies. ה-SDK יפעיל מודעות מוגבלות (LTD) כשההעדפה לגבי gad_has_consent_for_cookies מוגדרת לערך אפס.

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()