ย้ายข้อมูลเวอร์ชัน SDK

หน้านี้ครอบคลุมการย้ายข้อมูลสำหรับเวอร์ชันปัจจุบันและเวอร์ชันก่อนหน้า

ย้ายข้อมูลจาก v24 ไปยัง v25

ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 24 และ 25 ของ Google Mobile Ads SDK (Legacy)

ระดับ API ขั้นต่ำของ Android คือ 24

ตั้งแต่เวอร์ชัน 25.5.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องทำงานบน Android API ระดับ 24 เป็นอย่างน้อย หากต้องการปรับระดับ API ให้เปลี่ยนค่า minSdk ในไฟล์ build.gradle ระดับแอปเป็น 24 ขึ้นไป

นำ Callback ของโฆษณาที่เลิกใช้งานแล้วออก

ระบบนำ Callback โฆษณาที่เลิกใช้งานต่อไปนี้ออกจากคลาสต่อไปนี้

ชั้นเรียน นำ Callback ออกแล้ว การแทนที่
SignalCallbacks onFailure(String)
onAdFailedToShow(String)
onFailure(AdError)
onAdFailedToShow(AdError)
MediationAdLoadCallback
MediationInterstitialAdCallback
MediationRewardedAdCallback

การเปลี่ยนแปลง API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้

เวอร์ชัน 25.0.0 เลิกใช้งาน API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ที่มีอยู่ และเปิดตัว API ขนาดสำหรับโฆษณาแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่ Google Mobile Ads SDK (Legacy) สามารถแสดงดีมานด์วิดีโอในโฆษณาแบนเนอร์ได้โดยใช้ API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่ใหม่

ตารางต่อไปนี้แสดงรายละเอียด API การปรับขนาดที่เลิกใช้งานแล้วและ API ที่จะมาแทนที่

v24 (เลิกใช้งานแล้ว) v25 (การเปลี่ยนทดแทน)
getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) getLargeAnchoredAdaptiveBannerAdSize(Context, int)
getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) getLargeLandscapeAnchoredAdaptiveBannerAdSize(Context, int)
getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width) getLargePortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

การนำชั้นเรียน mediation.VersionInfo ออก

คลาส VersionInfo ในแพ็กเกจ com.google.android.gms.ads.mediation ถูกนำออกแล้ว ให้ใช้แพ็กเกจ com.google.android.gms.ads.VersionInfo แทน

การนำเมธอด getConfiguration() ออกในคลาส RtbSignalData

นำเมธอด getConfiguration() API ที่เลิกใช้งานแล้วใน RtbSignalData ออก แต่ให้ใช้เมธอด getConfigurations() ซึ่งจะแสดงรายการ List<MediationConfiguration> แทน

ย้ายข้อมูลจาก v23 ไปยัง v24

ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่าง Google Mobile Ads SDK (Legacy) เวอร์ชันหลัก 23 และ 24

ระดับ API ขั้นต่ำของ Android คือ 23

ตั้งแต่เวอร์ชัน 24.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องทำงานบน Android API ระดับ 23 เป็นอย่างน้อย หากต้องการปรับระดับ API ให้เปลี่ยนค่า minSdk ในไฟล์ build.gradle ระดับแอปเป็น 23 ขึ้นไป

การเปลี่ยนแปลงการเริ่มต้นและการโหลดที่เพิ่มประสิทธิภาพ

โดยค่าเริ่มต้น แฟล็ก OPTIMIZE_INITIALIZATION และ OPTIMIZE_AD_LOADING จะตั้งค่าเป็น true ดูข้อมูลเพิ่มเติมเกี่ยวกับแฟล็กเหล่านี้ได้ที่เพิ่มประสิทธิภาพการเริ่มต้นและการโหลด

นำทรัพยากร Dependency ของ firebase-ads และ firebase-ads-lite ออกแล้ว

ตั้งแต่เวอร์ชัน 24.0.0 เป็นต้นไป SDK จะไม่เผยแพร่ทรัพยากร Dependency firebase-ads และ firebase-ads-lite อีกต่อไป ให้ใช้ทรัพยากร Dependency play-services-ads แทน

ตั้งค่าพารามิเตอร์การกำหนดเป้าหมายเอง

