ปลั๊กอินโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google สำหรับ Unity ช่วยให้นักพัฒนาแอป Unity แสดงโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ในแอป Android และ iOS ได้โดยไม่ต้องเขียนโค้ด Java หรือ Objective-C ปลั๊กอินมีอินเทอร์เฟซ C# สำหรับการขอโฆษณาที่สคริปต์ C# ใช้ใน โปรเจ็กต์ Unity
คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ต้องการสร้างรายได้จากแอป Unity
ข้อกำหนดเบื้องต้น
- ใช้ Unity Editor 2019.4 ขึ้นไป
- หากต้องการติดตั้งใช้งานใน iOS
- Xcode 16.0 ขึ้นไป
- กำหนดเป้าหมายเป็น iOS 12.0 ขึ้นไป
- CocoaPods
- หากต้องการติดตั้งใช้งานใน Android ให้ทำดังนี้
- ระดับ API ของ Android ขั้นต่ำ 23 ขึ้นไป
- กำหนดเป้าหมายเป็น Android API ระดับ 34 ขึ้นไป
ระดับ Android API จะตั้งค่าในการตั้งค่าโปรเจ็กต์ > Player > Android > การตั้งค่าอื่นๆ > การตั้งค่าอื่นๆ
นําเข้าปลั๊กอินโฆษณาบนอุปกรณ์เคลื่อนที่สําหรับ 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
- เปิดการตั้งค่า Package Manager โดยเลือกตัวเลือกเมนู Unity แก้ไข > การตั้งค่าโปรเจ็กต์ > Package Manager
เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตในหน้าต่าง Package Manager โดยทำดังนี้
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
เปิดเมนู Package Manager โดยเลือกตัวเลือกเมนู Unity Window > Package Manager
ตั้งค่าเมนูแบบเลื่อนลงของขอบเขตผู้จัดการเพื่อเลือกรีจิสทรีของฉัน
เลือกแพ็กเกจ Google Mobile Ads สำหรับ 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
- ดาวน์โหลด
.unitypackage
เวอร์ชันล่าสุดจาก GitHub - นำเข้าไฟล์
.unitypackage
โดยเลือกตัวเลือกเมนู Unity ชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วนำเข้าทุกรายการ
รวมทรัพยากร Dependency ภายนอก
ปลั๊กอิน Unity สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะจัดจำหน่ายพร้อมกับไลบรารีตัวแก้ไขบริการ Google Play ของ Unity ไลบรารีนี้ มีไว้สำหรับใช้โดยปลั๊กอิน Unity ใดๆ ที่ต้องเข้าถึงไลบรารีเฉพาะของ Android เช่น AAR หรือ CocoaPods ของ iOS ซึ่งช่วยให้ปลั๊กอิน Unity สามารถ ประกาศการขึ้นต่อกัน จากนั้นระบบจะแก้ไขและคัดลอกไปยัง โปรเจ็กต์ Unity โดยอัตโนมัติ
ทำตามขั้นตอนต่อไปนี้เพื่อให้โปรเจ็กต์มีทรัพยากร Dependency ทั้งหมด
Android
ไปที่การตั้งค่าโปรเจ็กต์ > เพลเยอร์ > Android > การตั้งค่าการเผยแพร่ > สร้าง แล้วเลือก
- เทมเพลต Gradle หลักที่กำหนดเอง
- เทมเพลตพร็อพเพอร์ตี้ Gradle ที่กำหนดเอง
ในโปรแกรมแก้ไข Unity ให้เลือก Assets > External Dependency Manager > Android
Resolver > Resolve เพื่อให้ไลบรารี Unity External Dependency Manager
คัดลอกการขึ้นต่อกันที่ประกาศไว้ลงในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
iOS
Unity สำหรับ iOS ใช้ CocoaPods เพื่อระบุและจัดการทรัพยากร Dependency โปรดดูข้อกำหนดเฉพาะหรือขั้นตอนการแก้ปัญหาที่เกี่ยวข้องกับ การอ้างอิง iOS ในเอกสารประกอบของ CocoaPods
การอ้างอิงปลั๊กอิน Google Mobile Ads Unity แสดงอยู่ใน
Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
ตั้งค่ารหัสแอป AdMob
ใน Unity Editor ให้เลือกชิ้นงาน > โฆษณา Google ในอุปกรณ์เคลื่อนที่ > การตั้งค่า จากเมนู
ป้อนรหัสแอป AdMob ของ Android และ iOS ในแต่ละช่อง
เริ่มต้น SDK
ก่อนที่จะโหลดโฆษณา ให้แอปเริ่มใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โดย
เรียกใช้ MobileAds.Initialize()
คุณต้องทำขั้นตอนนี้เพียงครั้งเดียว ซึ่งควรทำเมื่อเปิดแอป
ตัวอย่างวิธีเรียกใช้ MobileAds.Initialize()
มีดังนี้
MobileAds.Initialize((InitializationStatus initstatus) =>
{
if (initstatus == null)
{
Debug.LogError("Google Mobile Ads initialization failed.");
return;
}
Debug.Log("Google Mobile Ads initialization complete.");
// Google Mobile Ads events are raised off the Unity Main thread. If you need to
// access UnityEngine objects after initialization,
// use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
// https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
หากใช้สื่อกลาง ให้รอจนกว่าจะมีการเรียกกลับก่อนที่จะโหลดโฆษณา เพื่อให้แน่ใจว่าได้เริ่มต้นใช้งานอะแดปเตอร์สื่อกลางทั้งหมดแล้ว
เลือกรูปแบบโฆษณา
ตอนนี้ Google Mobile Ads SDK จะรวมอยู่ในแอป Unity เมื่อติดตั้งใช้งานในแพลตฟอร์ม Android หรือ iOS ตอนนี้คุณก็พร้อมที่จะใช้โฆษณาแล้ว AdMob มีโฆษณาหลายรูปแบบให้เลือกใช้ เพื่อให้คุณเลือกรูปแบบที่ มอบประสบการณ์ของผู้ใช้ที่ดีที่สุด
ป้ายประกาศ
หน่วยโฆษณาแบนเนอร์จะแสดงโฆษณาทรงสี่เหลี่ยมผืนผ้าซึ่งจะอยู่ในพื้นที่ส่วนหนึ่งของการจัดวางแอป หน่วยโฆษณานี้จะรีเฟรชโดยอัตโนมัติหลังจากช่วงเวลาที่ตั้งไว้ ซึ่งหมายความว่าผู้ใช้จะเห็นโฆษณาใหม่อยู่เรื่อยๆ แม้ว่าจะดูหน้าจอเดิมในแอปก็ตาม และยังเป็นรูปแบบโฆษณาที่นำไปใช้งานได้ง่ายที่สุดอีกด้วย
โฆษณาคั่นระหว่างหน้า
หน่วยโฆษณาคั่นระหว่างหน้าจะแสดงโฆษณาแบบเต็มหน้าในแอป คุณควรวางหน่วยโฆษณาประเภทนี้ที่จุดพักและจุดเปลี่ยนแปลงตามปกติในอินเทอร์เฟซของแอป เช่น หลังจากเล่นเกมผ่านด่าน
ติดตั้งใช้งานโฆษณาคั่นระหว่างหน้า
เนทีฟ
โฆษณาเนทีฟคือโฆษณาที่คุณปรับแต่งวิธีแสดงชิ้นงาน เช่น บรรทัดแรกและ คำกระตุ้นให้ดำเนินการในแอปได้ การจัดรูปแบบโฆษณาด้วยตนเองจะช่วยให้คุณ สร้างการนำเสนอโฆษณาที่เป็นธรรมชาติและไม่รบกวน ซึ่งจะช่วยเพิ่มประสบการณ์การใช้งานที่ยอดเยี่ยม ให้กับผู้ใช้
ได้รับรางวัลแล้ว
หน่วยโฆษณาที่มีการให้รางวัลช่วยให้ผู้ใช้เล่นเกม ทำแบบสำรวจ หรือดูวิดีโอเพื่อ รับรางวัลในแอปได้ เช่น เหรียญ จำนวนชีวิตเพิ่มเติม หรือคะแนน คุณสามารถกำหนดรางวัลให้หน่วยโฆษณาแต่ละหน่วยแตกต่างกันไป และระบุมูลค่าของรางวัลและไอเท็มที่ผู้ใช้จะได้รับ
ติดตั้งใช้งานโฆษณาที่มีการให้รางวัล
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลเป็นรูปแบบโฆษณาที่เสนอสิ่งจูงใจประเภทใหม่ที่ช่วยให้คุณนำเสนอรางวัลได้ เช่น เหรียญหรือไอเท็มเพิ่มชีวิต สําหรับโฆษณาที่ปรากฏโดยอัตโนมัติระหว่างจุดเปลี่ยนหน้าตามปกติของแอป
ผู้ใช้ไม่จําเป็นต้องเลือกดูโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล ซึ่งต่างจากโฆษณาที่มีการให้รางวัล
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัลต้องใช้ หน้าจอแนะนําเพื่อประกาศรางวัล และเปิดโอกาสให้ผู้ใช้เลือกที่จะไม่รับได้ตามที่ต้องการ แทนการส่งข้อความแจ้งให้เลือกรับในโฆษณาที่มีการให้รางวัล
ติดตั้งใช้งานโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
โฆษณาเปิดแอป
โฆษณาเปิดแอปเป็นรูปแบบโฆษณาที่ปรากฏเมื่อผู้ใช้เปิดหรือเปลี่ยนกลับไปที่แอปของคุณ โฆษณาจะวางซ้อนหน้าจอการโหลด