שנתחיל?

הפלאגין של 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 ואילך

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

רמת ה-API של Android מוגדרת בקטע Project Settings (הגדרות הפרויקט)‏ > Player (נגן)‏ > Android (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 עריכה > הגדרות הפרויקט > מנהל החבילות.

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

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

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

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

   

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

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

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

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

Android

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

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

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

איך מפעילים את ה-SDK

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

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

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

כרזה

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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