หากต้องการตั้งค่าการกำหนดเป้าหมายเองในคำขอโฆษณา ให้ใช้ addCustomTargeting()

นํา API การวางแนวที่เลิกใช้งานแล้วสําหรับโฆษณาเปิดแอปออก

  • นำเมธอด AppOpenAd.load() ที่ยอมรับพารามิเตอร์อินพุตการวางแนวออก ใช้เมธอด AppOpenAd.load() ที่ไม่ใช้การวางแนวแทน
  • นำ enum AppOpenAdOrientation ออกแล้ว

Simplified reward callback for mediation adapters

เวอร์ชัน 24.0.0 เพิ่ม Callback onUserEarnedReward() ใน MediationRewardedAdCallback และเลิกใช้งาน onUserEarnedReward(RewardItem) อะแดปเตอร์สื่อกลางต้องเริ่มเรียก onUserEarnedReward() เมื่อผู้ใช้ได้รับรางวัล

เมื่อส่งต่อ Callback จากอะแดปเตอร์สื่อกลาง Google Mobile Ads SDK (Legacy) ทุกเวอร์ชันจะแสดงผลรางวัลที่กำหนดไว้ใน UI ของ Ad Manager ใน OnUserEarnedRewardListener

นำชั้นเรียนออกแล้ว

ระบบนำคลาสต่อไปนี้ออกโดยไม่มีการแทนที่

  • DynamicHeightSearchAdRequest
  • SearchAdRequest
  • SearchAdView

นำวิธีการออกแล้ว

ระบบได้นำเมธอดต่อไปนี้ออกโดยไม่มีการแทนที่

ชั้นเรียน วิธีการ
RewardedInterstitialAdLoadCallback onRewardedInterstitialAdLoaded()
onRewardedInterstitialAdFailedToLoad(int)
onRewardedInterstitialAdFailedToLoad(LoadAdError)

เลิกใช้งานเมธอดแล้ว

เราได้เลิกใช้งานเมธอดต่อไปนี้โดยไม่มีการแทนที่

ชั้นเรียน วิธีการ
อะแดปเตอร์ loadInterscrollerAd()
RtbAdapter loadRtbInterscrollerAd()

ย้ายข้อมูลจาก v22 ไปยัง v23

ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 22 และ 23 ของ Google Mobile Ads SDK (Legacy)

ระดับ API ขั้นต่ำของ Android คือ 21

ตั้งแต่เวอร์ชัน 23.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องใช้ Android API ระดับ 21 เป็นอย่างต่ำจึงจะทำงานได้ หากต้องการปรับระดับ API ให้เปลี่ยนค่าของ minSdkVersion ในไฟล์ build.gradle ระดับแอปเป็น 21 ขึ้นไป

AdManagerAdRequest.Builder เมธอดที่รับค่ามาจากคลาสใหญ่สุดสามารถเชื่อมโยงกันได้

ในเวอร์ชัน 23.0.0 เมธอด AdManagerAdRequest.Builder ที่รับค่ามาจากเมธอดหลักสามารถเชื่อมโยงเข้าด้วยกันเพื่อสร้าง AdManagerAdRequest โดยใช้การเรียกใช้เพียงครั้งเดียว ดังนี้

Java

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

Kotlin

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

นำวิธีการที่เลิกใช้งานออก/แทนที่

v22.0.0 API v23.0.0 API
AdRequest.Builder.addTestDevice() RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies() RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN ไม่มีการเปลี่ยนทดแทน
AdLoader.Builder.forUnifiedNativeAd() AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd() AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.formats.NativeAdOptions) AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.nativead.NativeAdOptions)
void MobileAds.setSameAppKeyEnabled() boolean MobileAds.putPublisherFirstPartyIdEnabled()

ย้ายข้อมูลจาก v21 ไปยัง v22

ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 21 และ 22 ของ Google Mobile Ads SDK (Legacy)

ใช้ MobileAds.getVersion() เพื่อรับเวอร์ชัน Google Mobile Ads SDK (Legacy)

เราจะนําเมธอด MobileAds.getVersionString() ออกในเวอร์ชัน 22.0.0 เพื่อใช้ MobileAds.getVersion() แทน

