ตั้งค่าสื่อกลาง

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity Flutter

คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป Flutter

ข้อกำหนดเบื้องต้น

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

ยังไม่เคยใช้สื่อกลางใช่ไหม อ่าน ข้อมูลเบื้องต้นเกี่ยวกับสื่อกลาง

เริ่มต้นใช้งาน Google Mobile Ads Flutter Plugin

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบสถานะการเริ่มต้นใช้งานของอะแดปเตอร์แต่ละรายการก่อนที่จะส่งคำขอโฆษณา

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

อัปเดตการตั้งค่า Gradle (Android เท่านั้น)

เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ settings.gradle เพื่อให้คุณใช้ Android API ของปลั๊กอินได้

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

เพิ่มการพึ่งพิงสำหรับเครือข่ายพาร์ทเนอร์

คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและการพึ่งพิงของอะแดปเตอร์ลงในโปรเจ็กต์ Android และ iOS โดยเพิ่มได้ด้วยการอัปเดตไฟล์ build.gradle ระดับแอปใน Android และ Podfile ใน iOS Google มีอะแดปเตอร์โอเพนซอร์สใน GitHub สำหรับทั้ง Android และ iOS

ดูคำแนะนำโดยละเอียดเกี่ยวกับวิธีเพิ่มอะแดปเตอร์ของเครือข่ายพาร์ทเนอร์แต่ละเครือข่ายในแอปได้ในเอกสารประกอบของ Android และ iOS

ตรวจสอบคลาสอะแดปเตอร์เครือข่ายโฆษณาที่โหลดโฆษณา

โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกชื่อคลาสเครือข่ายโฆษณาสำหรับโฆษณาแบนเนอร์

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

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

ใช้โฆษณาเนทีฟกับสื่อกลาง

ต่อไปนี้คือแนวทางปฏิบัติแนะนำบางประการที่ควรพิจารณาเมื่อใช้สื่อกลางเนทีฟ

นโยบายการแสดงโฆษณาเนทีฟ
เครือข่ายโฆษณาแต่ละเครือข่ายมีนโยบายของตนเอง เมื่อใช้สื่อกลาง คุณต้องไม่ลืมว่าแอปยังคงต้องปฏิบัติตามนโยบายของเครือข่ายสื่อกลางที่แสดงโฆษณา

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาและ GDPR

หากคุณต้องปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาหรือกฎระเบียบทั่วไปเกี่ยวกับการคุ้มครองข้อมูล (GDPR) ให้ทำตามขั้นตอนในการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาหรือการตั้งค่า GDPR เพื่อเพิ่มพาร์ทเนอร์สื่อกลางในรายชื่อพาร์ทเนอร์โฆษณา GDPR หรือรายชื่อพาร์ทเนอร์โฆษณาของรัฐในสหรัฐอเมริกาในความเป็นส่วนตัวและการแสดงข้อความแจ้งผู้ใช้ของ Ad Manager หากไม่ดำเนินการดังกล่าว พาร์ทเนอร์อาจแสดงโฆษณาในแอปของคุณไม่ได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้ การประมวลผลข้อมูลแบบจำกัด (RDP) และขอความยินยอมตาม GDPR ด้วย SDK สำหรับ User Messaging Platform (UMP) ของ Google