המחלקה MobileAds מספקת הגדרות גלובליות ל-GMA Next-Gen SDK.
שליטה בעוצמת הקול של מודעות וידאו
אם לאפליקציה יש בקרת עוצמת קול משלה (כמו כפתורים מותאמים אישית לשליטה בעוצמת הקול של המוזיקה או האפקטים), תוכלו לאפשר למודעות לפעול בהתאם להגדרות עוצמת הקול של האפליקציה. כדי לעשות את זה, צריך לחשוף את עוצמת הקול של האפליקציה ל-GMA Next-Gen SDK. כך אפשר לוודא שכשיוצגו למשתמש מודעות וידאו, עוצמת הקול תהיה תואמת לבחירה שלו.
עוצמת הקול של המכשיר, שנשלטת באמצעות כפתורי עוצמת הקול או פס ההזזה של עוצמת הקול ברמת מערכת ההפעלה, קובעת את עוצמת הקול של פלט האודיו של המכשיר. עם זאת, אפליקציות יכולות לשנות את עוצמת הקול באופן עצמאי ביחס לעוצמת הקול של המכשיר, כדי להתאים אישית את חוויית האודיו. בפורמטים של מודעות בפתיחת האפליקציה, מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מעברון מתגמלות, אתם יכולים לדווח ל-SDK על עוצמת הקול היחסית של האפליקציה באמצעות השיטה הסטטית setUserControlledAppVolume(). הערכים התקינים של עוצמת הקול של המודעות נעים בין 0.0 (שקט) ל-1.0 (עוצמת הקול הנוכחית של המכשיר). דוגמה לדיווח על עוצמת הקול היחסית של האפליקציה ל-SDK:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this@MainActivity,
// Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
InitializationConfig.Builder("SAMPLE_APP_ID").build()
) {}
// Set app volume to be half of current device volume.
MobileAds.setUserControlledAppVolume(0.5f)
}
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
new Thread(
() -> {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this,
// Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
new InitializationConfig.Builder("SAMPLE_APP_ID")
.build(),
initializationStatus -> {
});
// Set app volume to be half of current device volume.
MobileAds.setUserControlledAppVolume(0.5f);
})
.start();
}
כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, משתמשים ב-method setUserMutedApp():
Kotlin
MobileAds.setUserMutedApp(true)
Java
MobileAds.setUserMutedApp(true);
כברירת מחדל, עוצמת הקול של האפליקציה מוגדרת ל-1 (עוצמת הקול הנוכחית של המכשיר), והאפליקציה לא מושתקת.
הסכמה לשימוש בקובצי Cookie
אם לאפליקציה יש דרישות מיוחדות, אפשר להגדיר את המאפיין האופציונלי SharedPreferences
gad_has_consent_for_cookies. ערכת ה-SDK תפעיל
מודעות מוגבלות (LTD)
כשההעדפה gad_has_consent_for_cookies מוגדרת לאפס.
Kotlin
val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()
Java
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();