הפלאגין של 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
- פותחים את הגדרות מנהל החבילות על ידי בחירה באפשרות בתפריט של Unity Edit > Project Settings > Package Manager.
מוסיפים את OpenUPM כמאגר ברמת ההיקף לחלון Package Manager:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.googleפותחים את תפריט מנהל החבילות על ידי בחירה באפשרות התפריט של Unity Window > Package Manager.
בתפריט הנפתח של היקף הניהול, בוחרים באפשרות My Registries.
בוחרים את החבילה 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
- מורידים את הגרסה האחרונה של
.unitypackageמ-GitHub. - מייבאים את הקובץ
.unitypackageעל ידי בחירה באפשרות בתפריט של Unity נכסים > ייבוא חבילה > חבילה מותאמת אישית וייבוא כל הפריטים.
הכללת יחסי תלות חיצוניים
הפלאגין של Google Mobile Ads ל-Unity מופץ עם ספריית ה-Resolver של Unity Play Services. הספרייה הזו מיועדת לכל פלאגין של Unity שדורש גישה לספריות ספציפיות ל-Android, כמו AAR או iOS CocoaPods. הוא מאפשר ל-Unity Plugins להצהיר על יחסי תלות, שמאוחר יותר נפתרים ומועברים באופן אוטומטי לפרויקט ב-Unity.
כדי לוודא שהפרויקט כולל את כל יחסי התלות:
Android
עוברים אל הגדרות הפרויקט > Player > Android > הגדרות פרסום > Build ומחליטים:
- תבנית ראשית מותאמת אישית של Gradle
- תבנית מותאמת אישית של מאפייני Gradle
בעורך של Unity, בוחרים באפשרות Assets > External Dependency Manager > Android Resolver > Resolve כדי שהספרייה של מנהל יחסי התלות החיצוניים של Unity תעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android של אפליקציית Unity.
iOS
ב-Unity ל-iOS נעשה שימוש ב-CocoaPods כדי לזהות ולנהל יחסי תלות. במסמכי התיעוד של CocoaPods תוכלו למצוא דרישות ספציפיות או שלבים לפתרון בעיות שקשורות ליחסי התלות ב-iOS.
יחסי התלות של הפלאגין של Google Mobile Ads ל-Unity מפורטים בקובץ Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.
הגדרת מזהה האפליקציה ב-AdMob
בעורך Unity, בוחרים בתפריט באפשרות נכסים > Google Mobile Ads > הגדרות.
מזינים את מזהה האפליקציה ב-AdMob ל-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 => { });
}
}
אם אתם משתמשים בתהליך בחירת הרשת, כדאי להמתין עד לקריאה החוזרת (callback) לפני טעינת המודעות כדי לוודא שכל המתאמים של תהליך בחירת הרשת מופעלים.
בחירת פורמט מודעה
Google Mobile Ads SDK נכלל עכשיו באפליקציה שלכם ב-Unity כשאתם פורסים אותה בפלטפורמת Android או iOS. עכשיו אתם מוכנים להטמיע מודעה. מערכת AdMob מציעה כמה פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שמספק את חוויית המשתמש הטובה ביותר.
מודעת באנר
ביחידות של מודעות באנר מוצגות מודעות מלבניות שתופסות חלק מהפריסה של האפליקציה. ייתכן שיתבצע רענון אוטומטי של המודעות אחרי פרק זמן מסוים. הרענון האוטומטי יגרום לכך שתוצג למשתמשים מודעה חדשה במרווחי זמן קבועים, גם אם הם יישארו באותו מסך באפליקציה. כמו כן, מודעות באנר הן פורמט המודעה הפשוט ביותר להטמעה.
מעברון
יחידות של מודעות מעברון משמשות להצגה של מודעות במסך מלא באפליקציה. כדאי למקם אותן בנקודות מעבר טבעיות בממשק של האפליקציה, כמו בסיום שלב באפליקציית משחק.
מותאם
מודעות מותאמות הן מודעות שבהן אפשר להתאים אישית את האופן שבו נכסים כמו כותרות וקריאות לפעולה מוצגים באפליקציות. עיצוב המודעה בעצמכם מאפשר לכם ליצור הצגות מודעות טבעיות ולא מפריעות, שיכולות להוסיף לחוויית המשתמש.
ההטבה הופעלה
יחידות של מודעות מתגמלות מאפשרות למשתמשים לשחק במשחקים, להשתתף בסקרים או לצפות בסרטונים כדי לזכות בתגמולים בתוך האפליקציה, כמו מטבעות, עוד חיים או נקודות. אפשר להגדיר תגמולים שונים ליחידות מודעות שונות ולציין את ערכי התגמולים ואת הפריטים שהמשתמשים קיבלו.
מודעות מעברון מתגמלות
מודעת מעברון מתגמלת היא מודעה מסוג חדש שמופיעה באופן אוטומטי בנקודות מעבר טבעיות באפליקציה ומאפשרת לכם להציע תגמולים, כמו מטבעות או תוספת חיים.
בשונה ממודעות מתגמלות רגילות, המשתמשים לא צריכים להביע הסכמה לצפייה במודעת מעברון מתגמלת.
במקום לבקש את ההסכמה לשימוש במודעות מתגמלות, מודעות מעברון מתגמלות צריכות לכלול מסך פתיחה שמציין מהו התגמול ומאפשר למשתמשים לבטל את ההסכמה.
מודעה בפתיחת אפליקציה
מודעה בפתיחת אפליקציה היא פורמט מודעה שמופיע כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה של האפליקציה.