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

הסיווג 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);
    
    MobileAds.initialize(this);
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this)
    
    // 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()