หากต้องการใช้การปรับปรุงเวลาในการตอบสนองและความเสถียรของ Android ให้ใช้ GMA Next-Gen SDK คู่มือนี้ครอบคลุมการกำหนดค่า Google Mobile Ads Flutter Plugin เพื่อใช้ GMA Next-Gen SDK สำหรับ Android
ข้อกำหนดเบื้องต้น
โปรดทำสิ่งต่อไปนี้ก่อนดำเนินการต่อ
- ติดตั้ง Google Mobile Ads Flutter Plugin เวอร์ชัน 9.0.0 ขึ้นไป
- ตั้งค่า Google Mobile Ads Flutter Plugin
- มีโปรเจ็กต์ Flutter
กำหนดการตั้งค่า Android Gradle
หากต้องการใช้ GMA Next-Gen SDK ใน Android คุณต้องอัปเดตการกำหนดค่า Gradle ดังนี้
- ตั้งค่าระดับ API ขั้นต่ำและระดับ API ของ Android ที่คอมไพล์
- หากคุณใช้สื่อกลาง ให้ทำตามขั้นตอนการย้ายข้อมูลเพื่อยกเว้นโมดูล
com.google.android.gmsเพื่อหลีกเลี่ยงข้อผิดพลาดคลาสที่ซ้ำกัน
เรียกใช้ด้วยการประกาศสภาพแวดล้อม
หากต้องการใช้ GMA Next-Gen SDK เมื่อสร้างและเรียกใช้แอป Android คุณต้องระบุการประกาศสภาพแวดล้อม USE_NEXT_GEN_SDK ที่ตั้งค่าเป็นค่า true
ทุกครั้งที่คุณสร้างหรือเรียกใช้แอป ให้เรียกใช้คำสั่งต่อไปนี้
flutter run --dart-define USE_NEXT_GEN_SDK=true
เรียกใช้ด้วยการกำหนดค่า IDE
หากเรียกใช้แอปโดยใช้สภาพแวดล้อมการพัฒนาแบบเบ็ดเสร็จ (IDE) คุณสามารถกำหนดค่าการประกาศสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในการกำหนดค่าการเปิดใช้งานแทนการส่ง Flag โดยใช้บรรทัดคำสั่ง
เช่น คุณสามารถกำหนดตัวแปรเหล่านี้ในไฟล์ JSON และเพิ่มลงในการตั้งค่า IDE ดูรายละเอียดได้ที่การระบุการประกาศสภาพแวดล้อม
อัปเดตเทมเพลตโฆษณาเนทีฟ
หากคุณใช้เทมเพลตโฆษณาเนทีฟ ให้อัปเดตต่อไปนี้เพื่อรองรับ GMA Next-Gen SDK
อัปเดตการนำเข้าแพ็กเกจ NativeAdFactory
สำหรับ Android ให้อัปเดตคำสั่งนำเข้าสำหรับคลาส NativeAdFactory ดังนี้
Java
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;
Kotlin
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory
อัปเดตมุมมอง XML ของเลย์เอาต์มุมมองโฆษณาเนทีฟ
ในไฟล์ XML ของเลย์เอาต์สำหรับโฆษณาเนทีฟ ให้อัปเดตคลาสการดูโฆษณาเนทีฟดังนี้
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
กำหนดค่าทรัพยากร Dependency สำหรับการตั้งค่าทั้ง 2 แบบ
หากโปรเจ็กต์ต้องรองรับทั้ง Google Mobile Ads SDK (Legacy) และ GMA Next-Gen SDK คุณสามารถกำหนดค่าไฟล์ android/app/build.gradle เพื่อกำหนดทรัพยากร Dependency ตามเงื่อนไขตามการประกาศสภาพแวดล้อมได้
Google Mobile Ads Flutter Plugin มีตัวอย่างการกำหนดค่าในไฟล์ build.gradle ของแอปตัวอย่าง