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

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

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

สื่อกลางโฆษณาเนทีฟ

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

นโยบายการนำเสนอโฆษณาเนทีฟ

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

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

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

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