เริ่มต้นใช้งาน

คู่มือนี้ทําขึ้นสําหรับผู้เผยแพร่โฆษณาที่ต้องการสร้างรายได้จากแอป Unity

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

สิ่งที่ต้องดำเนินการก่อน

  • ใช้ Unity 2019 ขึ้นไป
  • ในการทําให้ใช้งานได้กับ iOS
    • Xcode เวอร์ชัน 14.1 ขึ้นไป
    • กําหนดเป้าหมาย iOS 11.0 ขึ้นไป
    • CocoaPods
  • ในการทําให้ใช้งานได้กับ Android
    • บริการ Google Play 18.1.0 ขึ้นไป
    • กําหนดเป้าหมาย Android API ระดับ 16 ขึ้นไป
  • แนะนํา: สร้างบัญชี AdMob และลงทะเบียนแอป Android และ/หรือ iOS

ดาวน์โหลดปลั๊กอิน Mobile Unity

ปลั๊กอิน Unity สําหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google ช่วยให้นักพัฒนาซอฟต์แวร์ Unity แสดง โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ในแอป Android และ iOS ได้โดยไม่ต้องเขียนโค้ด Java หรือ Objective-C ปลั๊กอินจะมีอินเทอร์เฟซ C# สําหรับการขอโฆษณาซึ่งใช้โดยสคริปต์ C# ในโปรเจ็กต์ Unity

ใช้ลิงก์ด้านล่างเพื่อดาวน์โหลดแพ็กเกจ Unity สําหรับปลั๊กอิน หรือเพื่อดูโค้ดของ GitHub

ดาวน์โหลด PPLGIN ดูแหล่งที่มา

นําเข้าปลั๊กอิน Unity สําหรับโฆษณาในอุปกรณ์เคลื่อนที่

เปิดโปรเจ็กต์ในตัวแก้ไข Unity เลือกเนื้อหา > นําเข้าแพ็กเกจ > แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsPlugin.unitypackage ที่คุณดาวน์โหลดมา

ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้วคลิก Import

รวม SDK โฆษณาบนอุปกรณ์เคลื่อนที่

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

ทําตามขั้นตอนด้านล่างเพื่อให้แน่ใจว่าโครงการของคุณมี SDK โฆษณาในอุปกรณ์เคลื่อนที่

Android

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

iOS

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

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

ตั้งค่ารหัสแอป AdMob

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

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

เพิ่มเหตุการณ์โฆษณาในชุดหลักของ Unity

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

หากคุณต้องการให้ SDK โฆษณาในอุปกรณ์เคลื่อนที่จัดการกับความกังวลเกี่ยวกับชุดข้อความนี้ ให้ตั้งค่า MobileAds.RaiseAdEventsOnUnityMainThread เป็น true ซึ่งจะเป็นการบังคับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ให้เพิ่มเหตุการณ์และโค้ดเรียกกลับทั้งหมดในชุดข้อความหลักของ Unity

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

เริ่มต้น SDK โฆษณาบนอุปกรณ์เคลื่อนที่

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

ต่อไปนี้คือตัวอย่างวิธีเรียก Initialize() ภายในเมธอด Start() ของสคริปต์ที่แนบกับ GameObject

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

เลือกรูปแบบโฆษณา

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

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

ใช้งานแบนเนอร์

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

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

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

เนทีฟ

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

ใช้โฆษณาเนทีฟ

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

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

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

ขอการให้สิทธิ์ความโปร่งใสในการติดตามแอป

หากต้องการแสดงคําขอการให้สิทธิ์ความโปร่งใสในการติดตามแอป (ATT) สําหรับการเข้าถึง IDFA ให้ใช้แพ็กเกจการสนับสนุนการโฆษณา iOS 14 ของ Unity

คีย์แอปเดียวกัน

ข้อกําหนดเบื้องต้น: ปลั๊กอิน Unity สําหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 6.1.0 ขึ้นไป

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

โดยค่าเริ่มต้น ระบบจะเปิดใช้คีย์แอปเดียวกันไว้แล้ว แต่คุณสามารถปิดใช้ด้วย API ต่อไปนี้

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }