เวอร์ชัน
วันที่เผยแพร่
หมายเหตุ
23.3.0
12-08-2024
อัปเดตการใช้ SDK ของแพลตฟอร์มการรับส่งข้อความกับผู้ใช้เป็นเวอร์ชัน 3.0.0
23.2.0
27‐06‐2024
23.1.0
09‐05-2024
ต้องมีอย่างน้อย compileSdkVersion
จาก 34
อะแดปเตอร์สื่อกลางเนทีฟ : เลิกใช้งานแล้ว loadNativeAd
และ loadRtbNativeAd()
เพื่อรับ loadNativeAdMapper()
และ loadRtbNativeAdMapper()
อะแดปเตอร์ควรเปลี่ยนไปใช้วิธีการโหลดแบบใหม่เหล่านี้และ
ออบเจ็กต์
23.0.0
07-03-2024
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ:
เพิ่มระดับ API ขั้นต่ำของ Android เป็น 21
หากต้องการรวบรวมเมตริกผู้ใช้ใน AdMob ต่อไป
ลิงก์แอป AdMob กับ Firebase และผสานรวม Google Analytics สำหรับ
Firebase SDK ลงในแอป
นำ 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 เวอร์ชันเบต้าเป็นครั้งแรก
ดูข้อมูลเพิ่มเติมได้ที่คู่มือ Ad Manager 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
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ:
เพิ่ม 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
ออกจาก
การอ้างอิง 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 สำหรับการส่งออกบันทึกคำขอโฆษณาผ่าน
Sharesheet ของ Android
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 กำหนดให้แอปทั้งหมดต้องมีการใช้งานขั้นต่ำ
API ของ Android ระดับ 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
รุ่นนี้และเวอร์ชันก่อนหน้าทั้งหมดต้องใช้ทรัพยากร Dependency อย่างชัดเจน
ใน 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 ที่ผสานเข้ากับไฟล์ Manifest ของแอปโดยอัตโนมัติด้วย
เครื่องมือสร้างของ Android ดูข้อมูลเพิ่มเติมเกี่ยวกับAD_ID
การประกาศสิทธิ์ รวมถึงวิธีปิดใช้งาน โปรดดูที่
บทความช่วยเหลือนี้ของ Play Console
เพิ่ม
วันที่ onAdClicked()
โทรกลับไปยัง FullScreenContentCallback
เปิดใช้
วันที่ onAdClicked()
Callback ในคลาส 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 แล้ว
SDK สำหรับ User Messaging Platform
เพิ่ม 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
19.4.0
10‐09-2020
เพิ่มการรองรับอุปกรณ์ Android 11 สำหรับแอปที่กำหนดเป้าหมายเป็น API 30
โฆษณาเปิดแอป: เปลี่ยนรูปแบบ AppOpenAd
เพื่อให้ทำงานได้มากขึ้น
อย่างเช่นรูปแบบเต็มหน้าจอ
มากกว่ามุมมองแบนเนอร์ เพิ่มเมื่อ
getResponseInfo()
และ show()
วิธีเพื่อ
AppOpenAd
เลิกใช้งาน AppOpenAdView
และ AppOpenAdPresentationCallback
ชั้นเรียน
สื่อกลาง: การรายงานสถานะสื่อกลางพร้อมใช้งานแล้ว ใช้
ResponseInfo.getAdapterResponses()
เพื่อรับข้อมูลการตอบกลับของแต่ละเครือข่ายโฆษณาที่เข้าร่วมในโฆษณา
อีกครั้ง
โฆษณาที่มีการให้รางวัลแบบเดิม: เลิกใช้งาน RewardedVideoAd
เพิ่มรูปแบบ RewardedInterstitialAd
แล้ว ขณะนี้อยู่ใน
รุ่นเบต้าแบบจำกัดผู้ใช้งาน
แก้ไขข้อบกพร่องที่ 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
โฆษณาเนทีฟ: เพิ่ม UI ของเครื่องมือตรวจสอบโฆษณาเนทีฟในการทดสอบ
คำขอเพื่อช่วยคุณตรวจจับและแก้ไขการละเมิดนโยบายเนทีฟ
เพิ่ม MobileAds.disableMediationAdapterInitialization()
เรียกใช้เมธอดนี้ก่อนที่จะเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อ
ปิดใช้การเริ่มต้นอะแดปเตอร์สื่อกลาง
คำเตือน: การเรียกใช้วิธีการนี้อาจส่งผลเสียต่อ
ส่งผลต่อประสิทธิภาพสื่อกลาง 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
มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบดังต่อไปนี้
อัปเดตเวอร์ชัน Android SDK ขั้นต่ำเป็น API 16 เพื่อให้สอดคล้องกับ
นโยบายการเผยแพร่บริการ Google Play
โฆษณาเนทีฟ: ย้าย MediaContent
ไปยัง
แพ็กเกจ com.google.android.gms.ads
เพิ่มการรองรับการอ่านพารามิเตอร์ความยินยอมจาก
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()
เพื่อเปิดใช้การตั้งค่า
ทดสอบอุปกรณ์ครั้งเดียวสำหรับคำขอโฆษณาทั้งหมด
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
การย้ายข้อมูลจากไลบรารีการสนับสนุนของ Android ไปยัง Jetpack (AndroidX)
ไลบรารี โปรดดู
บันทึกประจำรุ่นของบริการ Google Play สำหรับข้อมูลเพิ่มเติม
เพื่อหลีกเลี่ยงข้อขัดข้องที่เกิดขึ้นเมื่อเปิดใช้งานครั้งแรกหลังจากติดตั้งแอปจาก
Play Store รุ่นนี้กำหนดให้ผู้เผยแพร่โฆษณาต้องประกาศ
ทรัพยากร Dependency ใน "build.gradle"
com.google.android.gms:play-services-measurement:17.0.0
com.google.android.gms:play-services-measurement-sdk:17.0.0
หมายเหตุ: รุ่นนี้เป็นการอัปเดตเวอร์ชัน 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
ผู้เผยแพร่โฆษณา Ad Manager ของ Google จะต้องระบุ
แท็ก <meta-data>
ที่มีคีย์
com.google.android.gms.ads.AD_MANAGER_APP
ใน AndroidManifest.xml ของตนเอง โปรดดู
รับ
คู่มือเริ่มต้นใช้งาน สำหรับรายละเอียดเพิ่มเติม
โฆษณาเนทีฟ: NativeAppInstallAd
, NativeContentAd
,
และ API ที่เชื่อมโยงเลิกใช้งานแล้วเพื่อกำหนดให้UnifiedNativeAd
ดูโฆษณาเนทีฟ
แบบรวมขั้นสูง สำหรับวิธีการเพิ่มเติมในการใช้ API ใหม่
โฆษณาเนทีฟ: เพิ่มปุ่ม "ซ่อนโฆษณานี้"
โฆษณาเนทีฟ: บันทึกคำเตือนที่ไม่เป็นอันตราย: "UnconfirmedClickListener ต้อง
เว้นว่างไม่ได้หากมีการตั้งค่า ClickConfirmingView ไว้" นำออกแล้ว
โฆษณาที่มีการให้รางวัล: เพิ่มเมธอด setAdMetadataListener
ใน
RewardedVideoAd
เพื่อรอฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณา
โฆษณาที่มีการให้รางวัล: การเรียกใช้ destroy()
จะทำให้
Listener
เลิกใช้งานเมธอดต่อไปนี้ใน 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
รวมอยู่ในรายการเดียว
ประเภท: UnifiedNativeAd
หมายเหตุ: เมื่อใช้โฆษณาเนทีฟ จะมีคำเตือนที่ไม่เป็นอันตรายว่า
จะแสดงในบันทึกเมื่อมีการคลิกโฆษณาเนทีฟ
"UnconfirmedClickListener ต้องไม่เป็นค่าว่างในขณะที่ ClickConfirmingView มีค่าเป็น
ได้ " คุณสามารถไม่สนใจคำเตือนนี้ และคำเตือนจะถูกนำออกในอีก
12.0.1
28‐03‐2018
ไม่มีการเปลี่ยนแปลงโฆษณา ดูบันทึกประจำรุ่น ของบริการ Google Play
เพื่อดูรายละเอียดเพิ่มเติม
12.0.0
20-03‐2018
วิดีโอที่มีการให้รางวัล: เพิ่ม onRewardedVideoCompleted()
Callback Method ไปยัง RewardedVideoAdListener
เพื่อหลีกเลี่ยงข้อผิดพลาดในการคอมไพล์เมื่ออัปเดตเป็นเวอร์ชัน 12.0.0 แอปจะต้อง
เพื่อลบล้างการเรียกกลับนี้ใน
การใช้งาน RewardedVideoAdListener
สื่อกลางเนทีฟ: เพิ่ม 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
แล้ว
ซึ่งทำให้แอปโหลดโฆษณาที่ไม่ซ้ำหลายรายการได้ในคำขอเดียว
เมื่อคุณอัปเกรดแอปเป็นเวอร์ชัน 11.2.0 ขึ้นไปของ Google Mobile
SDK ของโฆษณา 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 Ads
ผู้จัดการ
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 ใหม่สำหรับโทรศัพท์ทั้ง 2 เครื่อง
และแท็บเล็ต
เพิ่มรูปแบบโฆษณาคั่นระหว่างหน้าใหม่สำหรับการซื้อในแอป ตั้งค่า
InAppPurchaseListener
บน InterstitialAd
เพื่อฟัง
สำหรับเหตุการณ์การซื้อในแอป
แก้ไขข้อบกพร่องสำหรับข้อขัดข้อง SecurityException
รายการเนื่องจากการอ่าน
gservices โดยไม่ได้รับอนุญาต
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 สำหรับแอปบนอุปกรณ์เคลื่อนที่