การย้ายข้อมูล 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 สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ โปรดดู ใช้ Google Mobile ใหม่ SDK โฆษณา getVersion()

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

ในเวอร์ชัน 21 SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google มอบ 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 ขึ้นไป

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

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

การเปลี่ยนแปลงนี้อาจทำให้แอป Kotlin และแอปที่ใช้การตรวจสอบ Java 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 ของ Google

ตารางด้านล่างแสดงรายการคลาสหรืออินเทอร์เฟซที่เกี่ยวข้องที่ควรใช้ สำหรับอินเทอร์เฟซเหตุการณ์ที่กำหนดเองแต่ละรายการเริ่มตั้งแต่เวอร์ชัน 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 เดิมออก

ใหม่ RewardedAd API เปิดตัวครั้งแรกในเดือนมีนาคม 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 ของแอปพลิเคชันออก

ระบบนำการเรียกกลับ 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 โฆษณาที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้าเพื่อให้สอดคล้องกับ รูปแบบเต็มหน้าจอ
• นำฟีเจอร์สหสัมพันธ์ออกแล้ว