เริ่มต้น

ปลั๊กอิน 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 ขึ้นไป

• คำแนะนำ: สร้างบัญชี AdMob และลงทะเบียนแอป Android หรือ iOS

ตั้งค่าระดับ 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

1. เปิดการตั้งค่าตัวจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity แก้ไข > การตั้งค่าโปรเจ็กต์ > ตัวจัดการแพ็กเกจ

2. เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตในหน้าต่างตัวจัดการแพ็กเกจดังนี้

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. เปิดเมนูตัวจัดการแพ็กเกจโดยเลือกตัวเลือกเมนู Unity หน้าต่าง > ตัวจัดการแพ็กเกจ

4. ตั้งค่าเมนูแบบเลื่อนลงของขอบเขตเครื่องมือจัดการเพื่อเลือก My Registries

   

5. เลือกแพ็กเกจ 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

1. ดาวน์โหลด .unitypackage รุ่นล่าสุดจาก GitHub
2. นำเข้าไฟล์ .unitypackage โดยเลือกตัวเลือกเมนู Unity เนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วนำเข้ารายการทั้งหมด

รวมทรัพยากร Dependency ภายนอก

ปลั๊กอิน Unity สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะกระจายไปกับไลบรารีรีโซลเวอร์บริการ Unity Play ไลบรารีนี้มีไว้สำหรับใช้โดยปลั๊กอิน Unity ที่ต้องเข้าถึงไลบรารีเฉพาะของ Android เช่น AAR หรือ CocoaPods ของ iOS ซึ่งช่วยให้ปลั๊กอิน Unity ประกาศทรัพยากร Dependency ได้ ซึ่งจากนั้นจะมีการแก้ไขและคัดลอกโดยอัตโนมัติไปยังโปรเจ็กต์ Unity ของคุณ

สำคัญ: ใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด เพื่อให้คุณมีสิทธิ์เข้าถึงฟีเจอร์การปฏิบัติตามข้อกำหนดด้านความเป็นส่วนตัวทั้งหมด

ทำตามขั้นตอนต่อไปนี้เพื่อให้โปรเจ็กต์มีทรัพยากร Dependency ทั้งหมด

Android

ไปที่การตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น > Android > การตั้งค่าการเผยแพร่ > สร้าง แล้วเลือกดังนี้

• เทมเพลต Gradle หลักที่กำหนดเอง
• เทมเพลตพร็อพเพอร์ตี้ Gradle ที่กำหนดเอง

ในตัวแก้ไข Unity ให้เลือกเนื้อหา > เครื่องมือจัดการทรัพยากร Dependency ภายนอก > ตัวแก้ไข Android > แก้ไข เพื่อให้ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกของ Unity คัดลอกทรัพยากร Dependency ที่ประกาศลงในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

iOS

ไม่จําเป็นต้องใช้ขั้นตอนเพิ่มเติมเพื่อรวม SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ลงในโปรเจ็กต์ Unity

ระบบจะระบุทรัพยากร Dependency ของ iOS โดยใช้ CocoaPods CocoaPods จะทำงานเป็น ขั้นตอนหลังการสร้าง

• เมื่อใช้ Unity 5.6 ขึ้นไป ระบบจะสร้าง xcworkspace ที่รวมไลบรารีทรัพยากร Dependency ที่จำเป็น ใช้ xcworkspace ที่สร้างขึ้นแทนโปรเจ็กต์ Xcode มาตรฐาน
• เมื่อใช้ Unity เวอร์ชันก่อนหน้า ระบบจะรวมทรัพยากร Dependency ไว้ภายในโปรเจ็กต์ Xcode มาตรฐาน

ทรัพยากร Dependency ของปลั๊กอิน Google Mobile Ads Unity จะแสดงอยู่ใน Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml

ตั้ง AdMob รหัสแอป

ในตัวแก้ไข Unity ให้เลือกชิ้นงาน > โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google > การตั้งค่าจากเมนู

ป้อน Android และ iOS รหัสแอป AdMob ในแต่ละช่อง

เริ่มต้น SDK

ก่อนที่จะโหลดโฆษณา ให้แอปของคุณเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โดยเรียกใช้ MobileAds.Initialize() คุณต้องทำเพียงครั้งเดียวเท่านั้น ถ้าจะให้ดีควรทำตอนเปิดแอป

คำเตือน: SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google หรือ SDK พาร์ทเนอร์สื่อกลางสามารถโหลดล่วงหน้าได้เมื่อเรียกใช้ MobileAds.Initialize() หากต้องการขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ให้ตั้งค่าการแจ้งเฉพาะคำขอ เช่น tagForChildDirectedTreatment หรือ tag_for_under_age_of_consent หรือมิเช่นนั้นให้ดำเนินการก่อนโหลดโฆษณา คุณต้องดำเนินการนี้ก่อนเริ่มใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

ต่อไปนี้คือตัวอย่างวิธีเรียก 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 มีรูปแบบโฆษณาต่างๆ มากมายเพื่อให้คุณเลือกรูปแบบที่มอบประสบการณ์ของผู้ใช้ที่ดีที่สุดได้

แบนเนอร์

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

ใช้โฆษณาแบนเนอร์

โฆษณาคั่นระหว่างหน้า

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

ติดตั้งโฆษณาคั่นระหว่างหน้า

เนทีฟ

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

ติดตั้งโฆษณาเนทีฟ

ได้รับรางวัลแล้ว

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

ใช้โฆษณาที่มีการให้รางวัล

โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

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

ผู้ใช้ไม่จําเป็นต้องเลือกดูโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล ซึ่งต่างจากโฆษณาที่มีการให้รางวัล

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

ใช้โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

โฆษณาเปิดแอป

โฆษณาเปิดแอปเป็นรูปแบบโฆษณาที่ปรากฏเมื่อผู้ใช้เปิดหรือสลับกลับไปที่แอปของคุณ โดยโฆษณาจะซ้อนทับหน้าจอการโหลด

ใช้โฆษณาเปิดแอป