ตั้งค่าปลั๊กอิน 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 ระดับ 24 ขึ้นไปเป็นอย่างต่ำ
    • กำหนดเป้าหมาย 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 ให้เลือกรีจิสทรีของฉัน

  5. เลือกแพ็กเกจ Google Mobile Ads for 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.6.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 แล้วนำเข้าทุกรายการ

ไม่บังคับ: ปิดใช้ External Dependency Manager

หากคุณจัดการไลบรารี Android และ iOS ด้วยเครื่องมือบิลด์ของคุณเอง คุณสามารถปิดใช้แพ็กเกจ com.unity.external-dependency-manager ได้โดยทำดังนี้

ใน Unity Editor ให้เลือก Window > Package Manager แล้วนำแพ็กเกจ External Dependency Manager (com.unity.external-dependency-manager) ออก การนำแพ็กเกจนี้ออกจะล้างเปิดใช้ External Dependency Manager ในชิ้นงาน > Google Mobile Ads > การตั้งค่า

ติดตั้ง External Dependency Manager เวอร์ชันเก่า

หากโปรเจ็กต์ใช้ Unity 2022.2 หรือเวอร์ชันก่อนหน้า คุณสามารถติดตั้งแพ็กเกจ com.google.external-dependency-manager เวอร์ชันเก่าของ Google ได้หลังจากปิดใช้แพ็กเกจของ Unity แล้ว โดยทำดังนี้

  • ดาวน์โหลดไฟล์ .unitypackage ล่าสุดจาก หน้า External Dependency Manager for Unity releases แล้วเลือก Assets > Import Package > Custom Package

  • เรียกใช้คำสั่ง OpenUPM CLI ต่อไปนี้

    openupm add com.google.external-dependency-manager

กำหนดค่าทรัพยากร Dependency เนทีฟด้วยตนเอง

หากคุณไม่ได้ใช้แพ็กเกจ External Dependency Manager ให้เพิ่มไลบรารีที่จำเป็นจากไฟล์ Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml และ Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml ลงในไฟล์บิลด์ โดยทำดังนี้

  • สำหรับ Android ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > Player > Android > การตั้งค่าการเผยแพร่ > บิลด์ แล้วเปิดใช้เทมเพลต Gradle หลักที่กำหนดเอง เพิ่มไลบรารีที่จำเป็นจากไฟล์ GoogleMobileAdsDependencies.xml และ GoogleUmpDependencies.xml ลงในบล็อก dependencies ในไฟล์ Assets/Plugins/Android/mainTemplate.gradle โดยทำดังนี้

    implementation 'com.google.android.gms:play-services-ads:25.5.0'
implementation 'com.google.android.ump:user-messaging-platform:4.0.0'

    นอกจากนี้ ให้เพิ่มแพ็กเกจ androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process และ androidx.fragment:fragment โดยใช้เวอร์ชันในไฟล์ GoogleMobileAdsDependencies.xml

  • สำหรับ iOS ให้ส่งออกโปรเจ็กต์ Xcode เพิ่ม Pod ที่จำเป็นจากไฟล์ GoogleMobileAdsDependencies.xml และ GoogleUmpDependencies.xml ลงในไฟล์ Podfile ในโฟลเดอร์โปรเจ็กต์ที่ส่งออก โดยทำดังนี้

    pod 'Google-Mobile-Ads-SDK'
pod 'GoogleUserMessagingPlatform'

    จากนั้นเรียกใช้คำสั่งต่อไปนี้ในโฟลเดอร์โปรเจ็กต์ iOS ที่ส่งออก

    pod install --repo-update

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

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

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

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

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

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

เนทีฟ

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

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

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

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

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

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

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

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

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

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

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

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

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