שנתחיל?

הפלאגין של 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 (Android)‏ > Other Settings (הגדרות אחרות)‏ > Other Settings (הגדרות אחרות).

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

OpenUPM-CLI

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

openupm add com.google.ads.mobile

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

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

  • Assets/ExternalDependencyManager
  • Assets/GoogleMobileAds
  • 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 כמאגר ברמת ההיקף לחלון Package Manager:

    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
  • Assets/GoogleMobileAds
  • 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‏ נכסים > ייבוא חבילה > חבילה מותאמת אישית וייבוא כל הפריטים.

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

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

כדי לוודא שהפרויקט כולל את כל יחסי התלות:

Android

עוברים אל Project Settings (הגדרות הפרויקט)‏ > Player (נגן)‏ > Android (Android)‏ > Publishing Settings (הגדרות פרסום)‏ > Build (גרסה) ובוחרים באפשרות:

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

בעורך של Unity, בוחרים באפשרות Assets > External Dependency Manager > Android Resolver > Resolve כדי שהספרייה של 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() בתוך השיטה 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 יש כמה פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שמספק את חוויית המשתמש הטובה ביותר.

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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