שנתחיל?

הפלאגין של 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 ומעלה
  • טירגוט לפי רמת API של Android 31 ומעלה

• המלצה: יצירת חשבון AdMob ורישום אפליקציה ל-Android או ל-iOS

רמת ה-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:

• Asset/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 עריכה > הגדרות פרויקט > 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:

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

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

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

חשוב: עליכם להשתמש בגרסה העדכנית ביותר של Google Mobile Ads SDK כדי לקבל גישה לכל תכונות התאימות לפרטיות.

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

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.

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

בעורך Unity, בוחרים מהתפריט את Assets > Google Mobile Ads > Settings (נכסים > מודעות Google לנייד > הגדרות).

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

הפעלת ה-SDK

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

אזהרה: ניתן לטעון מראש את המודעות באמצעות Google Mobile Ads SDK או ערכות ה-SDK של השותף בתהליך בחירת הרשת (Mediation) לאחר הקריאה ל-MobileAds.Initialize(). אם אתם צריכים לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), עליכם להגדיר סימונים ספציפיים לבקשה, כמו tagForChildDirectedTreatment או tag_for_under_age_of_consent, או לבצע פעולות אחרות לפני טעינת המודעות. הקפידו לעשות זאת לפני ההפעלה של Google Mobile Ads SDK.

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

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

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

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

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

כרזה

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

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

פרסומת מרווח ביניים

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

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

מותאם

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

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

ההטבה הופעלה

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

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

מודעות מעברון מתגמלות

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

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

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

הטמעה של מודעות מעברון מתגמלות

מודעות בפתיחת אפליקציה

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

הטמעה של מודעות בפתיחת אפליקציה