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

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

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

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

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

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

การเปลี่ยนแปลง API ขนาดแบนเนอร์แบบปรับขนาดได้แบบยึดพื้น

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

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

การนำชั้นเรียน 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

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

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

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

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

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

นำการอ้างอิง 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() Callback ใน MediationRewardedAdCallback และเลิกใช้งาน onUserEarnedReward(RewardItem) AdMob Mediation Adapter ต้องเริ่มเรียกใช้ onUserEarnedReward() เมื่อผู้ใช้ได้รับรางวัล

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

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

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

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

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

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

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

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

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

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

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

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

AdManagerAdRequest.Builder วิธีที่รับค่ามาจากคลาสแม่สามารถเชื่อมโยงได้

ในเวอร์ชัน 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.

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

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

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

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

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

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

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

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

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

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

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

ตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องมี ระดับ 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 ที่ไม่ใช่ แหล่งที่มาของโฆษณาที่รองรับของ 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 สำหรับการเรียกกลับของงานนำเสนอ

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

เราเปิดตัว API เวอร์ชันใหม่กว่า RewardedAd ครั้งแรกในเดือนมีนาคม 2019 และเป็น API ที่เราแนะนำให้ใช้สำหรับโฆษณาที่มีการให้รางวัลมานานกว่า 18 เดือน โดยมีการปรับปรุงมากกว่าเมื่อเทียบกับ API รุ่นเดิม RewardedVideoAd ซึ่งรวมถึงความสามารถในการโหลดโฆษณาที่มีการให้รางวัลมากกว่า 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)
    }
}

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

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

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

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

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

• เราได้เปลี่ยนชื่อชั้นเรียนส่วนใหญ่ที่เกี่ยวข้องกับ UnifiedNativeAd เป็น NativeAd แล้ว
• ระบบได้นำคลาสและมุมมอง MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd และ InstreamAd ออกแล้ว
• คลาสทั้งหมดที่มีคำนำหน้า Publisher ถูกแทนที่ด้วยคำนำหน้า AdManager แล้ว
• InterstitialAd มีการเปลี่ยนชื่อแพ็กเกจ

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

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

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