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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

คู่มือนี้จะแสดงวิธีผสานรวมอะแดปเตอร์สื่อกลางกับแอป 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")

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

คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและทรัพยากร Dependency ลงในโปรเจ็กต์ 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 แหล่งที่มาของโฆษณาบุคคลที่สามทั้งหมดสำหรับหน่วยโฆษณาแบนเนอร์ที่ใช้ในสื่อกลาง วิธีนี้จะป้องกันไม่ให้เกิดการรีเฟรชซ้ำ เนื่องจาก Ad Manager จะทริกเกอร์การรีเฟรชตามอัตราการรีเฟรชของหน่วยโฆษณาแบนเนอร์ด้วย

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

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

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

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

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

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