שנתחיל?

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

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

רמת ה-API ב-Android מוגדרת ב-Project Settings > Player > Android > הגדרות אחרות > הגדרות אחרות.

ייבוא התוסף 'מודעות לנייד ל-Unity'

הפלאגין של Google Mobile Ads ל-Unity מופץ כ-.unitypackage במאגרים של GitHub ו-OpenUPM.

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

ייבוא מ-GitHub

1. מורידים את הגרסה האחרונה של .unitypackage מ-GitHub.
2. כדי לייבא את הקובץ .unitypackage, בוחרים באפשרות נכסים > ייבוא חבילה > חבילה מותאמת אישית ומייבאים את כל הפריטים בתפריט Unity.

ייבוא באמצעות OpenUPM

התקנת הרישום OpenUPM באמצעות OpenUPM CLI

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

openupm add com.google.ads.mobile

התקן את הרישום OpenUPM באופן ידני

1. פותחים את הגדרות מנהל החבילות על ידי בחירה באפשרות התפריט Unity: Edit > Project Settings > Package Manager.

2. מוסיפים את OpenUPM כרישום היקף לחלון של מנהל החבילות:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

התקנת החבילה של מודעות Google לנייד ל-Unity

1. פותחים את תפריט מנהל החבילות על ידי בחירה באפשרות התפריט של Unity: Window > Package Manager.

2. בתפריט הנפתח של היקף ההרשאות, בוחרים באפשרות הרשמים שלי.

   

3. בוחרים את החבילה של Google Mobile Ads for Unity מרשימת החבילות ולוחצים על Install.

הסרת פריטים מיובאים ישנים

כדי להסיר את הייבוא של .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

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

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

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

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

Android

נכנסים אל Project Settings > Player > Android > Publishing Settings > Build, ובוחרים באפשרות:

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

בעורך Unity, בוחרים באפשרות Assets > External Dependency Manager > Android resolver > Solution כדי שהספרייה של Unity External Dependency Manager תעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

iOS

לא נדרשים שלבים נוספים כדי לכלול את Google Mobile Ads SDK בפרויקט Unity.

זוהו יחסי תלות ב-iOS באמצעות CocoaPods. הפעולה של CocoaPods מתבצעת כשלב לאחר בנייה.

• כשמשתמשים ב-Unity 5.6 ואילך, נוצר xcworkspace שכולל את ספריות התלות הנדרשות. משתמשים ב-xcworkspace שנוצר במקום בפרויקט Xcode הרגיל.
• כשמשתמשים בגרסאות קודמות של Unity, יחסי התלות נכללים בפרויקט ה-Xcode הסטנדרטי.

יחסי התלות של הפלאגין 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 => { });
    }
}

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

בחירת פורמט מודעה

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

כרזה

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

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

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

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

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

מותאם

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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