เวอร์ชัน
วันที่เผยแพร่
หมายเหตุ
23.4.0
30‑09‑2024
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()
เพื่อปรับปรุงการสร้างรายได้สำหรับโฆษณาในแท็บที่กำหนดเอง ดูข้อมูลเพิ่มเติมที่เพิ่มประสิทธิภาพแท็บที่กำหนดเอง
อัปเดตทรัพยากร Dependency ของ User Messaging Platform SDK เป็นเวอร์ชัน 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
รุ่นนี้เป็นการอัปเดตเวอร์ชัน 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
ออกจาก
การอ้างอิง 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
21.1.0
14‑07‑2022
เพิ่มการรองรับการสร้างรายได้จากโฆษณาภายใน WebView
ดูรายละเอียดเพิ่มเติมได้ที่ผสานรวม WebView API สําหรับโฆษณา
เพิ่ม getResponseExtras()
ลงใน
ResponseInfo
ซึ่งอาจแสดงข้อมูลเพิ่มเติมเกี่ยวกับการตอบสนองของโฆษณา
เบต้า: getResponseExtras()
API อยู่ในรุ่นเบต้า ค่าการแสดงผลอาจเปลี่ยนแปลงหากไม่มีรุ่น SDK
21.0.0
25‑05‑2022
รุ่นนี้เป็นการอัปเดตเวอร์ชัน MAJOR ที่มี
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้จากคู่มือย้ายข้อมูลไปยัง SDK v21
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
ตอนนี้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google กําหนดให้แอปทั้งหมดต้องใช้ 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
22‑02‑2022
20.5.0
18-11-2021
เพิ่มการรองรับอุปกรณ์ Android 12 สําหรับแอปที่กําหนดเป้าหมายเป็น API 31
เพิ่มการรองรับรหัสชุดแอป
สำหรับ Use Case เช่น การรายงานและการป้องกันการประพฤติมิชอบ
20.4.0
22‑09‑2021
รุ่นนี้และเวอร์ชันก่อนหน้าทั้งหมดต้องใช้ทรัพยากร 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 เป็นต้นไป Google Mobile Ads SDK จะรวมสิทธิ์ 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 แล้ว
SDK สำหรับ User Messaging Platform
เพิ่มการเรียกกลับ 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
2020‑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()
ที่ไม่ใช่ Null ซึ่งแสดงข้อผิดพลาดในการสื่อกลางพื้นฐาน
19.2.0
18‐06-2020
โฆษณาเนทีฟ: เพิ่ม 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()
เพื่อเปิดใช้การตั้งค่า
ทดสอบอุปกรณ์ครั้งเดียวสำหรับคำขอโฆษณาทั้งหมด
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 เวอร์ชันนี้กำหนดให้ผู้เผยแพร่แอปประกาศข้อกำหนดเพิ่มเติมใน build.gradle ดังนี้
com.google.android.gms:play-services-measurement:17.0.0
com.google.android.gms:play-services-measurement-sdk:17.0.0
หมายเหตุ: เวอร์ชันนี้เป็นอัปเดตเวอร์ชันสำคัญและการเปลี่ยนแปลงที่ส่งผลเสีย
17.2.1
2019‑05‑21
แก้ไข ANR ที่เกิดขึ้นที่
android.media.AudioManager.getStreamVolume
17.2.0
2019‑03‑11
วิดีโอที่มีการให้รางวัล: เพิ่มชุด Rewarded API ชุดใหม่ (ดูแพ็กเกจ rewarded ) ที่ช่วยให้คุณโหลดโฆษณาที่มีการให้รางวัลหลายรายการพร้อมกันได้
สื่อกลาง: เพิ่ม 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 ต้องไม่มีค่าเป็น Null ขณะที่ตั้งค่า ClickConfirmingView"
โฆษณาที่มีการให้รางวัล: เพิ่มเมธอด setAdMetadataListener
ใน
RewardedVideoAd
เพื่อรอฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณา
โฆษณาที่มีการให้รางวัล: การเรียกใช้ destroy()
จะลบล้าง Listener
เลิกใช้งานเมธอดต่อไปนี้ใน AdRequest.Builder
แก้ไขข้อบกพร่องที่ onRewardedVideoCompleted()
ไม่เริ่มทำงานเมื่อ
โปรแกรมจำลอง
16.0.0
2018‑10‑02
ไม่มีการเปลี่ยนแปลงโฆษณา โปรดดูบริการ 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 ลงใน 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
2017‑2‑15
บริการ 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
21‑11‑2016
การแก้ไขข้อบกพร่องและการปรับปรุงทั่วไป
9.8.0
24‑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
2016‑05‑18
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 สําหรับแอปบนอุปกรณ์เคลื่อนที่