שנתחיל?

הפלאגין של 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 > נגן > Android > הגדרות אחרות > הגדרות אחרות.

ייבוא הפלאגין של מודעות לנייד ל-Unity

OpenUPM-CLI

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

openupm add com.google.ads.mobile

הסרת נכסי הפלאגין .unitypackage

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

  • Assets/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 עריכה > הגדרות הפרויקט > מנהל החבילות.

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

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

  3. פותחים את תפריט מנהל החבילות על ידי בחירה ב-Unity אפשרות בתפריט חלון > מנהל החבילות.

  4. מגדירים את התפריט הנפתח של היקף ההרשאות ברמת חשבון הניהול כדי לבחור באפשרות My Registries (הרישומים שלי).

  5. בוחרים את החבילה Google Mobile Ads for Unity מתוך רשימת החבילות. ומקישים על התקנה.

הסרה של .unitypackage נכסי פלאגין

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

  • Assets/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 ספריית המקודד. הספרייה הזו מיועד לשימוש על ידי כל פלאגין של Unity שדורש גישה למכשירים ספציפיים ל-Android ספריות, כמו AAR, או iOS CocoaPods. הוא מספק ליישומי פלאגין של Unity יכולת להצהיר על יחסי תלות, ואז הם מזוהים אוטומטית ומועתקים אל בפרויקט ב-Unity.

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

Android

עוברים אל Project Settings (הגדרות הפרויקט)‏ > Player (נגן)‏ > Android (Android)‏ > Publishing Settings (הגדרות פרסום)‏ > Build (גרסה) ובוחרים באפשרות:

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

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

iOS

Unity ל-iOS משתמשת ב-CocoaPods כדי לזהות ולנהל יחסי תלות. במסמכי התיעוד של CocoaPods, דרישות ספציפיות או שלבים לפתרון בעיות שקשורים למכשיר iOS של יחסי התלות.

יחסי התלות של יישומי הפלאגין של Google Mobile Ads Unity מפורטים כאן Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml

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

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

מזינים את מזהה האפליקציה ב-Ad Manager בכל שדה, ל-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 מציע כמה פורמטים שונים של מודעות, כך שאפשר לבחור את הפורמט כדי ליהנות מחוויית המשתמש הטובה ביותר.

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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