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

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

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

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

אם אתם רוצים ש-Mobile Ads SDK יטפל בבעיה הזו בשרשור בשבילכם, צריך להגדיר את MobileAds.RaiseAdEventsOnUnityMainThread לערך true. כך מאלצים את ה-SDK להפעיל את כל האירועים והקריאות החוזרות (callbacks) בשרשור הראשי של 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, צריך להפעיל את השיטה SetApplicationVolume(). הערכים התקינים של עוצמת הקול של מודעות נעים בין 0.0 (שקט) ל-1.0 (עוצמת הקול הנוכחית במכשיר). דוגמה לדיווח על נפח האפליקציה היחסי ל-SDK:

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

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

כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, משתמשים ב-method‏ 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 > Publishing Settings (הגדרות פרסום) > Build ובוחרים באפשרות:

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

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

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

השבתת דיווח על קריסות

פלטפורמת Google Mobile Ads SDK אוספת דוחות קריסה למטרות ניפוי באגים וניתוח. אפשר להשבית את הדיווח על קריסות באמצעות הקוד הבא. בסעיפים הבאים מוסבר איך להשבית את דיווח על קריסות ב-Android וב-iOS.

Android

מוסיפים את התג <meta-data> עם הערך DISABLE_CRASH_REPORTING שמוגדר כ-true בקובץ AndroidManifest.xml של האפליקציה:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

כדי להשבית את דוחות הקריסה ב-iOS, צריך להפעיל את השיטה DisableSDKCrashReporting:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}