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

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

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

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

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

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  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)
  }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  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();
}

כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, משתמשים ב-method‏ setAppMuted():

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

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

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

במאמר VideoOptions מוסבר איך לשלוט בהגדרות ההשתקה. אין תמיכה בבקרת עוצמת קול בהתאמה אישית במודעות נתמכות.

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

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

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();