שנתחיל?

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

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

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

  • שימוש ב-Unity מגרסה 2019.4 ואילך
  • כדי לפרוס ל-iOS
    • Xcode 15.3 ומעלה
    • טירגוט ל-iOS מגרסה 12.0 ואילך
    • CocoaPods
  • לפריסה ב-Android
    • רמת API מינימלית של Android 21 ואילך
    • טירגוט ל-Android API ברמה 34 ואילך

רמת ה-API של Android מוגדרת דרך Project Settings > Player > Android > Other Settings > Other Settings.

ייבוא הפלאגין של מודעות לנייד ל-Unity

OpenUPM-CLI

אם התקנתם את OpenUPM CLI, אפשר להתקין את מרשם OpenUPM באמצעות הפקודה הבאה:

openupm add com.google.ads.mobile

הסרה של .unitypackage נכסי פלאגין

אם עוברים משימוש ב-.unitypackage לשימוש ב-OpenUPM, צריך להסיר את הנכסים באופן ידני מהמיקום הישן. מסירים את הספריות הבאות שיובאו מה-.unitypackage:

  • Assets/ExternalDependencyManager
  • נכסים/מודעות GoogleMobile
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

  1. פותחים את הגדרות מנהל החבילות על ידי בחירה באפשרות בתפריט של Unity‏ Edit > Project Settings > Package Manager.
  2. מוסיפים את OpenUPM כמאגר ברמת ההיקף לחלון של מנהל החבילות:

    Name: OpenUPM
    URL: https://package.openupm.com
    Scopes: com.google
    
  3. פותחים את תפריט מנהל החבילות על ידי בחירה באפשרות בתפריט של Unity‏ Window (חלון) > Package Manager (מנהל החבילות).

  4. מגדירים את התפריט הנפתח של היקף ההרשאות ברמת חשבון הניהול כדי לבחור באפשרות My Registries (הרישומים שלי).

  5. בוחרים את חבילת Google Mobile Ads for Unity מרשימת החבילות, ולוחצים על Install.

הסרת נכסי הפלאגין .unitypackage

אם עוברים משימוש ב-.unitypackage לשימוש ב-OpenUPM, צריך להסיר את הנכסים באופן ידני מהמיקום הישן. מסירים את הספריות הבאות שיובאו מה-.unitypackage:

  • Assets/ExternalDependencyManager
  • נכסים/מודעות GoogleMobile
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

ייבוא מ-GitHub

  1. מורידים את הגרסה האחרונה של .unitypackage מ-GitHub.
  2. כדי לייבא את קובץ .unitypackage, בוחרים באפשרות בתפריט Unity Assets >Import package > Custom Package (חבילה מותאמת אישית) ומייבאים את כל הפריטים.

הכללת יחסי תלות חיצוניים

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

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

Android

עוברים אל הגדרות פרויקט > נגן > Android > הגדרות פרסום > Build ובוחרים:

  • תבנית ראשית מותאמת אישית של Gradle
  • תבנית מותאמת אישית של מאפייני Gradle

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

iOS

ב-Unity ל-iOS נעשה שימוש ב-CocoaPods כדי לזהות ולנהל יחסי תלות. במשאבי העזרה של CocoaPods תוכלו למצוא דרישות ספציפיות או שלבים לפתרון בעיות שקשורים ליחסי התלות ב-iOS.

יחסי התלות של הפלאגין של Google Mobile Ads ל-Unity מפורטים בקובץ Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

הגדרת Ad Manager מזהה האפליקציה

בעורך Unity, בוחרים בתפריט באפשרות נכסים > Google Mobile Ads > הגדרות.

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

הפעלת ה-SDK

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

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

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

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

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

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

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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