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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

הפלאגין של 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‏ 35 ומעלה ב-Android

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

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

ייבוא הפלאגין של מודעות לנייד ל-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. פותחים את התפריט של מנהל החבילות על ידי בחירה באפשרות Window > Package Manager בתפריט של Unity.

4. בתפריט הנפתח של היקף הניהול, בוחרים באפשרות My Registries.

   

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

אופציונלי: השבתת External Dependency Manager

אם אתם מנהלים ספריות של Android ו-iOS באמצעות כלי build משלכם, אתם יכולים להשבית את החבילה com.unity.external-dependency-manager:

ב-Unity Editor, בוחרים באפשרות Window > Package Manager ומסירים את החבילה External Dependency Manager (com.unity.external-dependency-manager). הסרת החבילה הזו מבטלת את הסימון של Enable External Dependency Manager (הפעלת מנהל התלות החיצוני) בקטע Assets (נכסים) > Google Mobile Ads > Settings (הגדרות).

הערה: מחיקת הקובץ GoogleMobileAdsSettings.asset מאפסת את ההגדרות ומתקינה מחדש את החבילה com.unity.external-dependency-manager בייבוא הבא או בטעינה הבאה של Editor. כדי להתקין מחדש את החבילה מאוחר יותר, בוחרים באפשרות Assets > Google Mobile Ads > Settings (נכסים > מודעות לנייד ב-Google > הגדרות) ולוחצים על Enable External Dependency Manager (הפעלת מנהל התלות החיצוני).

התקנת External Dependency Manager מדור קודם

אם אתם משתמשים בפרויקט ב-Unity 2022.2 או בגרסה קודמת, אתם יכולים להתקין את החבילה הקודמת של Google,‏ com.google.external-dependency-manager, אחרי שאתם משביתים את החבילה של Unity:

• מורידים את קובץ ה-.unitypackage העדכני מדף הגרסאות של External Dependency Manager for Unity ובוחרים באפשרות Assets > Import Package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית).

• מריצים את הפקודה הבאה ב-CLI של OpenUPM:

  openupm add com.google.external-dependency-manager

הגדרה ידנית של יחסי תלות מקומיים

אם אתם לא משתמשים בחבילה של External Dependency Manager, אתם צריכים להוסיף את הספריות הנדרשות מהקבצים Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml ו-Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml לקובצי ה-build:

• ב-Android, בוחרים באפשרות Edit > הגדרות הפרויקט > Player > Android > Publishing Settings > Build ומפעילים את Custom Main Gradle Template. מוסיפים את הספריות הנדרשות מהקבצים GoogleMobileAdsDependencies.xml ו-GoogleUmpDependencies.xml לבלוק dependencies בקובץ Assets/Plugins/Android/mainTemplate.gradle:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  מוסיפים גם את החבילות androidx.constraintlayout:constraintlayout,‏ androidx.lifecycle:lifecycle-process ו-androidx.fragment:fragment באמצעות הגרסאות שבקובץ GoogleMobileAdsDependencies.xml.

• ב-iOS, מייצאים את פרויקט Xcode. מוסיפים את ה-pods הנדרשים מהקבצים GoogleMobileAdsDependencies.xml ו-GoogleUmpDependencies.xml לקובץ Podfile בתיקיית הפרויקט שייצאתם:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  לאחר מכן מריצים את הפקודה הבאה בתיקיית הפרויקט של iOS שייצאתם:

  pod install --repo-update

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

בעורך של Unity, בוחרים בתפריט באפשרות Assets > Google Mobile Ads > Settings.

מזינים את מזהה האפליקציה ב-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 מעלה אירועי מודעות בשרשור ברקע. אם קריאות חוזרות (callbacks) של מודעות יוצרות אינטראקציה עם אובייקטים של Unity, כמו UnityEngine, צריך לתזמן את הפעולה הזו באופן מפורש ב-thread הראשי של Unity באמצעות השיטה MobileAdsEventExecutor.ExecuteInUpdate. פרטים נוספים על ההטמעה זמינים במאמר הפעלת אירועי מודעות ב-thread הראשי של Unity.

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

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

מודעת באנר

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

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

מעברון

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

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

מותאמת

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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