ตั้งค่าโฆษณาแบนเนอร์

เลือกแพลตฟอร์ม: Android Android iOS Unity Flutter

มุมมองแบนเนอร์คือโฆษณาแบบรูปภาพหรือข้อความรูปสี่เหลี่ยมผืนผ้าที่ใช้พื้นที่บนหน้าจอ โดยจะแสดงอยู่บนหน้าจอในระหว่างที่ผู้ใช้โต้ตอบกับแอป และรีเฟรชโดยอัตโนมัติหลังจากผ่านไประยะเวลาหนึ่ง หากคุณเพิ่งเริ่มใช้การโฆษณาบนอุปกรณ์เคลื่อนที่ โฆษณาเหล่านี้จะเป็นจุดเริ่มต้นที่ดี กรณีศึกษา

คู่มือนี้จะแสดงวิธีผสานรวมมุมมองแบนเนอร์ลงในแอป Unity นอกจากข้อมูลโค้ดและวิธีการแล้ว ยังมีข้อมูลเกี่ยวกับการปรับขนาดแบนเนอร์อย่างเหมาะสมและลิงก์ไปยังแหล่งข้อมูลเพิ่มเติมด้วย

ข้อกำหนดเบื้องต้น

ตั้งค่า Google Mobile Ads Unity Plugin ก่อนดำเนินการต่อ

ทดสอบด้วยโฆษณาทดสอบเสมอ

โค้ดตัวอย่างต่อไปนี้มีรหัสหน่วยโฆษณาที่คุณใช้เพื่อขอ โฆษณาทดสอบได้ ซึ่งได้รับการกำหนดค่าเป็นพิเศษให้แสดงโฆษณาทดสอบแทน โฆษณาจริงสำหรับทุกคำขอ จึงใช้งานได้อย่างปลอดภัย

อย่างไรก็ตาม หลังจากลงทะเบียนแอปใน อินเทอร์เฟซเว็บของ AdMob และสร้างรหัสหน่วยโฆษณาของคุณเองเพื่อใช้ในแอปแล้ว ให้กำหนดค่าอุปกรณ์เป็นอุปกรณ์ทดสอบ อย่างชัดแจ้งในระหว่าง การพัฒนา

เริ่มต้น 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.
        });
    }
}

หากใช้สื่อกลาง ให้รอจนกว่าจะมีการเรียกกลับก่อนโหลดโฆษณา เพื่อให้แน่ใจว่าอะแดปเตอร์สื่อกลางทั้งหมดได้รับการเริ่มต้นแล้ว

ตัวอย่าง BannerView

โค้ดตัวอย่างต่อไปนี้แสดงรายละเอียดวิธีใช้มุมมองแบนเนอร์ ในตัวอย่างนี้ ให้สร้างอินสแตนซ์ของมุมมองแบนเนอร์ ใช้ AdRequest เพื่อโหลดโฆษณาลงในมุมมองแบนเนอร์ แล้วขยายขีดความสามารถโดยจัดการเหตุการณ์วงจรการทำงาน

สร้างมุมมองแบนเนอร์

ขั้นตอนแรกในการใช้มุมมองแบนเนอร์คือการสร้างอินสแตนซ์ของมุมมองแบนเนอร์

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

แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา

คอนสตรักเตอร์ของ BannerView มีพารามิเตอร์ต่อไปนี้

• adUnitId: รหัสหน่วยโฆษณาของโฆษณาแบนเนอร์ที่จะโหลด
• AdSize: ขนาดแบนเนอร์ที่ต้องการใช้
• AdPosition: ตำแหน่งที่จะวางมุมมองแบนเนอร์

(ไม่บังคับ) สร้างมุมมองแบนเนอร์ที่มีตำแหน่งที่กำหนดเอง

หากต้องการควบคุมตำแหน่งที่จะวางมุมมองแบนเนอร์บนหน้าจอได้มากขึ้นกว่าค่า AdPosition ให้ใช้เครื่องมือสร้างที่มีพิกัด x และ y เป็นพารามิเตอร์

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

มุมซ้ายบนของมุมมองแบนเนอร์จะอยู่ที่ค่า x และ y ที่ส่งไปยังคอนสตรักเตอร์ โดยจุดเริ่มต้นคือมุมซ้ายบนของหน้าจอ

(ไม่บังคับ) สร้างมุมมองแบนเนอร์ที่มีขนาดที่กำหนดเอง

นอกจากการใช้ค่าคงที่ 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);
BannerViewSnippets.cs

โหลดโฆษณาแบนเนอร์

หากต้องการโหลดโฆษณา ให้สร้าง AdRequest แล้วส่งไปยังเมธอด LoadAd()

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

รอเหตุการณ์มุมมองแบนเนอร์

หากต้องการปรับแต่งลักษณะการทำงานของโฆษณา คุณสามารถเชื่อมต่อกับเหตุการณ์ต่างๆ ในวงจรการทำงานของโฆษณา เช่น การโหลด การเปิด หรือการปิด หากต้องการรอเหตุการณ์เหล่านี้ ให้ลงทะเบียนผู้รับมอบสิทธิ์

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.
};
BannerViewSnippets.cs

ทำลายมุมมองแบนเนอร์

หากต้องการทำลายแบนเนอร์ ให้เรียกใช้เมธอด Destroy() เพื่อปล่อยทรัพยากร

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

สำหรับแบนเนอร์ที่โหลดไม่สำเร็จ เราขอแนะนำให้รีเฟรชแบนเนอร์แทนการทำลายและสร้างแบนเนอร์ใหม่ ดูรายละเอียดได้ที่ รีเฟรชโฆษณา

รีเฟรชโฆษณา

หากกำหนดค่าหน่วยโฆษณาให้รีเฟรช คุณไม่จำเป็นต้องขอโฆษณาอื่นเมื่อโฆษณาโหลดไม่สำเร็จ Google Mobile Ads Unity Plugin จะใช้ตามอัตราการรีเฟรช ที่คุณระบุไว้ใน UI ของ AdMob หากไม่ได้เปิดใช้การรีเฟรช ให้ส่งคำขอใหม่ ดูรายละเอียดเพิ่มเติมเกี่ยวกับการรีเฟรชหน่วยโฆษณา เช่น การตั้งค่าอัตราการรีเฟรช ได้ที่ ใช้การรีเฟรชอัตโนมัติสำหรับโฆษณาแบนเนอร์

ขนาดของแบนเนอร์

แบนเนอร์แบบปรับขนาดได้ขนาดใหญ่มีรูปแบบที่ใหญ่ขึ้นซึ่งออกแบบมาสำหรับเลย์เอาต์ที่ไม่เลื่อน แบนเนอร์เหล่านี้มีความสูงสูงสุดมากกว่าแบนเนอร์แบบปรับขนาดได้ที่ตรึงไว้แบบมาตรฐาน (สูงสุด 20% ของความสูงหน้าจอ ระหว่าง 50 ถึง 150 dp) พื้นที่ที่เพิ่มขึ้นนี้ได้รับการปรับให้เหมาะกับเนื้อหาวิดีโอ

ตารางต่อไปนี้แสดงขนาดแบนเนอร์มาตรฐาน

แหล่งข้อมูลเพิ่มเติม

• ตัวอย่าง HelloWorld: การใช้งานโฆษณาทุกรูปแบบแบบมินิมัล

• กรณีการใช้งานตัวอย่าง