การย้ายข้อมูล SDK

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

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

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

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

ตั้งแต่เวอร์ชัน 24.0.0 เป็นต้นไป SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google กําหนดให้แอปทั้งหมดต้องทํางานใน Android API ระดับ 23 เป็นอย่างน้อย หากต้องการปรับระดับ API ให้เปลี่ยนค่า minSdk ในไฟล์ build.gradle ระดับแอปเป็น 23 ขึ้นไป

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

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

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

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

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

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

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

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

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

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

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

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

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

  • DynamicHeightSearchAdRequest
  • SearchAdRequest
  • SearchAdView

วิธีการที่ถูกนำออก

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

ระดับ วิธีการ
RewardedInterstitialAdLoadCallback onRewardedInterstitialAdLoaded()
onRewardedInterstitialAdFailedToLoad(int)
onRewardedInterstitialAdFailedToLoad(LoadAdError)

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

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

ระดับ วิธีการ
Adapter loadInterscrollerAd()
RtbAdapter loadRtbInterscrollerAd()

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

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

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

ตั้งแต่เวอร์ชัน 23.0.0 เป็นต้นไป SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google กำหนดให้แอปทั้งหมดต้องมี ระดับ API ของ Android ขั้นต่ำที่ 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.

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

API v22.0.0 API v23.0.0
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()

ย้ายข้อมูลจากเวอร์ชัน 21 ไปยังเวอร์ชัน 22

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

ใช้ MobileAds.getVersion() เพื่อรับเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

เรานำวิธีการ MobileAds.getVersionString() ออกในเวอร์ชัน 22.0.0 เพื่อให้รองรับ MobileAds.getVersion()

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

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

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

ตั้งแต่เวอร์ชัน 22 เป็นต้นไป คุณจะสร้าง MediaView ของตัวเองและตั้งค่าเนื้อหาสื่อ ของ 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

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

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

ตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google กําหนดให้แอปทั้งหมดต้องมี ระดับ API ของ Android ขั้นต่ำที่ 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 ของบุคคลที่สามเพื่อระบุข้อมูลให้กับเครือข่ายโฆษณาบุคคลที่สามหากจำเป็น

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

เหตุการณ์ที่กำหนดเองช่วยให้ผู้เผยแพร่โฆษณาที่ใช้ สื่อกลางสามารถตั้งค่าแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation) ที่ไม่ใช่ แหล่งที่มาของโฆษณาที่รองรับของ 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 รูปแบบเต็มหน้าจอทั้งหมดใช้หลักการต่อไปนี้

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

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

เราเปิดตัว 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)
    }
}

การนำการเรียกกลับของแอปพลิเคชันที่ออกไปแล้วออก

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

โปรดทราบว่าonAdLeftApplication Callback ไม่ได้มีไว้เพื่อเป็นตัวแฮนเดิลการคลิกโฆษณา และการใช้ 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 นำออกแล้ว
สหสัมพันธ์ นำออกแล้ว
search.SearchAdRequest นำออกแล้ว
Interface 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
  • เราได้อัปเดต API ของ RewardedAd และ InterstitialAd เพื่อให้สอดคล้องกับรูปแบบโฆษณาแบบเต็มหน้าจอทั้งหมด
  • ระบบได้นำฟีเจอร์ตัวเชื่อมโยงออกแล้ว
ระดับ API v19.5.0 API v20.0.0 หมายเหตุ
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) เลิกใช้งานคลาสการตั้งค่าแล้ว
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() นำออกแล้ว การเรียกกลับจากเมธอดโหลดแบบคงที่จะแสดงโฆษณาที่โหลดแล้ว
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() นำออกแล้ว