เมธอดใหม่จะแสดงผลหมายเลขเวอร์ชันภายนอกที่คาดไว้ เช่น 22.0.0 ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ที่ใช้เมธอด getVersion() ของ Google Mobile Ads SDK ใหม่

การนํา NativeCustomFormatAd.getVideoMediaView() ที่เลิกใช้งานแล้วออก

ในเวอร์ชัน 21 Google Mobile Ads SDK (Legacy) มีเมธอด NativeCustomFormatAd.getVideoMediaView() เพื่อรับชิ้นงานสื่อสำหรับรูปแบบโฆษณาเนทีฟที่กำหนดเอง

ตั้งแต่เวอร์ชัน 22 เป็นต้นไป คุณจะต้องสร้าง MediaView ของคุณเองและตั้งค่าเนื้อหาสื่อ แล้วใช้ MediaContent.getVideoController() เพื่อรับตัวควบคุมวิดีโอ

v22

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

v21

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

ดูข้อมูลเพิ่มเติมได้ที่คู่มือโฆษณาเนทีฟที่กำหนดเอง

วิธีการที่นำออกหรือแทนที่

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงที่เฉพาะเจาะจงในเวอร์ชัน 22.0.0

v21.0.0 v22.0.0
MobileAds.getVersionString() MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView() NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController() NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo() AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter Adapter
MediationRewardedVideoAdListener
com.google.android.gms.ads.mediation.VersionInfo com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener com.google.android.gms.ads.admanager.AppEventListener

ย้ายข้อมูลจาก v20 ไปยัง v21

ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 20 และ 21 ของ Google Mobile Ads SDK (Legacy)

อัปเดต minSdkVersion เป็น 19 ขึ้นไป

ตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องใช้ Android ระดับ API 19 เป็นอย่างน้อยจึงจะทำงานได้ หากต้องการปรับระดับ API ให้เปลี่ยนค่าของ minSdkVersion ในไฟล์บิลด์ของแอปเป็น 19 ขึ้นไป

บังคับใช้ความสามารถในการเป็นค่า Null ที่เข้มงวด

ในการเตรียมพร้อมสำหรับการบังคับใช้ความสามารถในการเป็นค่า Null ที่เข้มงวด ระบบจะเพิ่มคำอธิบายประกอบ @NonNull ใน API ทั้งหมดที่ก่อนหน้านี้ไม่ได้กำหนดความสามารถในการเป็นค่า Null อย่างชัดเจน

การเปลี่ยนแปลงนี้อาจทำให้แอป Kotlin และแอปที่ใช้เฟรมเวิร์กการตรวจสอบค่า Null ของ Java เสียหายหากมีการละเมิดความปลอดภัยของค่า Null และก่อนหน้านี้ไม่ได้จัดการค่า null อย่างปลอดภัย (ดูเอกสารประกอบของ Kotlin เกี่ยวกับความปลอดภัยของค่า Null)

การนำเมธอด addNetworkExtras() ออก

เมธอด addNetworkExtras() ที่ส่งพารามิเตอร์เพิ่มเติมเป็นอินสแตนซ์ NetworkExtras ไปยังอะแดปเตอร์เครือข่ายโฆษณาที่เฉพาะเจาะจงเลิกใช้งานแล้วใน SDK เวอร์ชัน 20.3.0 และจะถูกนำออกในเวอร์ชัน 21.0.0 โปรดใช้เมธอด addNetworkExtrasBundle() จากคลาส AdRequest.Builder เดียวกันแทน

การนำวิธีการระบุตำแหน่งออก

ระบบจะนำเมธอดตำแหน่งต่อไปนี้ออกในเวอร์ชัน 21.0.0

  • เมธอด setLocation(Location location) ในคลาส AdRequest.Builder ที่ตั้งค่าตำแหน่งของผู้ใช้เพื่อวัตถุประสงค์ในการกำหนดเป้าหมายสื่อกลาง
  • เมธอด getLocation() ในคลาส AdRequest ที่แสดงข้อมูลการกำหนดเป้าหมายตามสถานที่ของผู้ใช้ซึ่งส่งไปยังเมธอด setLocation(Location location) ก่อนหน้านี้
  • เมธอด getLocation() ในคลาส MediationAdConfiguration ที่แสดงผลตำแหน่งของผู้ใช้ หากกำหนดโดย AdRequest

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

