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

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