การตั้งค่าส่วนกลาง

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity

คลาส MobileAds มีการตั้งค่าส่วนกลางสำหรับปลั๊กอิน Google Mobile Ads Unity

เรียกใช้เหตุการณ์โฆษณาในเทรดหลักของ Unity

ปลั๊กอิน Google Mobile Ads Unity จะสร้างเหตุการณ์ในเธรดอื่นที่ไม่ใช่เธรดหลักของ Unity หากใช้เหตุการณ์โฆษณาและโต้ตอบกับออบเจ็กต์ Unity คุณ ต้องซิงค์เหตุการณ์ปลั๊กอิน Unity สำหรับ Google Mobile Ads กับเทรดหลักของ Unity

ซิงโครไนซ์เหตุการณ์โฆษณากับเทรดหลักของ Unity ด้วยตนเองหรือ โดยอัตโนมัติโดยให้ปลั๊กอิน Google Mobile Ads Unity จัดการการซิงโครไนซ์

แนะนำ: ซิงค์เหตุการณ์โฆษณาด้วยตนเอง

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

ตัวอย่างต่อไปนี้จะบันทึกเธรดเบื้องหลังและเรียกใช้การดำเนินการเพื่อโต้ตอบ กับออบเจ็กต์ UnityEngine

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

ทำให้การซิงค์เหตุการณ์โฆษณาเป็นแบบอัตโนมัติ

หากต้องการให้ปลั๊กอิน Google Mobile Ads Unity ซิงค์เหตุการณ์โฆษณา ให้ตั้งค่าพร็อพเพอร์ตี้ MobileAds.RaiseAdEventsOnUnityMainThreadเป็น true

...
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;
    }
}

การควบคุมระดับเสียงของโฆษณาวิดีโอ

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

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

คุณรายงานระดับเสียงของแอปที่เกี่ยวข้องไปยังปลั๊กอิน Google Mobile Ads Unity ได้โดยเรียกใช้เมธอด SetApplicationVolume() ก่อนโหลดโฆษณา ค่าระดับเสียงโฆษณาที่ใช้ได้ จะอยู่ในช่วง 0.0 (เงียบ) ถึง 1.0 (ระดับเสียงปัจจุบันของอุปกรณ์) ตัวอย่างวิธีรายงานปริมาณแอปแบบสัมพัทธ์ไปยัง SDK มีดังนี้

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

หากต้องการแจ้งให้ SDK ทราบว่าปิดเสียงระดับเสียงของแอปแล้ว ให้เรียกใช้เมธอด SetApplicationMuted() ก่อนโหลดโฆษณา

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

โดยค่าเริ่มต้น ระบบจะตั้งระดับเสียงของแอปเป็น 1 ซึ่งเป็นระดับเสียงปัจจุบันของอุปกรณ์ และ แอปจะไม่ปิดเสียง

ความยินยอมในการใช้คุกกี้

หากแอปมีข้อกำหนดพิเศษ คุณสามารถตั้งค่าคีย์ ApplicationPreferences gad_has_consent_for_cookies ที่ไม่บังคับเป็น 0 เพื่อเปิดใช้โฆษณาแบบจำกัด ได้โดยทำดังนี้

// Enable limited ads
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

การลดขนาดโค้ดของ Android

ตัวเลือกการเผยแพร่ Unity นี้ช่วยให้คุณเปิดใช้การลดขนาดโค้ด Java ได้ หากเปิดใช้การลดขนาด คุณจะต้องสร้างไฟล์ Proguard ที่กำหนดเอง เพื่อเก็บคลาสที่ SDK อ้างอิงไว้ด้วย

1. เปิดใช้ไฟล์ Proguard ที่กำหนดเอง

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

   • ไฟล์ Proguard ที่กำหนดเอง

2. เปิด /Assets/Plugins/Android/proguard-user.txt แล้วเพิ่มโค้ดต่อไปนี้

-keep class com.google.** { public *; }

ปิดใช้การรายงานข้อขัดข้อง

ปลั๊กอิน Google Mobile Ads Unity จะรวบรวมรายงานข้อขัดข้องเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องและการวิเคราะห์ คุณปิดใช้การรายงานข้อขัดข้องนี้ได้ด้วยโค้ดต่อไปนี้ ส่วนต่อไปนี้จะอธิบายวิธีปิดใช้การรายงานข้อขัดข้องใน Android และ iOS

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

รับเวอร์ชันปลั๊กอิน Unity

หากต้องการดูเวอร์ชัน Unity SDK ให้เรียกใช้คำสั่งต่อไปนี้

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

รับเวอร์ชันของแพลตฟอร์ม

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

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());