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

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

העלאה של אירועי מודעות ב-thread הראשי ב-Unity

ה-SDK של Google Mobile Ads SDK מעביר אירועים ב-thread שונה מה-thread הראשי של Unity. אם מטמיעים אירועים של מודעות ויוצרים אינטראקציה עם אובייקטים של Unity, צריך לסנכרן את אירועי Mobile Ads SDK עם ה-thread הראשי של Unity.

אם אתם רוצים ש-Mobile Ads SDK תטפל בבעיה הזו בשרשור, תוכלו להגדיר את MobileAds.RaiseAdEventsOnUnityMainThread ל-true. פעולה זו מאלצת את ה-SDK להעלות את כל האירועים והקריאות החוזרות (callback) ב-thread הראשי של Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

הערה: תופעת לוואי של העלאת אירועים ב-thread הראשי של Unity היא שאירועים מסוימים, כמו OnAdFullScreenContentOpened לא מועלים עד שהמשתמש חוזר לאפליקציה.

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

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

עוצמת הקול של המכשיר נקבעת באמצעות לחצני עוצמת הקול או באמצעות פס ההזזה של עוצמת הקול ברמת מערכת ההפעלה, קובע את עוצמת הקול לפלט האודיו של המכשיר. עם זאת, האפליקציות יכולות לשנות באופן עצמאי את עוצמת הקול ביחס לעוצמת הקול של המכשיר, כדי להתאים את חוויית האודיו.

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

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

אזהרה: הפחתת עוצמת הקול של האודיו באפליקציה מפחיתה את הכשירות של מודעות וידאו ועשויה להפחית את ההכנסות מפרסום באפליקציה. כדאי להשתמש בשיטה הזו רק אם האפליקציה מספקת למשתמש פקדי עוצמת קול מותאמים אישית, ועוצמת הקול של המשתמש מוחזרת בצורה נכונה באפליקציה.

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

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

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

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

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

אם לאפליקציה שלכם יש דרישות מיוחדות, תוכלו להגדיר את המפתח האופציונלי של ApplicationPreferences gad_has_consent_for_cookies כאפס כדי להפעיל מודעות מוגבלות (LTD):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

הקטנה של Android

אפשרות הפרסום ב-Unity מאפשרת להפעיל הקטנת קוד Java. אם מפעילים את ההקטנה, צריך גם ליצור קובץ ProGuard בהתאמה אישית כדי לשמור את המחלקות שה-SDK מפנה אליהן.

1. הפעל קובץ ProGuard מותאם אישית

   עוברים אל Project Settings (הגדרות הפרויקט) > Player > Android (Android) > Advertising Settings (הגדרות הפרסום) > Build, ובוחרים את האפשרות:

   • קובץ ProGuard בהתאמה אישית

2. פותחים את /Assets/Plugins/Android/proguard-user.txt ומוסיפים את הפרטים הבאים:

-keep class com.google.** { public *; }