การโหลดโฆษณาล่วงหน้า (อัลฟ่า)

คำเตือน: การเข้าถึงฟีเจอร์นี้ถูกจำกัด หากต้องการขอสิทธิ์เข้าถึง โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า

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

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

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

ก่อนที่จะทำตามบทแนะนำ คุณต้องดำเนินการต่อไปนี้ให้เสร็จ

• ติดตั้ง SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google (เบต้า) เวอร์ชัน 0.14.0-alpha01 ขึ้นไป
• ทำตามคู่มือเริ่มต้นใช้งาน

• ไม่บังคับ: ดาวน์โหลดและเรียกใช้แอปตัวอย่าง

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

หากต้องการเริ่มโหลดล่วงหน้า ให้โทรหา startPreload() SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะลองส่งคำขอโฆษณาที่ล้มเหลวสำหรับการกำหนดค่าที่โหลดล่วงหน้าอีกครั้งโดยอัตโนมัติ

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

Kotlin

private fun startPreloading(adUnitID: String) {
  val adRequest: AdRequest = AdRequest.Builder(adUnitID).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  InterstitialAdPreloader.start(adUnitID, preloadConfig)
}

Java

private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  InterstitialAdPreloader.start(adUnitId, preloadConfig);
}

หมายเหตุ: เราขอแนะนําให้โหลดล่วงหน้าเพียงหน่วยโฆษณาเดียวต่อรูปแบบเพื่อเพิ่มประสิทธิภาพ

ไม่บังคับ: แก้ไขโฆษณาที่โหลดล่วงหน้า

หากต้องการเปลี่ยนโฆษณาที่จะโหลดล่วงหน้า ให้เรียกใช้ destroy() แล้วเรียกใช้ startPreload() อีกครั้งด้วยการกำหนดค่าที่แก้ไขแล้ว

ไม่บังคับ: หยุดการโหลดโฆษณาล่วงหน้า

หากต้องการหยุดโหลดโฆษณาล่วงหน้า ให้เรียกใช้ destroy() โดยมี รหัสการโหลดล่วงหน้า

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

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

Kotlin

private fun setBufferSize(adUnitID: String) {
  val adRequest: AdRequest = AdRequest.Builder(adUnitID).build()
  val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 3)
  InterstitialAdPreloader.start(adUnitID, preloadConfig)
}

Java

private void setBufferSize(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 3);
  InterstitialAdPreloader.start(adUnitId, preloadConfig);
}

ไม่บังคับ: รับการแจ้งเตือนการโหลดล่วงหน้า

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

Kotlin

private fun startPreloadingWithCallback(adUnitID: String) {
  val preloadCallback =
    // [Important] Don't call ad preloader start() or pollAd() within the PreloadCallback.
    object : PreloadCallback {
      override fun onAdFailedToPreload(preloadId: String, adError: LoadAdError) {
        Log.i(
          TAG,
          ("Interstitial preload ad $preloadId failed to load with error: ${adError.message}"),
        )
        // [Optional] Get the error response info for additional details.
        // val responseInfo = adError.responseInfo
      }

      override fun onAdsExhausted(preloadId: String) {
        Log.i(TAG, "Interstitial preload ad $preloadId is not available")
      }

      override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo) {
        Log.i(TAG, "Interstitial preload ad $preloadId is available")
      }
    }
  val adRequest: AdRequest = AdRequest.Builder(adUnitID).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  InterstitialAdPreloader.start(adUnitID, preloadConfig, preloadCallback)
}

Java

private void startPreloadingWithCallback(String adUnitId) {
  PreloadCallback preloadCallback =
      // [Important] Don't call ad preloader start() or pollAd() within the PreloadCallback.
      new PreloadCallback() {
        @Override
        public void onAdFailedToPreload(String preloadId, LoadAdError adError) {
          Log.e(
              TAG,
              String.format(
                  "Interstitial preload ad %s failed to load with error: %s",
                  preloadId, adError.getMessage()));
          // [Optional] Get the error response info for additional details.
          // ResponseInfo responseInfo = adError.getResponseInfo();
        }

        @Override
        public void onAdsExhausted(String preloadId) {
          Log.i(TAG, "Interstitial preload ad " + preloadId + " is not available");
        }

        @Override
        public void onAdPreloaded(String preloadId, ResponseInfo responseInfo) {
          Log.i(TAG, "Interstitial preload ad " + preloadId + " is available");
        }
      };

  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  InterstitialAdPreloader.start(adUnitId, preloadConfig, preloadCallback);
}

หมายเหตุ: อย่าโทรหา startPreload() จาก onAdsExhausted() SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google (เบต้า) จะโหลดโฆษณาล่วงหน้าให้คุณต่อไป

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

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

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

Kotlin

private fun pollAndShowAd(activity: Activity, adUnitID: String) {
  // Polling returns the next available ad and loads another ad in the background.
  val ad = InterstitialAdPreloader.pollAd(adUnitID)

  // Interact with the ad object as needed.
  ad?.apply {
    Log.d(TAG, "Interstitial ad response info: ${this.getResponseInfo()}")
    this.adEventCallback =
      object : InterstitialAdEventCallback {
        override fun onAdImpression() {
          Log.d(TAG, "Interstitial ad recorded an impression.")
        }

        override fun onAdPaid(value: AdValue) {
          Log.d(TAG, "Interstitial ad onPaidEvent: ${value.valueMicros} ${value.currencyCode}")
        }
      }

    // Show the ad.
    ad.show(activity)
  }
}

Java

private void pollAndShowAd(Activity activity, String adUnitId) {
  // Polling returns the next available ad and loads another ad in the background.
  final InterstitialAd ad = InterstitialAdPreloader.pollAd(adUnitId);

  // Interact with the ad object as needed.
  if (ad != null) {
    Log.d(TAG, "Interstitial ad response info: " + ad.getResponseInfo());
    ad.setAdEventCallback(
        new InterstitialAdEventCallback() {
          @Override
          public void onAdImpression() {
            Log.d(TAG, "Interstitial ad recorded an impression.");
          }

          @Override
          public void onAdPaid(AdValue value) {
            Log.d(
                TAG,
                "Interstitial ad onPaidEvent: "
                    + value.getValueMicros()
                    + " "
                    + value.getCurrencyCode());
          }
        });

    // Show the ad.
    ad.show(activity);
  }
}

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

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

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

Kotlin

private fun isAdAvailable(adUnitID: String): Boolean {
  return InterstitialAdPreloader.isAdAvailable(adUnitID)
}

Java

private boolean isAdAvailable(String adUnitId) {
  return InterstitialAdPreloader.isAdAvailable(adUnitId);
}