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

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

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

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

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

• משתמשים ב-Unity Editor בגרסה 2019.4 ואילך.
  • מומלץ להשתמש בגרסה 2022.2 ומעלה.
• כדי לפרוס ל-iOS
  • ‫Xcode מגרסה 16.0 ואילך
  • יעד iOS 13.0 ואילך
  • CocoaPods
• כדי לפרוס ל-Android
  • רמת API מינימלית ב-Android‏ 24 ואילך
  • רמת ה-API לטירגוט ב-Android היא 35 ומעלה

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

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

OpenUPM

1. מאחזרים את תג הגרסה של הגרסה האחרונה. התג שהוחזר, ללא הקידומת v, הוא גרסה Google Mobile Ads Unity Plugin.

   • ‫macOS ו-Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • ‫Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. משנים את הקובץ Packages/manifest.json כדי להוסיף את הרישום והתלות של OpenUPM בהיקף, באמצעות הגרסה שהתקבלה מהפקודה הקודמת:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.5.0"
     }
   }
   

הסרת נכסי פלאגין .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 (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומייבאים את כל הפריטים.

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

בתפריט של Unity Editor, בוחרים באפשרות נכסים > Google Mobile Ads > הגדרות.

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

‫Google Mobile Ads Unity Plugin שומר את ההגדרות האלה כטקסט בקובץ ההגדרות Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

אתחול ה-SDK

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

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

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

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

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

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

אינטראקציה עם אובייקטים של Unity בשרשור הראשי

‫Google Mobile Ads Unity Plugin מעלה אירועים של מודעות בשרשור ברקע. אם קריאות חוזרות (callback) של מודעות מתקשרות עם אובייקטים של Unity, כמו UnityEngine, צריך לתזמן את העבודה הזו באופן מפורש בשרשור הראשי של Unity באמצעות השיטה MobileAdsEventExecutor.ExecuteInUpdate. פרטים נוספים על ההטמעה זמינים במאמר העלאת אירועים שקשורים למודעות בשרשור הראשי של Unity.

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

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

מודעת באנר

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

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

מעברון

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

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

מותאמת

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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