การเลิกใช้งานอินเทอร์เฟซเหตุการณ์ที่กำหนดเอง

เหตุการณ์ที่กำหนดเองช่วยให้ผู้เผยแพร่โฆษณาที่ใช้สื่อกลางสามารถตั้งค่าแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้นซึ่งไม่ใช่แหล่งที่มาของโฆษณาที่ Ad Manager รองรับได้

อินเทอร์เฟซเหตุการณ์ที่กำหนดเองทั้งหมดเลิกใช้งานแล้วเพื่อสนับสนุนคลาส Adapter และอินเทอร์เฟซ MediationAdLoadCallback

ตารางต่อไปนี้แสดงคลาสหรืออินเทอร์เฟซที่เกี่ยวข้องซึ่งคุณต้องใช้สําหรับอินเทอร์เฟซเหตุการณ์ที่กําหนดเองแต่ละรายการตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป

อินเทอร์เฟซ v20.0.0 คลาส/อินเทอร์เฟซ v21.0.0
CustomEvent Adapter
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

ย้ายข้อมูลจาก v19 ไปยัง v20

มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการในเวอร์ชัน 20.0.0 เวอร์ชัน 19.7.0 เปิดตัว API ใหม่หลายรายการ และเลิกใช้งานหรือเปลี่ยนชื่อคลาสหลายคลาสเพื่อเตรียมพร้อมสําหรับเวอร์ชัน 20.0.0 คู่มือนี้จะไฮไลต์การเปลี่ยนแปลงที่สำคัญในเวอร์ชัน 20.0.0

การอัปเดต API รูปแบบเต็มหน้าจอ

ตั้งแต่เวอร์ชัน 20.0.0 เป็นต้นไป รูปแบบโฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล และโฆษณาเปิดแอปจะได้รับการปรับให้เป็นมาตรฐานตามการออกแบบ API ที่สอดคล้องกัน

API รูปแบบเต็มหน้าจอทั้งหมดใช้หลักการต่อไปนี้

  • วิธีการโหลดแบบคงที่
  • กลไก Callback หรือเครื่องมือจัดการการโหลดที่คล้ายกัน
  • การใช้คลาส FullScreenContentCallback สำหรับ Callback ของการนำเสนอ

การนำ RewardedVideoAd API เดิมออก

API RewardedAd ที่ใหม่กว่าเปิดตัวครั้งแรกเมื่อเดือนมีนาคม 2019 และเป็น API ที่มีโฆษณาที่มีการให้รางวัลที่แนะนำมานานกว่า 18 เดือน ซึ่งได้รับการปรับปรุงมากกว่า API RewardedVideoAd เดิม รวมถึงความสามารถในการโหลดโฆษณาที่มีการให้รางวัลมากกว่า 1 รายการต่อครั้ง

ระบบจะนำ RewardedVideoAd API เดิมออกใน SDK เวอร์ชัน 20.0.0

การเลิกใช้งานแบนเนอร์อัจฉริยะเพื่อเปลี่ยนไปใช้แบนเนอร์แบบปรับขนาดได้

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

Java

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

Kotlin

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

การนำ Callback ของแอปพลิเคชันที่ไม่ได้ใช้งานออก

ระบบได้นำ Callback onAdLeftApplication สำหรับรูปแบบโฆษณาทุกรูปแบบออกเพื่อใช้ ProcessLifecycleOwner แทน การใช้ API ระดับระบบปฏิบัติการจะแจ้งให้คุณทราบเมื่อผู้ใช้ออกจากแอป ไม่ว่าจะเกิดจากการโต้ตอบกับโฆษณาหรือไม่ก็ตาม

โปรดทราบว่า Callback onAdLeftApplication ไม่ได้มีไว้เพื่อเป็นเครื่องมือจัดการการคลิกโฆษณา และการใช้ Callback นี้เพื่อรายงานการคลิกไม่ได้สร้างเมตริกที่ถูกต้อง ตัวอย่างเช่น การคลิกไอคอนตัวเลือกโฆษณาอื่นๆ ที่เปิดเบราว์เซอร์ภายนอกจะเรียกใช้ Callback แต่ไม่นับเป็นการคลิก

