שנתחיל?

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

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

דרישות מוקדמות

הורדת הפלאגין של Mobile Ads Unity

הפלאגין Google Mobile Ads Unity מאפשר למפתחים של Unity להציג בקלות מודעות Google לנייד באפליקציות ל-Android ול-iOS, בלי לכתוב קוד Java או האובייקט של CB. הפלאגין מספק ממשק C# לשליחת בקשות למודעות שנעשה בהן שימוש בסקריפטים של C# בפרויקט Unity.

כדי להוריד את חבילת Unity עבור הפלאגין, או את הקוד שלה ב-GitHub, השתמשו בקישורים הבאים.

הורדת הפלאגין הצגת המקור

ייבוא הפלאגין של Mobile Ads Unity

פותחים את הפרויקט שלכם ב-Unity Editor. בוחרים באפשרות Assets > Import Package > Custom Package ומחפשים את הקובץ GoogleMobileAdsPlugin.unitypackage שהורדתם.

מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

לכלול את Mobile Ads SDK

הפלאגין של Google Mobile Ads Unity מופץ באמצעות ספריית Unity Play Services של פתרון בעיות. הספרייה הזו מיועדת לשימוש עם יישומי פלאגין של Unity, שמחייבים גישה לספריות ספציפיות של Android (למשל, AAR) או iOS CocoaPods. הוא מאפשר ליישומי פלאגין של Unity להצהיר על יחסי תלות, שלאחר מכן נפתרים באופן אוטומטי ומועתקים לפרויקט ב-Unity.

כדי לוודא שהפרויקט כולל את Mobile Ads SDK, יש לפעול לפי השלבים הבאים.

Android

בעורך Unity, בוחרים באפשרות Assets > External Dependency Manager > Android מקודד > פענוח. הספרייה תשתיות החיצונית של Unity תייצא את הספרייה התלויה לספריית Assets/Plugins/Android של אפליקציית Unity.

iOS

לא נדרשת כל פעולה נוספת כדי לכלול את Mobile Ads SDK בפרויקט של Unity.

  • כשמשתמשים ב-Unity מגרסה 5.6 ואילך, נוצרת xcworkspace שכוללת את ספריות התלות הנדרשות. שימוש ב-xcworkspace שנוצר במקום בפרויקט Xcode הרגיל.
  • כשמשתמשים בגרסאות ישנות יותר של Unity, יחסי התלות כלולים בפרויקט Xcode הרגיל.

הגדרה של מזהה האפליקציה ב-AdMob

בעורך Unity, בוחרים באפשרות Assets > Google Mobile Ads > Settings בתפריט.

בכל שדה, יש להזין את מזהה האפליקציה שלכם ב-Android וב-iOS.

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

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

אם אתם רוצים שה-SDK של מודעות לנייד יטפל בבעיה הזו בשרשורים, עליכם להגדיר את MobileAds.RaiseAdEventsOnUnityMainThread כ-true. השימוש ב-Mobile Ads SDK יאלץ הגדלה של כל האירועים והקריאות החוזרות בשרשור הראשי של 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;
    }
}

מפעילים את Mobile Ads SDK

לפני טעינת המודעות, יש להפעיל את ה-SDK של מודעות לנייד באפליקציה MobileAds.Initialize(). צריך לעשות זאת פעם אחת בלבד, רצוי עם הפעלת האפליקציה.

הנה דוגמה לקריאה ל-Initialize() בשיטה Start() של סקריפט המצורף ל-GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

בחירה של פורמט מודעה

החבילה של Mobile Ads SDK כלולה עכשיו באפליקציית Unity, בזמן הפריסה לפלטפורמת Android או iOS. עכשיו אתם מוכנים להטמיע מודעה. AdMob מציע מספר פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שהכי מתאים לצרכים של חוויית המשתמש שלכם.

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

הטמעה של מודעת באנר

פרסומת מרווח ביניים

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

הטמעה של מודעת מעברון

מותאמת

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

הטמעה של מודעות מותאמות

ההטבה הופעלה

מודעות וידאו מתגמלות הן מודעות וידאו במסך מלא, והמשתמשים יכולים לצפות בהן במסך מלא בתמורה לפרסים מתוך האפליקציה.

הטמעת מודעות מתגמלות

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

כדי להציג את בקשת ההרשאה לשקיפות מעקב האפליקציות (ATT) לצורך גישה ל-IDFA, יש להשתמש בחבילת התמיכה לפרסום ב-iOS 14 של Unity.

מפתח אפליקציה זהה (SameAppKey)

דרישות מוקדמות: Google Mobile Ads Unity Plugin 6.1.0 ואילך

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

'מפתח אפליקציה זהה' מופעל כברירת מחדל, אבל אפשר להשבית אותו בעזרת ה-API הבא:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }