บริการไกล่เกลี่ย

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

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

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

• โฆษณาแบนเนอร์
• โฆษณาคั่นระหว่างหน้า
• โฆษณาเนทีฟ
• โฆษณาที่มีการให้รางวัล
• โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

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

เริ่มต้นใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่

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

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

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 flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

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

คุณต้องเพิ่มอะแดปเตอร์สื่อกลางและทรัพยากร 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