การเปลี่ยนชื่อชั้นเรียน

ตารางต่อไปนี้แสดงชื่อคลาสที่เฉพาะเจาะจงซึ่งมีการเปลี่ยนแปลงหรือถูกนำออก

  • คลาสส่วนใหญ่ที่เกี่ยวข้องกับ UnifiedNativeAd ได้เปลี่ยนชื่อเป็น NativeAd แล้ว
  • นำคลาสและมุมมอง MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd และ InstreamAd ออกแล้ว
  • คลาสทั้งหมดที่มีคำนำหน้า Publisher ถูกแทนที่ด้วยคำนำหน้า AdManager แล้ว
  • ชื่อแพ็กเกจ InterstitialAd มีการเปลี่ยนแปลง
คลาส 19.5.0 คลาส 20.0.0
com.google.android.gms.ads. com.google.android.gms.ads.
reward.RewardedVideoAd rewarded.RewardedAd
reward.RewardedVideoAdListener rewarded.RewardedAdLoadCallback และ FullScreenContentCallback
reward.RewardItem rewarded.RewardItem
rewarded.RewardedAdCallback OnUserEarnedRewardListener
formats.UnifiedNativeAdView nativead.NativeAdView
formats.UnifiedNativeAd nativead.NativeAd
formats.UnifiedNativeAdAssetNames nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener nativead.NativeAd.OnNativeAdLoadedListener
formats.AdChoicesView nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo nativead.NativeAd.AdChoicesInfo
formats.MediaView nativead.MediaView
formats.NativeAdViewHolder nativead.NativeAdViewHolder
formats.NativeAdOptions nativead.NativeAdOptions
formats.NativeCustomTemplateAd nativead.NativeCustomFormatAd
formats.NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings นำออกแล้ว
doubleclick.PublisherAdRequest admanager.AdManagerAdRequest
doubleclick.PublisherAdView admanager.AdManagerAdView
formats.PublisherAdViewOptions formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd admanager.AdManagerInterstitialAd
InterstitialAd interstitial.InterstitialAd
NativeExpressAdView นำออกแล้ว
instream.InstreamAd นำออกแล้ว
mediation.admob.AdMobExtras นำออกแล้ว
Correlator นำออกแล้ว
search.SearchAdRequest นำออกแล้ว
อินเทอร์เฟซ AdRequest.TagForUnderAgeOfConsent นำออกแล้ว
อินเทอร์เฟซ AdRequest.MaxAdContentRating นำออกแล้ว
formats.NativeAppInstallAd native.NativeAd
formats.NativeAppInstallAdView native.NativeAdView
mediation.NativeAppInstallAdMapper mediation.UnifiedNativeAdMapper
formats.NativeContentAd native.NativeAd
formats.NativeContentAdView native.NativeAdView
mediation.NativeContentAdMapper mediation.UnifiedNativeAdMapper

นำวิธีการออก/แทนที่แล้ว

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงที่เฉพาะเจาะจงในเวอร์ชัน 20.0.0

  • เราได้นำวิธีการเริ่มต้นที่ล้าสมัยออกจากคลาส MobileAds แล้ว
  • ระบบได้นำเมธอดบางรายการจากคลาส AdRequest.Builder() ออกหรือย้ายไปยังคลาส RequestConfiguration แล้ว
  • เราได้อัปเดต RewardedAd API และ InterstitialAd API ให้สอดคล้องกับรูปแบบโฆษณาแบบเต็มหน้าจอทั้งหมด
  • เราได้นำฟีเจอร์ Correlator ออกแล้ว
