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

คลาส MobileAds มีการตั้งค่าส่วนกลางสำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

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

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

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

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

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

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

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

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

หากต้องการให้ Google Mobile Ads SDK ซิงค์เหตุการณ์โฆษณา ให้ตั้งค่าพร็อพเพอร์ตี้ 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 Mobile Ads SDK จะช่วยให้โฆษณาวิดีโอเล่นตามระดับเสียงที่ตั้งค่าไว้ในแอปได้ ซึ่งจะช่วยให้ผู้ใช้ได้ยินเสียงโฆษณาวิดีโออย่างที่ควรจะเป็น

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

คุณสามารถรายงานระดับเสียงของแอปที่เกี่ยวข้องไปยัง SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ได้โดยการเรียกใช้เมธอด 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 เพื่อเปิดใช้โฆษณาแบบจำกัด (LTD) ได้

// Enable limited ads (LTD)
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 SDK จะรวบรวมรายงานข้อขัดข้องเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องและการวิเคราะห์ คุณปิดใช้การรายงานข้อขัดข้องนี้ได้ด้วยโค้ดต่อไปนี้ ส่วนต่อไปนี้จะอธิบายวิธีปิดใช้การรายงานข้อขัดข้องใน 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());

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

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

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