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

בחירת פלטפורמה: Android (בטא) Android iOS Unity

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

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

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

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

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

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

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

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

חשוב: הלולאה Update() של Unity מעכבת את כל הקוד שמוצב בתוך השיטה ExecuteInUpdate. צריך להציב את כל הקוד שרגיש לזמן, כמו טלמטריה או הכנסות מפרסום ברמת החשיפה (ILAR) מחוץ לשיטה ExecuteInUpdate.

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

כדי ש-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;
    }
}

אזהרה: כשמגדירים את MobileAds.RaiseAdEventsOnUnityMainThread לערך true כלשהו, אירועי מודעות שמופעלים בזמן שהמשחק מושהה או פועל ברקע מתעכבים עד שהמשתמש חוזר למשחק. אם המשתמש סוגר את האפליקציה במהלך הזמן הזה, אירועי המודעות המושהים האלה מושמטים לגמרי. בעלי אפליקציות שמגדירים את MobileAds.RaiseAdEventsOnUnityMainThreadtrue עשויים לראות דיווח על הכנסות מפרסום ברמת החשיפה עם פער של עד 30%. המלצה:במקום זאת, כדאי לסנכרן באופן ידני אירועים ספציפיים שקשורים למודעות.

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

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

// Enable limited ads
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

מבצעים קריאה ל-DisableSDKCrashReporting כדי להשבית דוחות קריסה ב-iOS:

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

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

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

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

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

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

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