ชั้นเรียน v19.5.0 API v20.0.0 API หมายเหตุ
AdSize getPortraitBannerAdSizeWithWidth() getPortraitAnchoredAdaptiveBannerAdSize()
getLandscapeBannerAdSizeWithWidth() getLandscapeAnchoredAdaptiveBannerAdSize()
getCurrentOrientationBannerAdSizeWithWidth() getCurrentOrientationAnchoredAdaptiveBannerAdSize()
MobileAds initialize(Context, String) MobileAds.initialize(Context, OnInitializationCompleteListener) ตอนนี้รหัสแอปได้รับการตั้งค่าใน AndroidManifest.xml แล้ว
initialize(Context, String, MobileAds.Settings) initialize(Context, OnInitializationCompleteListener) เลิกใช้งานคลาส Settings แล้ว
getRewardedVideoAdInstance() นำออกแล้ว โปรดใช้ RewardedAd API แทน
AdListener onAdFailedToLoad(int) onAdFailedToLoad(LoadAdError)
onAdLeftApplication() นำออกแล้ว รูปแบบโฆษณาแบบเต็มหน้าจอใช้ FullscreenContentCallback แทน AdListener และไม่มีเมธอดที่เทียบเท่าใน FullscreenContentCallback นําเมธอดออกจาก AdListener แล้ว
VideoController getAspectRatio() MediaContent.getAspectRatio()
PublisherAdRequest getGender() นำออกแล้ว
getBirthday() นำออกแล้ว
getNetworkExtras() นำออกแล้ว
setManualImpressionsEnabled() นำออกแล้ว
updateCorrelator() นำออกแล้ว ดูการกรองเนื้อหาโฆษณา
PublisherAdRequest.Builder setBirthday() นำออกแล้ว
setGender() นำออกแล้ว
setIsDesignedForFamilies() นำออกแล้ว ดูคำแนะนำ
addTestDevice() RequestConfiguration.Builder.setTestDeviceIds() ดูเปิดใช้โฆษณาทดสอบ
tagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForChildDirectedTreatment() ดูการกรองเนื้อหาโฆษณา
setTagForUnderAgeOfConsent() RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
setMaxAdContentRating() RequestConfiguration.Builder.setMaxAdContentRating()
AdView getMediationAdapterClassName() ResponseInfo.getMediationAdapterClassName() ออบเจ็กต์ ResponseInfo พร้อมใช้งานโดยใช้เมธอด AdView, getResponseInfo()
NativeAdOptions setImageOrientation() setMediaAspectRatio()
getImageOrientation getMediaAspectRatio()
RewardedAd loadAd(AdRequest, RewardedAdLoadCallback) RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback) ตอนนี้ RewardedAd ใช้วิธีการโหลดแบบคงที่เหมือนกับรูปแบบโฆษณาแบบเต็มหน้าจออื่นๆ
loadAd(PublisherAdRequest, RewardedAdLoadCallback) RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback)
isLoaded() นำออกแล้ว Callback จากเมธอดการโหลดแบบคงที่จะแสดงโฆษณาที่โหลดแล้ว
show(Activity, RewardedAdCallback) show(Activity, OnUserEarnedRewardListener) วิธีการแสดงนี้เป็นไปตามแนวทางรูปแบบเต็มหน้าจอที่กว้างขึ้น
RewardedAdLoadCallback onRewardedAdFailedToLoad(int) onAdFailedToLoad(LoadAdError)
onRewardedAdFailedToLoad(LoadAdError) onAdFailedToLoad(LoadAdError)
onRewardedAdLoaded() onAdLoaded(RewardedAd)
AppOpenAdLoadCallback onAppOpenAdFailedToLoad(int) onAdFailedToLoad(LoadAdError)
onAppOpenAdFailedToLoad(LoadAdError) onAdFailedToLoad(LoadAdError)
onAppOpenAdLoaded(AppOpenAd) onAdLoaded(AppOpenAd)
RewardedInterstitialAdLoadCallback onRewardedInterstitialAdFailedToLoad(int) onAdFailedToLoad(LoadAdError)
onRewardedInterstitialAdFailedToLoad(LoadAdError) onAdFailedToLoad(LoadAdError)
onRewardedInterstitialAdLoaded(RewardedInterstitialAd) onAdLoaded(RewardedInterstitialAd)
PublisherInterstitialAd new PublisherInterstitialAd() InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback) ตอนนี้ InterstitialAd ใช้วิธีการโหลดแบบคงที่เหมือนกับรูปแบบโฆษณาแบบเต็มหน้าจออื่นๆ
setAdListener()
DynamicHeightSearchAdRequest getNetworkExtras() นำออกแล้ว เลิกใช้งานคลาส NetworkExtras แล้ว
AdLoader forContentAd() นำออกแล้ว
forAppInstallAd() นำออกแล้ว
withCorrelator() นำออกแล้ว
getMediationAdapterClassName() นำออกแล้ว