ปลั๊กอิน 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
- API ของ Android ระดับ 21 ขึ้นไปเป็นอย่างน้อย
- กำหนดเป้าหมาย Android API ระดับ 31 ขึ้นไป
ตั้งค่าระดับ API ของ Android ในการตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น > Android > การตั้งค่าอื่นๆ > การตั้งค่าอื่นๆ
นำเข้าปลั๊กอินโฆษณาบนอุปกรณ์เคลื่อนที่สำหรับ Unity
OpenUPM-CLI
หากติดตั้ง OpenUPM CLI ไว้แล้ว คุณจะติดตั้งรีจิสทรี OpenUPM ด้วยคำสั่งต่อไปนี้ได้
openupm add com.google.ads.mobile
นำเนื้อหาปลั๊กอิน .unitypackage
รายการออก
หากย้ายข้อมูลจากการใช้ .unitypackage
ไปใช้ OpenUPM คุณต้องถอนการติดตั้งเนื้อหาจากตำแหน่งเดิมด้วยตนเอง นำไดเรกทอรีต่อไปนี้ที่นำเข้ามาจาก .unitypackage
ออก
- เนื้อหา/เครื่องมือจัดการทรัพยากรภายนอก
- เนื้อหา/Google MobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- เปิดการตั้งค่าตัวจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity แก้ไข > การตั้งค่าโปรเจ็กต์ > ตัวจัดการแพ็กเกจ
เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตในหน้าต่างตัวจัดการแพ็กเกจดังนี้
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
เปิดเมนูตัวจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity หน้าต่าง > ตัวจัดการแพ็กเกจ
ตั้งค่าเมนูแบบเลื่อนลงของขอบเขตเครื่องมือจัดการเพื่อเลือก My Registries
เลือกแพ็กเกจ Google Mobile Ads for Unity จากรายการแพ็กเกจ แล้วกดติดตั้ง
นำเนื้อหาปลั๊กอิน .unitypackage
รายการออก
หากย้ายข้อมูลจากการใช้ .unitypackage
ไปใช้ OpenUPM คุณต้องถอนการติดตั้งเนื้อหาจากตำแหน่งเดิมด้วยตนเอง นำไดเรกทอรีต่อไปนี้ที่นำเข้ามาจาก .unitypackage
ออก
- เนื้อหา/เครื่องมือจัดการทรัพยากรภายนอก
- เนื้อหา/Google MobileAds
- 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 จะกระจายไปกับไลบรารีรีโซลเวอร์บริการ Unity Play ไลบรารีนี้มีไว้สำหรับใช้โดยปลั๊กอิน Unity ที่ต้องเข้าถึงไลบรารีเฉพาะของ Android เช่น AAR หรือ CocoaPods ของ iOS ซึ่งช่วยให้ปลั๊กอิน Unity ประกาศทรัพยากร Dependency ได้ ซึ่งจากนั้นจะมีการแก้ไขและคัดลอกโดยอัตโนมัติไปยังโปรเจ็กต์ Unity ของคุณ
ทำตามขั้นตอนต่อไปนี้เพื่อให้โปรเจ็กต์มีทรัพยากร Dependency ทั้งหมด
Android
ไปที่การตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น > Android > การตั้งค่าการเผยแพร่ > สร้าง แล้วเลือกดังนี้
- เทมเพลต Gradle หลักที่กำหนดเอง
- เทมเพลตพร็อพเพอร์ตี้ Gradle ที่กำหนดเอง
ในตัวแก้ไข Unity ให้เลือกเนื้อหา > เครื่องมือจัดการทรัพยากร Dependency ภายนอก > ตัวแก้ไข Android > แก้ไข เพื่อให้ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกของ Unity คัดลอกทรัพยากร Dependency ที่ประกาศลงในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
iOS
Unity สำหรับ iOS จะใช้ CocoaPods เพื่อระบุและจัดการทรัพยากร Dependency ดูข้อกำหนดเฉพาะหรือขั้นตอนการแก้ปัญหาที่เกี่ยวข้องกับทรัพยากร Dependency ของ iOS ได้ในเอกสารประกอบของ CocoaPods
ทรัพยากร Dependency ของปลั๊กอิน Google Mobile Ads Unity จะแสดงอยู่ใน Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
ตั้ง Ad Manager รหัสแอป
ในตัวแก้ไข Unity ให้เลือกชิ้นงาน > โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google > การตั้งค่าจากเมนู
ป้อน Android และ iOS รหัสแอป Ad Manager ในแต่ละช่อง
เริ่มต้น SDK
ก่อนที่จะโหลดโฆษณา ให้แอปของคุณเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โดยเรียกใช้ MobileAds.Initialize()
คุณต้องทำเพียงครั้งเดียวเท่านั้น
ถ้าจะให้ดีควรทำตอนเปิดแอป
ต่อไปนี้คือตัวอย่างวิธีเรียก Initialize()
ภายในเมธอด Start()
ของสคริปต์ที่แนบกับ GameObject
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
หากคุณใช้สื่อกลาง ให้รอจนกว่าจะมี Callback เกิดขึ้นก่อนโหลดโฆษณา เพื่อให้แน่ใจว่าอะแดปเตอร์สื่อกลางทั้งหมดเริ่มต้นทำงานแล้ว
เลือกรูปแบบโฆษณา
ตอนนี้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google รวมอยู่ในแอป Unity แล้วเมื่อทำให้ใช้งานได้ในแพลตฟอร์ม Android หรือ iOS ตอนนี้คุณก็พร้อมติดตั้งใช้งานโฆษณาแล้ว AdMob มีรูปแบบโฆษณาต่างๆ มากมายเพื่อให้คุณเลือกรูปแบบที่มอบประสบการณ์ของผู้ใช้ที่ดีที่สุดได้
แบนเนอร์
หน่วยโฆษณาแบนเนอร์จะแสดงโฆษณาสี่เหลี่ยมผืนผ้าซึ่งใช้เนื้อที่เลย์เอาต์ส่วนหนึ่งของแอป อุปกรณ์นี้จะรีเฟรชโดยอัตโนมัติหลังจากระยะเวลาที่ตั้งไว้ ซึ่งหมายความว่าผู้ใช้ดูโฆษณาใหม่เป็นระยะๆ แม้จะอยู่ดูหน้าจอเดิมในแอปก็ตาม โฆษณาประเภทนี้ยังเป็นรูปแบบโฆษณาที่ใช้งานได้ง่ายที่สุดอีกด้วย
โฆษณาคั่นระหว่างหน้า
หน่วยโฆษณาคั่นระหว่างหน้าจะแสดงโฆษณาแบบเต็มหน้าในแอปของคุณ วางโฆษณาที่จุดพักหรือจุดเปลี่ยนตามปกติในอินเทอร์เฟซของแอป เช่น หลังจากเล่นเกมผ่านด่าน
เนทีฟ
โฆษณาเนทีฟคือโฆษณาที่คุณสามารถปรับแต่งวิธีแสดงเนื้อหา เช่น บรรทัดแรกและคำกระตุ้นการตัดสินใจในแอปได้ การจัดรูปแบบโฆษณาด้วยตนเองจะทำให้คุณสร้างการนำเสนอโฆษณาที่เป็นธรรมชาติและไม่รบกวนสายตา ซึ่งสามารถเพิ่มประสบการณ์ของผู้ใช้ได้อย่างดี
ได้รับรางวัลแล้ว
หน่วยโฆษณาที่มีการให้รางวัลช่วยให้ผู้ใช้เล่นเกม ทำแบบสำรวจ หรือดูวิดีโอเพื่อรับรางวัลในแอปได้ เช่น เหรียญ จำนวนชีวิตเพิ่ม หรือคะแนน คุณสามารถกำหนดรางวัลที่ต่างกันสำหรับหน่วยโฆษณาต่างๆ และระบุมูลค่าของรางวัลและไอเท็มที่ผู้ใช้ได้รับ