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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เวอร์ชันเก่า)

ปลั๊กอิน Google Mobile Ads 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
    • Android API ระดับ 23 ขึ้นไปเป็นอย่างต่ำ
    • กำหนดเป้าหมาย Android API ระดับ 35 ขึ้นไป

คุณตั้งค่า Android ระดับ API ได้ในการตั้งค่าโปรเจ็กต์ > Player > Android > การตั้งค่าอื่นๆ > การตั้งค่าอื่นๆ

นำเข้าปลั๊กอิน Mobile Ads for 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 Edit > Project Settings > Package Manager

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

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

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

  4. ตั้งค่าเมนูแบบเลื่อนลงขอบเขตของ Manager ให้เลือก My Registries

  5. เลือกแพ็กเกจ Google Mobile Ads for Unity จากรายการแพ็กเกจ แล้วกด Install

นำเนื้อหาปลั๊กอิน .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 Assets > Import package > Custom Package แล้วนำเข้าทุกรายการ

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

ใน Unity Editor ให้เลือกชิ้นงาน > Google Mobile Ads > การตั้งค่า จากเมนู

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

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

เริ่มต้น SDK

ก่อนโหลดโฆษณา ให้แอปเริ่มต้น Google Mobile Ads Unity Plugin โดย เรียกใช้ 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."); MobileAdsEventExecutor.ExecuteInUpdate(() => { // Interact with UnityEngine objects on the main thread here. }); });

โต้ตอบกับออบเจ็กต์ Unity ในเธรดหลัก

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

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

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

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

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

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

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

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

เนทีฟ

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

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

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

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

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

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

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

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

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

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

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

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

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