การโหลดโฆษณาล่วงหน้า (เบต้า)

เลือกแพลตฟอร์ม: iOS Unity Flutter Android (เวอร์ชันเก่า)

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

การโหลดโฆษณาล่วงหน้ามีข้อดีดังต่อไปนี้เมื่อเทียบกับการโหลดโฆษณาด้วยตนเอง

  • การจัดการการอ้างอิง: เก็บโฆษณาที่โหลดไว้เพื่อให้คุณไม่ต้องดูแลการอ้างอิงจนกว่าจะพร้อมแสดงโฆษณา
  • การโหลดซ้ำอัตโนมัติ: โหลดโฆษณาใหม่โดยอัตโนมัติเมื่อคุณนำโฆษณาออกจากแคช
  • การลองใหม่ที่จัดการโดยระบบ: ลองส่งคำขอที่ล้มเหลวซ้ำโดยอัตโนมัติโดยใช้ Exponential Backoff
  • การจัดการการหมดอายุ: รีเฟรชโฆษณาโดยอัตโนมัติก่อนที่โฆษณาจะหมดอายุ (โดยปกติคือหลังจากผ่านไป 1 ชั่วโมง)
  • การเพิ่มประสิทธิภาพแคช: หากคุณใช้แคชขนาดใหญ่กว่า 1 Google Mobile Ads Flutter Plugin เพิ่มประสิทธิภาพลำดับแคชเพื่อแสดงโฆษณาที่ดีที่สุด

คู่มือนี้ครอบคลุมการกำหนดค่าโฆษณาที่โหลดล่วงหน้า การตรวจสอบความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า และการแสดงโฆษณาที่โหลดล่วงหน้า

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

คุณต้องตั้งค่าGoogle Mobile Ads Flutter Pluginก่อนที่จะทำตามบทแนะนำนี้

เริ่มโหลดโฆษณาล่วงหน้า

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

ตัวอย่างต่อไปนี้จะเริ่มโหลดโฆษณาล่วงหน้า

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: const PreloadCallback(),
);

แทนที่ _adUnitId ด้วยรหัสหน่วยโฆษณา

รับและแสดงโฆษณาที่โหลดล่วงหน้า

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

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

ตัวอย่างต่อไปนี้จะดึงและแสดงโฆษณาที่โหลดล่วงหน้า

void _pollAndShowAd() async {
  final InterstitialAd? ad = await InterstitialAdPreloader.pollAd(_adUnitId);
  if (ad != null) {
    _interstitialAd = ad;
    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdImpression: (ad) {
        // Called when an impression occurs on the ad.
        debugPrint('Ad recorded an impression.');
      },
    );
    ad.onPaidEvent = (ad, valueMicros, precision, currencyCode) {
      // Called when an ad is estimated to have earned money.
      debugPrint('Ad paid: $valueMicros $currencyCode.');
    };
    // Show the ad.
    await ad.show();
  }
}

ตรวจสอบความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า

หากต้องการตรวจสอบความพร้อมใช้งานของโฆษณา ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

รับความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า

ตัวอย่างต่อไปนี้จะตรวจสอบความพร้อมใช้งานของโฆษณา

void _checkAdAvailability() async {
  final bool isAvailable = await InterstitialAdPreloader.isAdAvailable(
    _adUnitId,
  );
  debugPrint('Is ad available: $isAvailable');
}

ฟังความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า

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

เหตุการณ์ที่โหลดล่วงหน้ามีไว้เพื่อวัตถุประสงค์ในการวิเคราะห์ ภายในฟังก์ชันเรียกกลับของเหตุการณ์โหลดล่วงหน้า ให้ทำดังนี้

  • อย่าเรียกใช้ start
  • หลีกเลี่ยงการเรียกใช้ pollAd เว้นแต่จะแสดงโฆษณาทันที

ตัวอย่างต่อไปนี้จะลงทะเบียนเพื่อรับเหตุการณ์โฆษณา

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: PreloadCallback(
    onAdPreloaded: (preloadId, responseInfo) {
      debugPrint('Ad preloaded for ID: $preloadId');
    },
    onAdFailedToPreload: (preloadId, error) {
      debugPrint('Ad failed to preload for ID: $preloadId. Error: $error');
    },
    onAdsExhausted: (preloadId) {
      debugPrint('All preloaded ads exhausted for ID: $preloadId');
    },
  ),
);

หยุดโหลดโฆษณาล่วงหน้า

หากไม่จำเป็นต้องแสดงโฆษณาสำหรับรหัสที่โหลดล่วงหน้าอีกในเซสชัน คุณก็หยุดโหลดโฆษณาล่วงหน้าได้ หากต้องการหยุดโหลดโฆษณาล่วงหน้าสำหรับรหัสที่โหลดล่วงหน้าเฉพาะ ให้เรียกใช้ destroy ด้วยรหัสที่โหลดล่วงหน้า หากต้องการหยุดโหลดล่วงหน้าสำหรับตัวโหลดล่วงหน้าทั้งหมด ให้เรียกใช้ destroyAll

void _stopPreloading() async {
  await InterstitialAdPreloader.destroy(_adUnitId);
}

ตั้งค่าขนาดบัฟเฟอร์

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

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(
    adUnitId: _adUnitId,
    bufferSize: 3,
  ),
  callback: const PreloadCallback(),
);

ขีดจำกัดแคชที่โหลดล่วงหน้า

Google Mobile Ads Flutter Plugin กำหนดขีดจำกัดทั่วทั้งแอปสำหรับจำนวนโฆษณาที่โหลดล่วงหน้าทั้งหมด ในหน่วยโฆษณาและรหัสที่โหลดล่วงหน้าทั้งหมด

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