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

คลาส MobileAds มีการกําหนดค่าส่วนกลางสําหรับ Google Mobile Ads SDK

เพิ่มเหตุการณ์โฆษณาในเธรดหลักของ Unity

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

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

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

หมายเหตุ: ผลข้างเคียงของการเรียกเหตุการณ์ในชุดข้อความหลักของ Unity คือระบบจะไม่เรียกเหตุการณ์บางอย่าง เช่น OnAdFullScreenContentOpened ขึ้นมาจนกว่าผู้ใช้จะกลับมาที่แอป

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

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

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

คุณสามารถรายงานปริมาณแอปที่เกี่ยวข้องไปยัง Google Mobile Ads SDK ได้โดยเรียกใช้เมธอด 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 ที่กําหนดเอง

   ไปที่ Project Settings > Player > Android > Publishing Settings > Build แล้วเลือกรายการต่อไปนี้

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

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

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

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

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

Android

เพิ่มแท็ก <meta-data> โดยตั้งค่า DISABLE_CRASH_REPORTING เป็น true ในไฟล์ AndroidManifest.xml ของแอป

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

iOS

เรียกใช้เมธอด DisableSDKCrashReporting เพื่อปิดใช้รายงานข้อขัดข้องใน iOS

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