תחילת העבודה

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

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

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

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

• הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.0.0 ואילך.
• קוראים את המדריך לתחילת העבודה.
• הורדה ולהתקין את תוסף המודעות המותאמות.

טעינת פורמטים של מודעות מותאמות

מודעות נתמכות נטענות באמצעות המחלקה AdLoader, שיש לה מחלקה משלה, AdLoader.Builder, שמאפשרת להתאים אישית את המודעה במהלך היצירה. השיטה ForNativeAd() מגדירה את AdLoader לטיפול במודעות מותאמות.

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
}

הרשמה לאירועי מודעות של AdLoader

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

OnNativeAdLoaded

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

OnAdFailedToLoad

מופעל כשמודעה מותאמת לא נטענת.

טעינת המודעה

אחרי שתסיימו ליצור את AdLoader, תוכלו להפעיל את השיטה LoadAd() כדי לבקש מודעה:

adLoader.LoadAd(new AdRequest.Builder().Build());

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

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

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
    adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
    adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

טיפול בטעינות מודעות שנכשלו

האירוע OnAdFailedToLoad הוא מסוג EventHandle<AdFailedToLoadEventArgs>. בהמשך מוצג ניתוח של הסיבה לכשל בטעינת המודעות מהאירוע הזה.

private void RequestNativeAd() {
    ...
    adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}

private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
    Debug.Log("Native ad failed to load: " + args.Message);
}

הצגת מודעה מותאמת

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

טיפול בכמות המודעות

האירוע OnNativeAdLoaded הוא מסוג EventHandler<NativeAdEventArgs>. את המודעה, בתוך אובייקט NativeAd, ניתן לאחזר מתוך NativeAdEventArgs כפי שמוצג:

private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
}

אחזור נכסים של מודעות מותאמות

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

private bool nativeAdLoaded;
private NativeAd nativeAd;

void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for the icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        // Get string for headline asset of native ad.
        string headline = this.nativeAd.GetHeadlineText();
    }
}

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}

חשוב לזכור שצריך לגשת לנכסים שיצורפו למודעות רק בשרשור הראשי. לדוגמה, מה-method Update() של סקריפט Unity. כמו כן, חשוב לזכור שהנכסים הבאים לא מובטח שיהיו קיימים, וצריך לבדוק אותם לפני מוצגים:

• GetStarRating()
• GetStore()
• GetPrice()
• GetAdvertiser()
• GetIconTexture()

נכס AdChoices

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

רישום GameObjects עבור נכס מודעה

כדי שנכס המודעה יוצג באפליקציה שלכם ב-Unity, עליכם לרשום את GameObject. אם הרישום מצליח, השיטה ששימשה לרישום GameObject מחזירה bool. עבור List<GameObject>, ה-method מחזירה int שמציין את הספירה של GameObject שנרשמו בהצלחה.

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

if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
    // Handle failure to register the icon ad asset.
}

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

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

// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;

// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;

// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();

הדגמה (דמו)

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

private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
        icon.transform.position = new Vector3(1, 1, 1);
        icon.transform.localScale = new Vector3(1, 1, 1);
        icon.GetComponent<Renderer>().material.mainTexture = iconTexture;

        // Register GameObject that will display icon asset of native ad.
        if (!this.nativeAd.RegisterIconImageGameObject(icon))
        {
            // Handle failure to register ad asset.
        }
    }
}
...

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}