เวอร์ชัน
วันที่เผยแพร่
Notes
23.2.0
27‐06‐2024
23.1.0
09‐05-2024
ต้องมีอย่างน้อย compileSdkVersion
จาก 34
อะแดปเตอร์สื่อกลางเนทีฟ : เลิกใช้งาน loadNativeAd
และ loadRtbNativeAd()
เพื่อใช้ loadNativeAdMapper()
และ loadRtbNativeAdMapper()
แทน
อะแดปเตอร์ควรย้ายข้อมูลไปใช้วิธีการโหลดแบบใหม่เหล่านี้และออบเจ็กต์ที่เกี่ยวข้อง
23.0.0
07-03-2024
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v23
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
เพิ่มระดับ API ขั้นต่ำของ Android เป็น 21
หากต้องการรวบรวมเมตริกผู้ใช้ใน AdMob ต่อไป ให้ลิงก์แอป AdMob กับ Firebase และผสานรวม SDK ของ Google Analytics สำหรับ Firebase เข้ากับแอป
นํา MobileAds.enableSameAppKey()
API ที่เลิกใช้งานแล้วออกและอัปเดตเมธอดทางเลือก MobileAds.putPublisherFirstPartyIdEnabled()
เพื่อแสดงผลบูลีนว่าความต่อเนื่องของการควบคุมสำเร็จหรือไม่
Native Ads
:
นำ AdLoader.forUnifiedNativeAd()
ออกแล้ว โปรดใช้ AdLoader.forNativeAd()
แทน
นำ AdLoader.forCustomTemplateAd()
ออกแล้ว โปรดใช้ AdLoader.forCustomFormatAd()
แทน
นำ AdFormat.UNKNOWN
ออกแล้วโดยไม่มีการแทนที่ แอปที่ใช้ QueryInfo.generate()
ต้องผ่านรูปแบบโฆษณา
ตอนนี้คุณเชื่อมโยงเมธอด AdManagerAdRequest.Builder
ที่รับช่วงมาจากระดับบนสุดเข้าด้วยกันเพื่อสร้างออบเจ็กต์จากการเรียกใช้ครั้งเดียวได้แล้ว
การดำเนินการนี้จำเป็นต้องมีการเปลี่ยนแปลงโครงสร้างการรับค่าเพื่อให้ AdManagerAdRequest.Builder
ไม่ได้รับช่วงค่าจาก AdRequest.Builder
อีกต่อไป
เพิ่ม MobileAds.registerCustomTabsSession() เพื่อปรับปรุงการสร้างรายได้สำหรับโฆษณาในแท็บที่กำหนดเอง ดูข้อมูลเพิ่มเติมที่เพิ่มประสิทธิภาพแท็บที่กำหนดเอง
อัปเดตการใช้ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 2.2.0
22.6.0
06-12-2023
22.5.0
30-10-2023
22.4.0
13‐09-2023
ต้องมีอย่างน้อย compileSdkVersion
ที่ 33
เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สําหรับการขอและแสดงโฆษณาที่ขอผ่าน UI ของเครื่องมือตรวจสอบโฆษณา
เพิ่มเมธอด QueryInfo.generate()
ใหม่ที่ใช้รหัสหน่วยโฆษณา
เปิดใช้การทดสอบ API การรักษาความเป็นส่วนตัว ของ Attribution Reporting เวอร์ชันเบต้าและ Topics เวอร์ชันเบต้าเป็นครั้งแรก
ดูข้อมูลเพิ่มเติมได้ที่คู่มือ AdMob Privacy Sandbox ใน Android
22.3.0
2023‐08
22.2.0
05‐07-2023
22.1.0
18‐05-2023
เครื่องมือตรวจสอบโฆษณา: เปิดใช้ความสามารถในการทริกเกอร์คําขอโฆษณาจาก UI เครื่องมือตรวจสอบโฆษณาในอุปกรณ์ที่ไม่มีบริการ Google Play
22.0.0
29‐03‐2023
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v22
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
เพิ่ม AdRequest.getRequestAgent()
แล้ว
สื่อกลาง: ค่าที่ส่งกลับสำหรับ Adapter.getVersionInfo()
และ Adapter.getSDKVersionInfo()
เปลี่ยนจากประเภท com.google.android.gms.ads.mediation.VersionInfo
เป็น com.google.android.gms.ads.VersionInfo
เราขอแนะนำให้อะแดปเตอร์ส่งคืนประเภทใหม่เนื่องจาก com.google.android.gms.ads.mediation.VersionInfo
เลิกใช้งานแล้ว
21.5.0
31‐01-2023
โฆษณาเปิดแอป: เลิกใช้งาน AppOpenAd.load()
เมธอดที่ยอมรับพารามิเตอร์การป้อนข้อมูลการวางแนวและเพิ่มเมธอดใหม่ๆ ที่ไม่ได้ใช้อินพุตการวางแนว วิธีการใหม่จะกำหนดการวางแนว ณ เวลาที่ขอ ซึ่งตรงกับลักษณะการทำงานของรูปแบบโฆษณาแบบเต็มหน้าจออื่นๆ
สื่อกลาง: เพิ่มการรองรับสื่อกลางสำหรับโฆษณาเปิดแอป
นำสิทธิ์ RECEIVE_BOOT_COMPLETED
ออกจากทรัพยากร Dependency ของ androidx.work:work-runtime
แล้ว หากใช้ Gradle เวอร์ชันที่เก่ากว่า 7.2.0 และต้องการสิทธิ์สำหรับแอป คุณอาจต้องประกาศสิทธิ์อย่างชัดแจ้งในไฟล์ Manifest ของ Android
21.4.0
14-12-2022
ตอนนี้คุณต้องระบุรหัสแอป Ad Manager สำหรับแอป Ad Manager ทั้งหมดและใช้รูปแบบ ca-app-pub-################~##########
โปรดดูรายละเอียดเพิ่มเติมที่กำหนดค่าแอป
เครื่องมือตรวจสอบโฆษณา: ขยายการรองรับ SDK เพื่อแสดงโฆษณาแบนเนอร์และโฆษณาเนทีฟที่ขอผ่าน UI ของเครื่องมือตรวจสอบ
เพิ่มการรองรับรหัสของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณา (ก่อนหน้านี้เรียกว่าคีย์แอปเดียวกัน) เพื่อช่วยให้คุณแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้และมีความเกี่ยวข้องมากขึ้นโดยใช้ข้อมูลที่รวบรวมจากแอปของคุณ
เวอร์ชันการเผยแพร่อย่างเป็นทางการสำหรับรุ่น QueryInfo
21.3.0
10-2022
เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สําหรับการขอและแสดงโฆษณาที่ขอผ่าน UI ของเครื่องมือตรวจสอบโฆษณา
โฆษณาเนทีฟ:
โฆษณาเนทีฟที่กำหนดเอง
21.2.0
06‐09-2022
เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สำหรับการส่งออกบันทึกคำขอโฆษณาผ่าน Android Sharesheet
21.1.0
14‐07-2022
เพิ่มการรองรับการสร้างรายได้จากโฆษณาภายใน WebView
ดูรายละเอียดเพิ่มเติมได้ที่ผสานรวม WebView API สำหรับโฆษณา
เพิ่ม getResponseExtras()
ไปยัง
ResponseInfo
ซึ่งอาจแสดงข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของโฆษณา
เบต้า: getResponseExtras()
API อยู่ในเวอร์ชันเบต้า ค่าการแสดงผลอาจเปลี่ยนแปลงหากไม่มีรุ่น SDK
21.0.0
25‐05-2022
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้จากคำแนะนำในการย้ายข้อมูลไปยัง SDK v21
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
ตอนนี้ Google Mobile Ads SDK กำหนดให้แอปทั้งหมดต้องใช้ Android API ระดับ 19 เป็นอย่างน้อยจึงจะทำงานได้
เพิ่มคำอธิบายประกอบ @NonNull
ในทุกเมธอดที่ก่อนหน้านี้ไม่ได้กำหนดความสามารถในการเว้นว่างอย่างชัดเจน
นำ AdRequest.Builder.addNetworkExtras()
เมธอดออกแล้ว
โปรดใช้ AdRequest.Builder.addNetworkExtrasBundle()
แทน
นำวิธีการระบุตำแหน่งต่อไปนี้ออกแล้ว
setLocation()
บน
AdRequest.Builder
getLocation()
ใน AdRequest
getLocation()
บน
MediationAdConfiguration
เพิ่มแฟล็กไฟล์ Manifest เพื่อเพิ่มประสิทธิภาพการเริ่มต้นและการโหลดโฆษณา ดูรายละเอียดเพิ่มเติมได้ในคู่มือการเพิ่มประสิทธิภาพการเริ่มต้นและการโหลดโฆษณา
เลิกใช้งาน MobileAds.getVersionString()
โปรดใช้ MobileAds.getVersion()
แทน
เพิ่มเมธอด
getLoadedAdapterResponseInfo()
ใน ResponseInfo
แล้ว
เพิ่มเมธอดต่อไปนี้ใน
AdapterResponseInfo
:
getAdSourceName()
getAdSourceId()
getAdSourceInstanceName()
getAdSourceInstanceId()
เบต้า: API เหล่านี้อยู่ในรุ่นเบต้า ค่าที่แสดงผลอาจเปลี่ยนแปลงหากไม่มีรุ่น SDK
เพิ่มการรองรับเหตุการณ์ที่กำหนดเองในเครื่องมือตรวจสอบโฆษณา
20.6.0
2022‐02
20.5.0
18-11-2021
เพิ่มการรองรับอุปกรณ์ Android 12 สำหรับแอปที่กำหนดเป้าหมายเป็น API 31
เพิ่มการรองรับ
รหัสชุดแอป
สำหรับ Use Case เช่น การรายงานและการป้องกันการประพฤติมิชอบ
20.4.0
2021‐09
รุ่นนี้และเวอร์ชันก่อนหน้าทั้งหมดต้องมีการพึ่งพา androidx.work:work-runtime:2.7.0
อย่างชัดเจน เพื่อแก้ไขข้อบกพร่องที่ทำให้แอปขัดข้องใน Android S ที่มีสแต็กเทรซต่อไปนี้
Fatal Exception: java.lang.IllegalArgumentException:
com.mycompany.myapp: Targeting S+ (version 10000 and above)
requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be
specified when creating a PendingIntent.
Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE
if some functionality depends on the PendingIntent being mutable,
e.g. if it needs to be used with inline replies or bubbles.
at android.app.PendingIntent.checkFlags(PendingIntent.java:386)
at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657)
at android.app.PendingIntent.getBroadcast(PendingIntent.java:644)
at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174)
at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108)
at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86)
at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641)
at java.lang.Thread.run(Thread.java:920)
หากต้องการแก้ไขข้อบกพร่องนี้ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้สำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ลงในไฟล์ Gradle ระดับแอปของโมดูล
dependencies {
implementation 'com.google.android.gms:play-services-ads:20.4.0'
// For apps targeting Android 12, add WorkManager dependency.
constraints {
implementation('androidx.work:work-runtime:2.7.0') {
because '''androidx.work:work-runtime:2.1.0 pulled from
play-services-ads has a bug using PendingIntent without
FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps
targeting S+.'''
}
}
}
ตั้งแต่เวอร์ชัน 20.4.0 เป็นต้นไป SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะรวมสิทธิ์ com.google.android.gms.permission.AD_ID
ในไฟล์ Manifest ของ SDK ที่เครื่องมือสร้างของ Android ผสานเข้ากับไฟล์ Manifest ของแอปโดยอัตโนมัติ ดูข้อมูลเพิ่มเติมเกี่ยวกับการประกาศสิทธิ์ของ AD_ID
รวมถึงวิธีปิดใช้ได้ที่
บทความช่วยเหลือนี้ของ Play Console
เพิ่ม Callback
onAdClicked()
ไปยัง FullScreenContentCallback
แล้ว
เปิดใช้การโทรกลับ
onAdClicked()
ในคลาส AdListener
สำหรับรูปแบบโฆษณาเนทีฟ
20.3.0
23-08‐2021
20.2.0
08‐06-2021
เพิ่มการรองรับเครื่องมือตรวจสอบโฆษณา (เบต้า) สำหรับผู้เผยแพร่โฆษณา Google Ad Manager
20.1.0
29-04-2021
20.0.0
05-04-2021
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ในคู่มือการเตรียมพร้อมสำหรับ SDK v20
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
นำ Interstitial
API เดิมออกแล้ว
นำ RewardedVideoAd
API เดิมออกแล้ว
ชั้นเรียนที่นำออกซึ่งขึ้นต้นด้วย Publisher
(เช่น PublisherAdView
).
นำ CustomRenderedAd
ออกแล้ว
นำ InstreamAd
ออกแล้ว
นำ SearchAdRequest
ออกแล้ว
นำ AdListener.onAdLeftApplication()
ออกแล้ว
นำ NativeAppInstallAd
, NativeContentAd
และ UnifiedNativeAd
ออกแล้ว
ขณะนี้มีรูปแบบโฆษณาเนทีฟ 1 รูปแบบที่ชื่อว่า NativeAd
RewardedAd
เป็นชั้นเรียนนามธรรมแล้ว ใช้ RewardedAd.load()
วิธีแบบคงที่เพื่อโหลดโฆษณาที่มีการให้รางวัล
เพิ่ม
เครื่องมือตรวจสอบโฆษณา (เบต้า)
เลิกใช้งาน AdSize.SMART_BANNER
แล้วเพื่อใช้โฆษณาแบนเนอร์แบบปรับขนาดได้
เพิ่มคำอธิบายประกอบที่ไม่มีข้อมูลที่ชัดเจนใน API สาธารณะทั้งหมด
19.8.0
15-03-2021
เพิ่มทรัพยากร Dependency ใน
User Messaging Platform SDK
เพิ่ม Callback onAdImpression()
ที่
FullScreenContentCallback
แล้ว
เลิกใช้รูปแบบ InstreamAd
อะแดปเตอร์สื่อกลาง
เลิกใช้งาน MediationBannerAdapter
, MediationInterstitialAdapter
และ MediationNativeAdapter
แล้ว อะแดปเตอร์ใหม่ควรใช้คลาส Adapter
เพื่อโหลดรูปแบบเหล่านี้ หมายเหตุ: ระบบจะไม่นำคลาสของอะแดปเตอร์สื่อกลางที่เลิกใช้งานเหล่านี้ออกในเวอร์ชัน 20.0.0 เพื่อให้อะแดปเตอร์สื่อกลางเปลี่ยนไปใช้ API ใหม่
ตอนนี้อะแดปเตอร์การเสนอราคาสามารถใช้วิธีโหลดที่แตกต่างกันในคลาส Adapter
สำหรับรูปแบบเฉพาะ RTB ได้แล้ว
19.7.0
20-01‐20
การเปลี่ยนแปลงที่สำคัญของสิ่งต่อไปนี้
InterstitialAd
RewardedAd
NativeAd
AppOpenAd
เลิกใช้งาน CustomRenderedAd
เลิกใช้งานคลาสและแพ็กเกจที่มีคำนำหน้า Publisher
และแทนที่ด้วยคำนำหน้า AdManager
แล้ว
รุ่นย่อยล่าสุดก่อนเวอร์ชัน 20.0.0 ระบบจะนำ API ทั้งหมดที่ทำเครื่องหมายว่าเลิกใช้งานในรุ่นนี้และรุ่นก่อนหน้าออกในเวอร์ชัน 20.0.0 ดูรายละเอียดเพิ่มเติมได้ในคำแนะนำในการย้ายข้อมูลเวอร์ชัน 20.0.0
19.6.0
04-12-2020
เลิกใช้งานเมธอด onAdLeftApplication() AdListener
แล้ว
แก้ไขข้อบกพร่องที่ระบบขอให้ผู้ใช้อุปกรณ์ Android 11 เลือกเบราว์เซอร์เมื่อคลิกโฆษณา
19.5.0
2020‐10‐20
โฆษณาแบนเนอร์: ตอนนี้เราเรียกเมธอด onAdImpression()
AdListener
สำหรับโฆษณาแบนเนอร์
เพิ่มเมธอด setHttpTimeoutMillis()
เพื่อปรับแต่งระยะหมดเวลาสำหรับการเรียก HTTPS ที่ดำเนินการโดย Google Mobile Ads SDK
19.4.0
10‐09-2020
เพิ่มการรองรับอุปกรณ์ Android 11 สำหรับแอปที่กำหนดเป้าหมายเป็น API 30
โฆษณาเปิดแอป: เปลี่ยนรูปแบบ AppOpenAd
ให้ทํางานเหมือนกับรูปแบบเต็มหน้าจอมากกว่ามุมมองแบนเนอร์ เพิ่มเมธอด getResponseInfo()
และ show()
ลงใน AppOpenAd
แล้ว เลิกใช้งานคลาส AppOpenAdView
และ AppOpenAdPresentationCallback
แล้ว
สื่อกลาง: การรายงานสถานะสื่อกลางพร้อมใช้งานแล้ว ใช้
ResponseInfo.getAdapterResponses()
เพื่อรับข้อมูลการตอบกลับของแต่ละเครือข่ายโฆษณาที่เข้าร่วมในคำขอโฆษณา
โฆษณาที่มีการให้รางวัลแบบเดิม: เลิกใช้งาน RewardedVideoAd
แก้ไขข้อบกพร่องที่ MobileAds.initialize()
เรียกตัวแฮนเดิลการเสร็จสมบูรณ์กลับเพียงครั้งเดียว การโทรไปยัง MobileAds.initialize()
ทุกครั้งจะเรียกใช้ Callback ที่เสร็จสมบูรณ์
19.3.0
20-07‐20
ข้อควรระวัง: SDK เวอร์ชัน 19.3.0 และต่ำกว่าจะไม่รองรับ Android 11 (API 30) เราขอแนะนำให้ใช้ SDK เวอร์ชัน 19.4.0 ขึ้นไปหากวางแผนที่จะตั้งค่า
targetSdkVersion
เป็น API 30
เพิ่มเมธอด getDomain()
และ getCause()
ลงใน AdError
แล้ว
เพิ่มการเรียกกลับความล้มเหลวในการโหลดใหม่ไปยังรูปแบบโฆษณาทั้งหมดที่แสดงผล LoadAdError
เช่น onAdFailedToLoad(LoadAdError)
.
Callback ที่ไม่สำเร็จเกี่ยวกับการโหลดที่เลิกใช้งานแล้วซึ่งแสดงผล Int เช่น onAdFailedToLoad(int)
.
โฆษณาที่มีการให้รางวัล: เพิ่ม onRewardedAdFailedToShow(AdError)
และเลิกใช้งาน onRewardedAdFailedToShow(int)
สื่อกลางที่มีการให้รางวัล: เพิ่มรหัสข้อผิดพลาดของงานนำเสนอ MEDIATION_SHOW_ERROR
ตอนนี้ข้อผิดพลาดในการนำเสนอทั้งหมดที่เกี่ยวข้องกับโฆษณาที่ใช้สื่อกลางจะแสดงผล MEDIATION_SHOW_ERROR
สำหรับ AdError.getCode()
และ AdError.getCause()
NonNull ที่แสดงถึงข้อผิดพลาดของสื่อกลางที่สำคัญ
19.2.0
18‐06-2020
เพิ่มรูปแบบ RewardedInterstitialAd
แล้ว ปัจจุบันฟีเจอร์นี้อยู่ในรุ่นเบต้าแบบส่วนตัว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
โฆษณาเนทีฟ: เพิ่ม UI ของเครื่องมือตรวจสอบโฆษณาเนทีฟในคำขอทดสอบเพื่อช่วยให้คุณตรวจพบและแก้ไขการละเมิดนโยบายเกี่ยวกับโฆษณาเนทีฟได้
เพิ่มเมธอด MobileAds.disableMediationAdapterInitialization()
แล้ว เรียกใช้เมธอดนี้ก่อนที่จะเริ่มต้น Google Mobile Ads SDK เพื่อปิดใช้การเริ่มต้นอะแดปเตอร์สื่อกลาง
คำเตือน: การเรียกใช้วิธีการนี้อาจส่งผลเสียต่อประสิทธิภาพสื่อกลาง Google ควรเรียกวิธีการนี้ก็ต่อเมื่อคุณรวมอะแดปเตอร์สื่อกลางของ Google ไว้ในแอป แต่ไม่ได้เป็นสื่อกลางผ่าน Google ระหว่างเซสชันของแอปที่เจาะจง (เช่น คุณกำลังเรียกใช้การทดสอบสื่อกลาง A/B)
19.1.0
16‐04-2020
19.0.1
18‐03-2020
โฆษณาเนทีฟ: แก้ไขการรั่วไหลของหน่วยความจำที่เกิดขึ้นเมื่อใช้ NativeCustomTemplateAd
19.0.0
02‐03-2020
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบดังต่อไปนี้
เพิ่มการรองรับการอ่านพารามิเตอร์ความยินยอมจาก TCF เวอร์ชัน 2.0 ของ IAB และสตริง us_privacy
ของ IAB
เพิ่ม setNeighboringContentUrls()
และ getNeighboringContentUrls()
ลงใน AdRequest
แล้ว
เพิ่มคลาส ResponseInfo
ที่ให้ข้อมูลเกี่ยวกับโฆษณาที่โหลด
สำหรับโฆษณาทุกรูปแบบ เลิกใช้งาน getMediationAdapterClassName()
เพื่อใช้ getResponseInfo()
โฆษณาเนทีฟ: เพิ่ม getDuration()
และ getCurrentTime()
เมธอดใน MediaContent
สื่อกลางแบบเนทีฟ: เพิ่มเมธอด getDuration()
และ getCurrentTime()
ลงใน UnifiedNativeAdMapper
เพื่อให้อะแดปเตอร์ใช้งาน
เลิกใช้งาน
AdRequest.Builder.addTestDevice()
โปรดใช้
RequestConfiguration.Builder.setTestDeviceIds()
แทน
18.3.0
05-11-2019
เพิ่ม API สำหรับรูปแบบโฆษณา InstreamAd
แล้ว ขณะนี้ฟีเจอร์นี้อยู่ใน
รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
แบนเนอร์แบบปรับขนาดได้ : เปลี่ยนวิธีสร้างแบนเนอร์แบบปรับขนาดได้ในชั้นเรียน AdSize
เช่น เปลี่ยนชื่อ AdSize.getCurrentOrientationBannerAdSizeWithWidth()
เป็น AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize()
สื่อกลาง : ตอนนี้ Google Mobile Ads SDK สามารถตรวจจับข้อยกเว้นที่เกิดจากอะแดปเตอร์สื่อกลางได้แล้ว
สื่อกลางที่มีการให้รางวัล : แก้ไขข้อบกพร่องในกรณีที่ระบบแคชโฆษณาที่มีการให้รางวัลที่ใช้สื่อกลางหลายรายการไว้ ระบบจะแสดงเพียงรายการเดียว
เพิ่มเมธอด
setTestDeviceIds()
เพื่อเปิดใช้การตั้งค่าอุปกรณ์ทดสอบ 1 ครั้งสำหรับคำขอโฆษณาทั้งหมด
18.2.0
29‐08‐2019
เพิ่ม API สำหรับรูปแบบ
AppOpenAd
แล้ว ขณะนี้ฟีเจอร์นี้อยู่ใน
รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
18.1.1
23‐07-2019
18.1.0
09‐07-2019
18.0.0
17‐06-2019
หมายเหตุ: รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
17.2.1
21‐05-2019
แก้ไข ANR ที่เกิดขึ้นเมื่อ android.media.AudioManager.getStreamVolume
17.2.0
11‐03-2019
วิดีโอที่มีการให้รางวัล: เพิ่ม API ที่มีการให้รางวัลชุดใหม่ (ดูแพ็กเกจที่มีการให้รางวัล ) ที่ช่วยให้คุณโหลดโฆษณาที่มีการให้รางวัลหลายรายการพร้อมกันได้
สื่อกลาง: เพิ่ม API ของอะแดปเตอร์สื่อกลางชุดใหม่ที่รองรับการเริ่มต้น อะแดปเตอร์ที่ใช้ API ใหม่จะใช้คลาส Adapter
ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics
ร่วมกับเวอร์ชัน 17.2.0
ของไลบรารีโฆษณา (เช่น com.google.android.gms:play-services-ads:17.2.0
) ต้องใช้ com.google.firebase:firebase-analytics:16.3.0
17.1.3
31‐01-2019
ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics
ร่วมกับเวอร์ชัน 17.1.3
ของไลบรารีโฆษณา (เช่น com.google.android.gms:play-services-ads:17.1.3
) ต้องใช้ com.google.firebase:firebase-analytics:16.3.0
17.1.2
03-12-2018
ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics
ร่วมกับเวอร์ชัน 17.1.2
ของไลบรารีโฆษณา (เช่น com.google.android.gms:play-services-ads:17.1.2
) ต้องใช้ com.google.firebase:firebase-analytics:16.0.6
17.1.1
12-11-2018
แก้ไขข้อบกพร่องที่ชุดค่าผสม play-services-ads
และ firebase-analytics
บางรายการ (เช่น ads:17.1.0
และ analytics:16.0.5
) ส่งผลให้เกิดข้อผิดพลาดของคอมไพเลอร์ duplicate entry
ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics
ร่วมกับเวอร์ชัน 17.1.1
ของไลบรารีโฆษณา (เช่น com.google.android.gms:play-services-ads:17.1.1
) ต้องใช้ com.google.firebase:firebase-analytics:16.0.5
17.1.0
02‐11-2018
17.0.0
05-10-2018
ผู้เผยแพร่โฆษณา AdMob ของ Google จะต้องระบุแท็ก <meta-data>
ด้วยคีย์
com.google.android.gms.ads.APPLICATION_ID
ใน AndroidManifest.xml ของตน ดูรายละเอียดเพิ่มเติมได้จาก
คู่มือเริ่มต้นใช้งาน
โฆษณาเนทีฟ: NativeAppInstallAd
, NativeContentAd
และ API ที่เชื่อมโยงเลิกใช้งานแล้วเพื่อกำหนดให้ UnifiedNativeAd
โปรดดูวิธีการใช้ API ใหม่เพิ่มเติมในโฆษณาเนทีฟขั้นสูงแบบรวม
โฆษณาเนทีฟ: เพิ่มฟีเจอร์ "ซ่อนโฆษณานี้"
โฆษณาเนทีฟ: บันทึกคำเตือนที่ไม่เป็นอันตราย: "UnconfirmedClickListener ต้องไม่เป็นค่าว่างในขณะที่ตั้งค่า ClickConfirmingView" ไว้แล้ว" ถูกนำออกแล้ว
โฆษณาที่มีการให้รางวัล: เพิ่มเมธอด setAdMetadataListener
ใน
RewardedVideoAd
เพื่อฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณา
โฆษณาที่มีการให้รางวัล: การเรียกใช้ destroy()
จะทำให้ผู้ฟังเป็นโมฆะ
เลิกใช้งานเมธอดต่อไปนี้ใน AdRequest.Builder
แก้ไขข้อบกพร่องที่ onRewardedVideoCompleted()
ไม่เริ่มทำงานในโปรแกรมจำลอง
16.0.0
02-10-2018
ไม่มีการเปลี่ยนแปลงโฆษณา ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่น ของบริการ Google Play
15.0.0
12‐04-2018
MRAID v3 รุ่นเบต้า
โฆษณาเนทีฟ: เพิ่ม Unified Native Ad API ซึ่งจะรวม NativeAppInstallAds
และ NativeContentAds
เข้ากับประเภทใหม่ 1 ประเภทคือ UnifiedNativeAd
หมายเหตุ: เมื่อใช้โฆษณาเนทีฟ จะมีคำเตือนที่ไม่เป็นอันตรายแสดงขึ้นในบันทึกเมื่อมีการคลิกโฆษณาเนทีฟดังนี้
"UnconfirmedClickListener ต้องไม่เป็น null ขณะที่ตั้งค่า ClickConfirmingView ไว้ " คุณสามารถไม่สนใจคำเตือนนี้ได้และระบบจะนำคำเตือนออกในรุ่นถัดไป
12.0.1
28‐03‐2018
ไม่มีการเปลี่ยนแปลงโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่บันทึกประจำรุ่น ของบริการ Google Play
12.0.0
20-03‐2018
วิดีโอที่มีการให้รางวัล: เพิ่มวิธีการติดต่อกลับ onRewardedVideoCompleted()
ใน RewardedVideoAdListener
แอปจะต้องลบล้างการเรียกกลับนี้ในการใช้งาน RewardedVideoAdListener
เพื่อหลีกเลี่ยงข้อผิดพลาดในการคอมไพล์เมื่ออัปเดตเป็นเวอร์ชัน 12.0.0
สื่อกลางเนทีฟ: เพิ่มเมธอด trackViews()
ลงใน NativeAdMapper
ซึ่งทำให้อะแดปเตอร์เข้าถึงออบเจ็กต์ View
ที่เกี่ยวข้องกับชิ้นงานโฆษณาเนทีฟแต่ละรายการได้
เลิกใช้งาน trackView()
เพื่อใช้ trackViews()
แทน
11.8.0
18-12-2017
แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
11.6.0
07‐11-2017
เพิ่มคลาส NativeAdViewHolder
และวิธีการที่เกี่ยวข้องใน NativeAppInstallAd
และ NativeContentAd
แล้ว
เลิกใช้งาน AdLoader.getMediationAdapterClassName
แล้ว (ผู้เผยแพร่โฆษณาควรใช้เมธอดชื่อเดียวกันใน NativeAppInstallAd
และ NativeContentAd
แทน)
ตอนนี้โฆษณาทดสอบจะแสดงป้ายกำกับที่ด้านบนของโฆษณา ดูรายละเอียดเพิ่มเติมในคู่มือการทดสอบ
11.4.0
19-09-2017
เพิ่มเมธอด getMediationAdapterClassName()
ลงในคลาส NativeAppInstallAd
และ NativeContentAd
แล้ว ระบบจะเลิกใช้งานเมธอดชื่อเดียวกันใน AdLoader
เพิ่มเมธอด onVideoEnd()
ลงในเมธอด MediationNativeListener
คลาส, hasVideoContent()
, setHasVideoContent()
และ
setMediaView()
ในคลาส NativeAdMapper
และ getAdVolume()
และ isAdMuted()
ลงในคลาส NativeMediationAdRequest
เพื่อรองรับสื่อกลางวิดีโอแบบเนทีฟ
นำชั้นเรียน SearchAdRequest
ออกแล้ว
11.2.2
05‐09-2017
เพิ่มเมธอด loadAd()
ใหม่ที่จะนำออบเจ็กต์ PublisherAdRequest
ไปยังคลาส RewardedVideoAd
11.2.0
14‐08-2017
เพิ่มเมธอด loadAds()
ลงในคลาส AdLoader
ซึ่งทำให้แอปโหลดโฆษณาที่ไม่ซ้ำกันหลายรายการในคำขอเดียวได้
เมื่อคุณอัปเกรดแอปไปใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.2.0 ขึ้นไป คุณต้องอัปเดต build.gradle
ของแอปเพื่อระบุ compileSdkVersion
เป็นอย่างน้อย 26
(Android O) ด้วย ซึ่งจะไม่เปลี่ยนแปลงวิธีการทำงานของแอป คุณไม่จำเป็นต้องอัปเดต targetSdkVersion
เริ่มตั้งแต่เวอร์ชัน 11.2.0 เป็นต้นไป SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะพร้อมใช้งานผ่านที่เก็บ Maven ของ Google ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่น ของบริการ Google Play
11.0.0
07‐06-2017
เพิ่มเมธอด onAdClicked()
และ
onAdImpression()
ลงในคลาส AdListener
ระบบจะใช้วิธีการเหล่านี้กับโฆษณาเนทีฟเพื่อการติดตั้งแอปและโฆษณาเนทีฟแบบคอนเทนต์เท่านั้น
นำเมธอด getInAppPurchaseListener()
และ setInAppPurchaseListener()
ออกจากชั้นเรียน AdView
, InterstitialAd
และ NativeExpressAdView
และนำคลาสการซื้อในแอปที่เกี่ยวข้องออกด้วย
เพิ่มเมธอด OnVideoMute()
,
OnVideoPause()
,
OnVideoPlay()
และ OnVideoStart()
ลงในคลาส
VideoController.VideoLifecycleCallbacks
เพิ่มความสามารถในการเปิดใช้โหมดสมจริงในโฆษณาแบบเต็มหน้าจอด้วยการเพิ่มเมธอด setImmersiveMode()
ลงในชั้นเรียน PublisherInterstitialAd
และ RewardedVideoAd
เพิ่มอินเทอร์เฟซ OnPublisherAdViewLoadedListener
, คลาส PublisherAdViewOptions
และคลาส PublisherAdViewOptions.Builder
สำหรับใช้กับ AdLoader
สำหรับคำขอโฆษณาเนทีฟบวกแบนเนอร์
เพิ่มอินเทอร์เฟซ OnImmersiveModeUpdatedListener
ที่ไม่บังคับซึ่งอะแดปเตอร์สื่อกลางสามารถนำไปใช้เพื่อรับทราบข้อมูลการอัปเดตโหมดสมจริง
เพิ่มเมธอด getMediationAdapterClassName()
ลงในคลาส RewardedVideoAd
แล้ว
เพิ่มกฎ keep
เพื่อเก็บรักษาชื่อคลาสอะแดปเตอร์สื่อกลางไว้โดยอัตโนมัติเมื่อใช้ ProGuard
10.2.0
15-2017
บริการ Google Play 10.2.x เป็นรุ่นแรกที่ไม่มีการสนับสนุนอย่างเต็มรูปแบบสำหรับ Android เวอร์ชัน 2.3.x (Gingerbread) อีกต่อไป
แอปที่พัฒนาโดยใช้ SDK รุ่น 10.2.x ขึ้นไปต้องมีระดับ API ของ Android ขั้นต่ำที่ 14 และไม่สามารถติดตั้งในอุปกรณ์ที่ใช้ API ระดับต่ำกว่า 14 หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกต่างๆ รวมถึงการสร้าง APK หลายรายการเพื่อขยายการรองรับแอปสำหรับ Android Gingerbread โปรดดู
บล็อกของนักพัฒนาแอป Android
เพิ่มการรองรับชิ้นงานวิดีโอสำหรับเนื้อหาเนทีฟขั้นสูงและโฆษณาเทมเพลตที่กำหนดเอง
เพิ่มเมธอด getVideoController()
, setVideoOptions()
และ getVideoOptions()
ลงในคลาส PublisherAdView
แล้ว
เพิ่มชั้นเรียน AdChoicesView
แล้ว
เพิ่มเมธอด getAdChoicesContent()
และ setAdChoicesContent()
ลงในคลาส NativeAdMapper
แล้ว
เพิ่มอินเทอร์เฟซ InitializableMediationRewardedVideoAdAdapter
สำหรับอะแดปเตอร์สื่อกลางวิดีโอที่มีการให้รางวัลที่ต้องการเลือกใช้การเริ่มต้นล่วงหน้าก่อนที่จะมีการส่งคำขอโฆษณา
เพิ่มการรองรับการแสดงตัวอย่างในแอปและการแก้ปัญหาใน Google Ad Manager
10.0.1
2016-11‐21
แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
9.8.0
20-10-2016
เลิกใช้งาน
MobileAds.Initialize(Context)
แล้ว
ผู้เผยแพร่โฆษณา Google Ad Manager ควรเรียกใช้เมธอดนี้เมื่อเริ่มต้น
แอปของตน ผู้เผยแพร่โฆษณา AdMob ควรใช้ MobileAds.Initialize(Context, String)
และส่งรหัสการสมัครต่อไป
9.6.0
2016‐09
เพิ่มคลาส
MediaView
สำหรับโฆษณาวิดีโอเนทีฟขั้นสูงแล้ว
เพิ่มเมธอด
openDebugMenu()
ลงในคลาส
MobileAds
สำหรับการแสดงตัวอย่างครีเอทีฟโฆษณาและการแก้ปัญหาของหน่วยโฆษณา Ad Manager
เพิ่มการรองรับกิจกรรมที่กำหนดเองของวิดีโอที่มีการให้รางวัล
9.4.0
01-08-2016
แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
9.2.0
27‐06-2016
9.0.1
26‐05-2016
แก้ปัญหา ProGuard ที่เปิดตัวใน 9.0.0
ผู้เผยแพร่โฆษณาไม่จําเป็นต้องใช้ตัวเลือก keep
สําหรับ com.google.android.gms.common.util.DynamiteApi
อีกต่อไป
9.0.0
18‐05-2016
8.4.0
18-12-2015
เพิ่มวิธีการสาธารณะ MobileAds.setAppVolume()
เพื่อแจ้ง SDK โฆษณาในอุปกรณ์เคลื่อนที่เกี่ยวกับระดับเสียงในปัจจุบันของแอป
แก้ไขข้อบกพร่องและปรับปรุงด้านต่างๆ แล้ว
8.3.0
6-11-2015
เพิ่มการรองรับโฆษณาวิดีโอที่มีการให้รางวัล
เพิ่มเมธอด isLoading()
ใน PublisherAdView
และ PublisherInterstitialAd
เพื่อตรวจสอบว่าคําขอโฆษณาอยู่ระหว่างดำเนินการหรือไม่
เพิ่มเมธอด setIsDesignedForFamilies()
ลงใน AdRequest.Builder
และ PublisherAdRequest.Builder
แล้ว
เพิ่มเมธอด destroy()
ลงใน NativeAdView
แล้ว
8.1.0
24‐09-2015
แก้ไขข้อบกพร่องหลายรายการ
7.8.0
13‐08-2015
MRAID v2 เวอร์ชันเปิดตัวอย่างเป็นทางการ
เพิ่มเมธอด isLoading()
ลงใน AdLoader
, AdView
และ InterstitialAd
เพื่อตรวจสอบว่าคําขอโฆษณาอยู่ระหว่างดำเนินการหรือไม่
เลิกใช้งาน PublisherAdRequest.Builder#setManualImpressionsEnabled()
โปรดใช้ PublisherAdView#setManualImpressionsEnabled()
แทน
7.5.0
28‐05-2015
เพิ่มการรองรับรูปแบบโฆษณาเนทีฟเพื่อการติดตั้งแอปและเนื้อหาใน AdMob และ Ad Manager
เพิ่มการรองรับรูปแบบโฆษณาเนทีฟที่กำหนดเอง ซึ่งพร้อมใช้งานในการจองใน Ad Manager
7.3.0
28‐04‐2015
แก้ไขข้อบกพร่องหลายรายการ
7.0.0
19-03-2015
เพิ่มเมธอด addCustomTargeting()
และ addCategoryExclusion()
ลงใน PublisherAdRequest.Builder
แล้ว
แก้ไขปัญหาที่ทำให้ PublisherAdView.recordManualImpression()
บันทึกการแสดงผลหลายครั้งใน Ad Manager เมื่อใช้การนับการแสดงผลด้วยตนเอง
แก้ไขปัญหาที่ทําให้โฆษณาแสดงผลไม่ถูกต้องเมื่อใช้แอตทริบิวต์ android:largestWidthLimitDp
ในแท็ก <supports-screens>
เพิ่มเมธอด setRequestAgent()
ใน AdRequest.Builder
และ PublisherAdRequest.Builder
แล้ว
ควรใช้วิธีการนี้เพื่อแสดงที่มาของคำขอโฆษณาโดยบุคคลที่สามที่เป็นสื่อกลางไปยัง SDK โฆษณาในอุปกรณ์เคลื่อนที่
6.5.87
08-12-2014
เปิดตัวสถาปัตยกรรม JAR แบบแยก--ตอนนี้นักพัฒนาแอป Android Studio สามารถ
รวมเฉพาะส่วนโฆษณาของบริการ Google Play ได้ โดยขึ้นอยู่กับ
com.google.android.gms:play‑services‑ads :6.+
หมายเหตุ: แอปที่สร้างโฆษณาแบนเนอร์ใน XML ยังคงต้องอ้างอิงถึงไลบรารีทั้งหมด com.google.android.gms:play‑services :6.+
แก้ไขข้อบกพร่องหลายรายการ
6.1
08‐10-2014
เพิ่มเมธอด getLocation()
ลงใน com.google.android.gms.ads.MediationAdRequest
แล้ว
เพิ่มคำอธิบายเนื้อหาลงในปุ่มปิดโฆษณาคั่นระหว่างหน้าเพื่อการเข้าถึง
นำการบันทึก "ไม่พบทรัพยากร Google Play" ออกเมื่อลิงก์โปรเจ็กต์ไลบรารีถูกต้องแล้ว
เพิ่ม getMediationAdapterClassName()
ลงใน AdView
เพื่อดูชื่อคลาสของอะแดปเตอร์สื่อกลางเครือข่ายโฆษณาที่กำลังแสดงโฆษณาอยู่
5.0
25‐06‐2014
เพิ่ม API ใหม่เพื่อใช้เหตุการณ์ที่กำหนดเอง
เพิ่มขั้นตอนการซื้อเริ่มต้นสำหรับการซื้อในแอปโดยใช้ Google Play Billing API
4.4
07‐05-2014
เพิ่ม API ของอะแดปเตอร์สื่อกลางใหม่แล้ว
เพิ่มโฆษณา LARGE_BANNER
รูปแบบ 320x100 ใหม่สำหรับทั้งโทรศัพท์และแท็บเล็ต
เพิ่มรูปแบบโฆษณาคั่นระหว่างหน้าใหม่สำหรับการซื้อในแอป ตั้งค่า InAppPurchaseListener
ใน InterstitialAd
เพื่อฟังเหตุการณ์การซื้อในแอป
แก้ไขข้อบกพร่องของข้อขัดข้อง SecurityException
เนื่องจากอ่านบริการโดยไม่ได้รับอนุญาต
4.3
17‐03-2014
InterstitialAd
จะทำงานได้แล้วหากผ่านบริบทแอปพลิเคชัน
เพิ่มเมธอด setContentUrl()
ลงใน PublisherAdRequest.Builder
แล้ว
แก้ไขหาข้อยกเว้นเมื่อไม่ได้ลงทะเบียนบริการ
4.2
03‐02-2014
แก้ไขข้อบกพร่องหลายรายการ
4.1
16-01-2014
เพิ่มการรองรับ Ad Manager และโฆษณา Search สำหรับแอปบนอุปกรณ์เคลื่อนที่
ตอนนี้ AdRequest.Builder
มีเมธอด setLocation()
แล้ว
แก้ไขข้อขัดข้องที่เกิดขึ้นหากมีการขอโฆษณาคั่นระหว่างหน้า แต่ไม่ได้ระบุ AdActivity
ในไฟล์ Manifest
4.0
31-10-2013
ขณะนี้ Google Mobile Ads API เป็นส่วนหนึ่งของบริการ Google Play แล้ว
การอัปเดตในอนาคตสำหรับ Google Mobile Ads API จะได้รับการพุชไปยังอุปกรณ์โดยอัตโนมัติผ่านบริการ Google Play
ยังไม่รองรับ Ad Manager และ Search Ads สำหรับแอปบนอุปกรณ์เคลื่อนที่