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

הכיתה 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();