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

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

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

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

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

เชื่อมโยงเมธอด AdManagerAdRequest.Builder ที่รับช่วงมาจาก Superclass ได้

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

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

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

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

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

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

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

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

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

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

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

// 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);
    }
}

// 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

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

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

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

บังคับใช้การเว้นว่างแบบเข้มงวด

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

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

การนำเมธอด 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

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

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

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

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

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

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

การนำ มีการให้รางวัลแนววิดีโอโฆษณา API เดิมออก

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

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

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

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

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);
  }
}

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 มีการเปลี่ยนแปลง

วิธีการที่ถูกลบ/แทนที่

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

• ระบบได้นำวิธีการเริ่มต้นที่ล้าสมัยออกจากคลาส MobileAds แล้ว
• ระบบได้นำบางเมธอดจากคลาส AdRequest.Builder() ออก หรือย้ายไปที่คลาส RequestConfiguration แล้ว
• เราได้อัปเดต API โฆษณาที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้าเพื่อให้สอดคล้องกับรูปแบบแบบเต็มหน้าจอทั้งหมด
• นำฟีเจอร์สหสัมพันธ์ออกแล้ว