מתחילים

בחירת פלטפורמה: Android iOS Unity Flutter

הפלאגין Google Mobile Ads Unity מאפשר למפתחים ב-Unity להציג מודעות לנייד של Google באפליקציות ל-Android ול-iOS בלי לכתוב קוד Java או Objective-C. התוסף מספק ממשק C# לשליחת בקשות להצגת מודעות, שמשמש סקריפטים של C# בפרויקט Unity.

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

דרישות מוקדמות

  • שימוש ב-Unity Editor מגרסה 2019.4 ואילך
  • כדי לפרוס ל-iOS
    • ‫Xcode 16.0 ואילך
    • טרגוט ל-iOS מגרסה 12.0 ואילך
    • CocoaPods
  • כדי לפרוס ל-Android
    • רמת ה-API המינימלית ב-Android היא 23 ומעלה
    • טירגוט ל-Android API ברמה 34 ומעלה

רמת ה-API של Android מוגדרת בהגדרות הפרויקט > Player > Android > הגדרות אחרות > הגדרות אחרות.

ייבוא הפלאגין Mobile Ads for 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

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

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

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

  3. פותחים את תפריט מנהל החבילות על ידי בחירה באפשרות בתפריט Unity‏ Window > Package Manager (חלון > מנהל החבילות).

  4. בתפריט הנפתח 'היקף חשבון הניהול' בוחרים באפשרות המאגרים שלי.

  5. בוחרים את החבילה 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

  1. מורידים את הגרסה האחרונה של .unitypackage מ-GitHub.
  2. מייבאים את הקובץ .unitypackage על ידי בחירה באפשרות בתפריט Unity‏ Assets > Import package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומייבאים את כל הפריטים.

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

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

כדי לוודא שהפרויקט כולל את כל התלות:

Android

עוברים אל Project Settings > Player > 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 Editor, בוחרים באפשרות Assets > Google Mobile Ads > Settings (נכסים > מודעות לנייד של Google > הגדרות).

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

אתחול ה-SDK

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

דוגמה לאופן השימוש ב-MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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

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

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

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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