ตั้งค่าปลั๊กอิน Google Mobile Ads Unity

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

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

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

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

• ใช้ Unity Editor 2019.4 ขึ้นไป
  • เราขอแนะนำให้ใช้เวอร์ชัน 2022.2 ขึ้นไป
• หากต้องการติดตั้งใช้งานใน iOS
  • Xcode 16.0 ขึ้นไป
  • กำหนดเป้าหมายเป็น iOS 13.0 ขึ้นไป
  • CocoaPods
• หากต้องการติดตั้งใช้งานใน Android
  • API ระดับ 24 ขึ้นไปของ Android ขั้นต่ำ
  • กำหนดเป้าหมาย Android API ระดับ 35 ขึ้นไป

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

ระดับ API ของ Android ตั้งค่าไว้ในการตั้งค่าโปรเจ็กต์ > 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 พร้อม UI

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

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

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

3. เปิดเมนู Package Manager โดยเลือกตัวเลือกเมนู Unity Window > Package Manager

4. ตั้งค่าเมนูแบบเลื่อนลงขอบเขตผู้จัดการเพื่อเลือกรีจิสทรีของฉัน

   

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

OpenUPM

1. ดึงแท็กเวอร์ชันของรุ่นล่าสุด แท็กที่แสดงผลโดยไม่รวมคำนำหน้า v คือเวอร์ชัน Google Mobile Ads Unity Plugin

   • macOS และ Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. แก้ไขไฟล์ Packages/manifest.json เพื่อเพิ่มรีจิสทรีและทรัพยากร Dependency ที่กำหนดขอบเขตของ OpenUPM โดยใช้เวอร์ชันที่ได้จากคำสั่งก่อนหน้า

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.5.0"
     }
   }
   

นำชิ้นงานปลั๊กอิน .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

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

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

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

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

Google Mobile Ads Unity Plugin จะบันทึกการตั้งค่าเหล่านี้เป็นข้อความใน Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset ไฟล์การกำหนดค่า

เริ่มต้น SDK

ก่อนโหลดโฆษณา ให้แอปเริ่มต้น Google Mobile Ads Unity Plugin โดย เรียกใช้ MobileAds.Initialize() คุณต้องดำเนินการนี้เพียงครั้งเดียว ซึ่งควรทำเมื่อเปิดแอป

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

ตัวอย่างวิธีเรียกใช้ MobileAds.Initialize() มีดังนี้

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

โต้ตอบกับออบเจ็กต์ Unity ในชุดข้อความหลัก

Google Mobile Ads Unity Plugin จะเพิ่มเหตุการณ์โฆษณาในเธรดเบื้องหลัง หาก การเรียกกลับของโฆษณาโต้ตอบกับออบเจ็กต์ Unity เช่น UnityEngine ให้กำหนดเวลางานนั้นอย่างชัดเจนในเทรดหลักของ Unity โดยใช้วิธี MobileAdsEventExecutor.ExecuteInUpdate ดูรายละเอียดการใช้งานได้ที่เรียกใช้เหตุการณ์โฆษณาในเทรดหลักของ Unity

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

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

แบนเนอร์

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

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

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

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

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

เนทีฟ

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

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

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

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

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

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

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

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

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

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

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

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

ติดตั้งใช้งานโฆษณาเปิดแอป