הפלאגין של 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
- הרמה המינימלית של Android API היא 21 ומעלה
- טירגוט ל-Android API ברמה 31 ואילך
רמת ה-API של Android מוגדרת בקטע Project Settings (הגדרות הפרויקט) > Player (נגן) > Android (Android) > Other Settings (הגדרות אחרות) > Other Settings (הגדרות אחרות).
ייבוא הפלאגין של מודעות לנייד ל-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 עריכה > הגדרות הפרויקט > מנהל החבילות.
מוסיפים את OpenUPM כמאגר ברמת ההיקף לחלון Package Manager:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
פותחים את תפריט מנהל החבילות על ידי בחירה באפשרות התפריט של Unity Window (חלון) > Package Manager (מנהל החבילות).
מגדירים את התפריט הנפתח של היקף ההרשאות ברמת חשבון הניהול כדי לבחור באפשרות My Registries (הרישומים שלי).
בוחרים את החבילה Google Mobile Ads for Unity מתוך רשימת החבילות. ומקישים על התקנה.
הסרה של .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 Assets > Import package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) וייבוא כל הפריטים.
הכללת יחסי תלות חיצוניים
הפלאגין של Google Mobile Ads ל-Unity מופץ עם ספריית ה-Resolver של Unity Play Services. הספרייה הזו מיועדת לכל פלאגין של Unity שדורש גישה לספריות ספציפיות ל-Android, כמו AAR או iOS CocoaPods. הוא מאפשר ל-Unity Plugins להצהיר על יחסי תלות, שמתקבלים באופן אוטומטי ומועברים לפרויקט ב-Unity.
כדי לוודא שהפרויקט כולל את כל יחסי התלות, צריך לבצע את השלבים הבאים:
Android
עוברים אל Project Settings > (הגדרות הפרויקט >) נגן > Android > הגדרות פרסום > פיתוח פתרונות ובוחרים:
- תבנית 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, בוחרים באפשרות Assets > (נכסים >) מודעות Google לנייד > הגדרות מהתפריט.
מזינים את מזהה האפליקציה ב-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), עליך להמתין עד שהקריאה החוזרת תתבצע לפני טעינת המודעות מוודאים שכל המתאמים לתהליך בחירת הרשת (Mediation) מאותחלים.
בחירה של פורמט מודעה
Google Mobile Ads SDK נכלל עכשיו באפליקציית Unity שלך בפריסה אל בפלטפורמת Android או iOS. עכשיו אתם יכולים להתחיל להטמיע מודעה. ב-AdMob יש כמה פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שמספק את חוויית המשתמש הטובה ביותר.
כרזה
יחידות של מודעות באנר מוצגות כמלבן שתופס חלק מהפריסה של האפליקציה. יכול להיות שיתבצע רענון אוטומטי שלהם אחרי פרק זמן מסוים. הרענון האוטומטי יגרום לכך שתוצג למשתמשים מודעה חדשה במרווחי זמן קבועים, גם אם הם יישארו באותו מסך באפליקציה. כמו כן, מודעות באנר הן פורמט המודעה הפשוט ביותר להטמעה.
מעברון
יחידות של מודעות מעברון משמשות להצגה של מודעות במסך מלא באפליקציה. למקם אותן במיקום הטבעי הפסקות ומעברים בממשק של האפליקציה, למשל לאחר השלמת שלב באפליקציית משחקים.
מותאם
מודעות מותאמות הן מודעות שבהן אפשר להתאים אישית את הדרך שבה נכסים דיגיטליים, כמו כותרות קריאות לפעולה מוצגות באפליקציות שלכם. אם תגדירו את המודעה בעצמכם, תוכלו ליצור הצגת מודעות טבעית ולא פולשנית, שיכולה להוסיף למשתמשים תוכן עשיר חוויה אישית.
ההטבה הופעלה
יחידות של מודעות מתגמלות מאפשרות למשתמשים לשחק במשחקים, להשתתף בסקרים או לצפות בסרטונים כדי לזכות בפרסים בתוך האפליקציה, כמו מטבעות, עוד חיים או נקודות. אפשר להגדיר תגמולים שונים ליחידות מודעות שונות, ולציין את ערכי התגמול פריטים שהמשתמש קיבל.
מודעות מעברון מתגמלות
מודעת מעברון מתגמלת היא סוג חדש של פורמט מודעה שמבוסס על תמריצים, שמאפשר לכם להציע תגמולים, כמו מטבעות או תוספת חיים, על מודעות שמופיעות באופן אוטומטי. במהלך מעברים טבעיים בין אפליקציות.
בניגוד למודעות מתגמלות, המשתמשים לא נדרשים להביע הסכמה כדי לצפות במודעות מתגמלות מעברון.
במקום לבקש את ההסכמה לשימוש במודעות מתגמלות, מודעות מעברון מתגמלות צריכות לכלול מסך פתיחה שמציין מהו התגמול ומאפשר למשתמשים לבטל את ההסכמה.
הטמעה של מודעות מעברון מתגמלות
מודעה בפתיחת אפליקציה
מודעה בפתיחת אפליקציה היא פורמט מודעה שמופיע כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה של האפליקציה.
הטמעה של מודעות בפתיחת אפליקציה