הפלאגין של 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 כמאגר ברמת ההיקף לחלון של מנהל החבילות:
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
עוברים אל 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.
מגדירים את 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 => { });
}
}
אם אתם משתמשים בתהליך בחירת הרשת (Mediation), כדאי להמתין עד לקריאה החוזרת (callback) לפני טעינת המודעות, כדי לוודא שכל מתאמי תהליך בחירת הרשת מופעלים.
בחירת פורמט מודעה
Google Mobile Ads SDK נכלל עכשיו באפליקציה שלכם ב-Unity כשפורסים אותה לפלטפורמת Android או iOS. עכשיו אתם מוכנים להטמיע מודעה. ב-AdMob יש כמה פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שמספק את חוויית המשתמש הטובה ביותר.
מודעת באנר
יחידות של מודעות באנר מוצגות כמלבן שתופס חלק מהפריסה של האפליקציה. ייתכן שיתבצע רענון אוטומטי של המודעות אחרי פרק זמן מסוים. הרענון האוטומטי יגרום לכך שתוצג למשתמשים מודעה חדשה במרווחי זמן קבועים, גם אם הם יישארו באותו מסך באפליקציה. כמו כן, מודעות באנר הן פורמט המודעה הפשוט ביותר להטמעה.
מעברון
יחידות של מודעות מעברון משמשות להצגה של מודעות במסך מלא באפליקציה. צריך למקם אותן בנקודות עצירה ומעבר טבעיות בממשק של האפליקציה, כמו אחרי השלמת שלב באפליקציית משחקים.
מותאם
מודעות מותאמות הן מודעות שבהן אפשר להתאים אישית את האופן שבו נכסים כמו כותרות וקריאות לפעולה מוצגים באפליקציות. עיצוב המודעה בעצמכם מאפשר לכם ליצור הצגות של מודעות טבעיות ולא מפריעות, שיכולות להוסיף לחוויית המשתמש.
ההטבה הופעלה
יחידות של מודעות מתגמלות מאפשרות למשתמשים לשחק במשחקים, להשתתף בסקרים או לצפות בסרטונים כדי לזכות בתגמולים בתוך האפליקציה, כמו מטבעות, עוד חיים או נקודות. אתם יכולים להגדיר תגמולים שונים ליחידות מודעות שונות ולציין את ערכי התגמולים והפריטים שהמשתמשים קיבלו.
מודעות מעברון מתגמלות
מודעת מעברון מתגמלת היא מודעה מסוג חדש שמופיעה באופן אוטומטי בנקודות מעבר טבעיות באפליקציה ומאפשרת לכם להציע תגמולים, כמו מטבעות או תוספת חיים.
בשונה ממודעות מתגמלות רגילות, המשתמשים לא צריכים להביע הסכמה לצפייה במודעת מעברון מתגמלת.
במקום לבקש את ההסכמה לשימוש במודעות מתגמלות, מודעות מעברון מתגמלות צריכות לכלול מסך פתיחה שמציין מהו התגמול ומאפשר למשתמשים לבטל את ההסכמה.
הטמעה של מודעות מעברון מתגמלות
מודעה בפתיחת אפליקציה
מודעה בפתיחת אפליקציה היא פורמט מודעה שמופיע כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה של האפליקציה.