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

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

הפעלת אירועים שקשורים למודעות בשרשור הראשי של Unity

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

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

סנכרון ידני של אירועים שקשורים למודעות

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

בדוגמה הבאה מתבצע רישום ביומן של שרשור ברקע ומופעלת פעולה לאינטראקציה עם אובייקטים של UnityEngine:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

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

כדי ש-Google Mobile Ads SDK יסנכרן אירועים שקשורים למודעות, צריך להגדיר את המאפיין MobileAds.RaiseAdEventsOnUnityMainThread לערך true:

...
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;
    }
}

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

אם לאפליקציה יש פקדי עוצמת קול משלה, כמו לחצנים מותאמים אישית לשליטה בעוצמת הקול של המוזיקה או האפקטים, חשיפת עוצמת הקול של האפליקציה ל-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 שעוצמת הקול של האפליקציה הושתקה, צריך לקרוא לשיטה 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.

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

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

קבלת גרסת הפלאגין Unity

כדי לקבל את גרסת Unity SDK, מריצים את הפקודה הבאה:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

קבלת גרסת הפלטפורמה

‫Google Mobile Ads SDK ל-Unity תלוי בערכות פיתוח התוכנה (SDK) של פלטפורמות Android ו-iOS. כדי לקבל את גרסת ה-SDK של הפלטפורמה, מריצים את הפקודה הבאה:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());