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

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

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

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

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

לפני שממשיכים, מגדירים את Google Mobile Ads Unity Plugin.

תמיד צריך לבדוק באמצעות מודעות בדיקה

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

מפעילים את Google Mobile Ads Unity Plugin

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

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

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

דוגמה ל-BannerView

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

יצירת תצוגת באנר

השלב הראשון בשימוש בתצוגת באנר הוא ליצור מופע של תצוגת באנר.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

מחליפים את AD_UNIT_ID במזהה יחידת המודעות.

ל-constructor של BannerView יש את הפרמטרים הבאים:

  • ‫adUnitId: מזהה יחידת המודעות של מודעת הבאנר שרוצים לטעון.
  • ‫AdSize: גודל הבאנר שבו רוצים להשתמש.
  • ‫AdPosition: המיקום שבו רוצים להציב את תצוגות הבאנר.

(אופציונלי) יצירת תצוגת מודעת באנר במיקום מותאם אישית

כדי לקבל שליטה רבה יותר על המיקום של תצוגת הבאנר במסך, מעבר למה שמוצע בערכים של AdPosition, משתמשים ב-constructor שכולל קואורדינטות X ו-Y כפרמטרים:

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);

הפינה השמאלית העליונה של תצוגת הבאנר ממוקמת בערכי x ו-y שמועברים ל-constructor, כאשר המקור הוא הפינה השמאלית העליונה של המסך.

(אופציונלי) יצירת תצוגת מודעת באנר בגודל מותאם אישית

בנוסף לשימוש בקבוע AdSize, אפשר גם לציין גודל מותאם אישית למודעה:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);

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

כדי לטעון מודעה, יוצרים AdRequest ומעבירים אותו ל-method‏ LoadAd().

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());

האזנה לאירועים של תצוגת מודעות באנר

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

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};

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

כדי להשמיד את המודעה, צריך להפעיל את השיטה Destroy() כדי לשחרר משאבים:

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}

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

רענון מודעה

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

מודעות באנר מותאמות גדולות הן פורמט גדול יותר שמיועד לפריסות ללא גלילה. בהשוואה למודעות באנר מותאמות ומעוגנות רגילות, במודעות האלה הגובה המקסימלי יכול להיות גדול יותר (עד 20% מגובה המסך, בין 50 ל-150dp). השטח המוגדל הזה מותאם לקטע וידאו.

בטבלה הבאה מפורטים הגדלים הסטנדרטיים של מודעות באנר:

גודל ב-dp (רוחב x גובה) תיאור זמינות ערך קבוע של AdSize
320x50 כרזות רגילות טלפונים וטאבלטים BANNER
320x100 מודעת באנר גדולה טלפונים וטאבלטים LARGE_BANNER
300x250‎ מלבן בינוני של IAB טלפונים וטאבלטים MEDIUM_RECTANGLE
468x60 מודעת באנר בגודל מלא של IAB טאבלטים FULL_BANNER
728x90 ‫IAB Leaderboard טאבלטים LEADERBOARD
רוחב שצוין x גובה דינמי מודעת באנר מותאמת טלפונים וטאבלטים לא רלוונטי
רוחב המסך x‏ 32|50|90 מודעת באנר חכמה טלפונים וטאבלטים SMART_BANNER
מידע נוסף על מודעות באנר מותאמות, שנועדו להחליף את מודעות הבאנר החכמות.

מקורות מידע נוספים