privacysandbox ads

  
ไลบรารีนี้ช่วยให้ผสานรวมกับ Privacy Preserving API ซึ่งเป็นส่วนหนึ่งของ Privacy Sandbox ใน Android ได้
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า เวอร์ชันอัลฟ่า
12 มีนาคม 2025 - - 1.1.0-beta12 -

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มการพึ่งพา privacysandbox-ads คุณต้องเพิ่มที่เก็บ Google Maven ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมในที่เก็บ Maven ของ Google

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล

ดึงดูด

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

Kotlin

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพิงบิวด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ได้ โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงคลังนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของเครื่องมือติดตามปัญหา

เวอร์ชัน 1.1

เวอร์ชัน 1.1.0-beta12

12 มีนาคม 2025

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta12 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ลําดับความสําคัญของกลุ่มเป้าหมายที่กําหนดเอง: เราได้เพิ่มช่องลําดับความสําคัญในกลุ่มเป้าหมายที่กําหนดเอง ซึ่งช่วยให้ผู้ซื้อระบุค่าลําดับความสําคัญใน CustomAudience ได้ ระบบจะใช้ค่านี้เพื่อระบุกลุ่มเป้าหมายที่กำหนดเองซึ่งควรรวมอยู่ในการประมูลหากชุดกลุ่มเป้าหมายที่กำหนดเองของผู้ซื้อมีขนาดใหญ่เกินขีดจํากัดต่อผู้ซื้อ
  • การกําหนดค่าผู้ขาย: ฟีเจอร์นี้ช่วยให้ผู้ขายกําหนดพารามิเตอร์การประมูลเพื่อควบคุมขนาดเพย์โหลดและผู้เข้าร่วมการประมูลได้ การกําหนดค่าการประมูลของผู้ขายจะช่วยให้ผู้ขายระบุสิ่งต่อไปนี้ได้
    • รายชื่อผู้ซื้อที่อนุญาต
    • สำหรับการประมูลที่ผู้ขายรายหนึ่งเริ่มขึ้น จะมีเพียงผู้ซื้อในรายการที่อนุญาตเท่านั้นที่จะสามารถเสนอCustomAudiencesสำหรับการประมูล
    • ขีดจำกัดขนาดต่อผู้ซื้อ
    • ผู้ขายสามารถระบุขีดจํากัดต่อผู้ซื้อเพื่อควบคุมขนาดข้อมูลที่ผู้ซื้อแต่ละรายอัปโหลดลงในเพย์โหลดที่ส่งไปยัง SellerFrontendService หากผู้ซื้อมีขนาดใหญ่เกินขีดจํากัดต่อผู้ซื้อ ระบบจะใช้ลําดับความสําคัญ CustomAudience ที่ตั้งไว้ในการกำหนดค่าเพย์โหลดของผู้ซื้อเพื่อรับข้อมูลในขีดจํากัดที่คาดไว้
    • ขีดจํากัดขนาดสูงสุดของเพย์โหลด
    • ผู้ขายแต่ละรายอาจมีการจัดสรรทรัพยากรแตกต่างกันไป และอาจต้องการกำหนดขีดจำกัดขนาดสูงสุดสำหรับเพย์โหลดการประมูลต่อคำขอ ขีดจำกัดขนาดสูงสุดจะเป็นไปตามที่เก็บข้อมูลขนาดคงที่ซึ่ง ProtectedAudience API กำหนดไว้
  • การอัปเดตกลุ่มเป้าหมายที่กำหนดเองแบบเลื่อนเวลา: ฟีเจอร์นี้ช่วยให้ผู้ซื้อกําหนดเวลาการอัปเดตที่เลื่อนเวลาไว้สําหรับกลุ่มเป้าหมายที่กําหนดเองได้ คำขออัปเดตแต่ละรายการช่วยให้ผู้เรียกใช้กำหนดเวลาการอัปเดตแบบเลื่อนเวลาได้โดยใช้ scheduleCustomAudienceUpdate() API ใหม่ ผู้ใช้สามารถระบุชุดกลุ่มเป้าหมายที่กำหนดเองที่จะเข้าร่วมหรือออกจากการอัปเดตแต่ละรายการได้

การเปลี่ยนแปลง API

  • เพิ่มการกำหนดค่าผู้ขายใน GetAdSelectionRequest API (Ibb5c7)
  • เปิดตัว ScheduleCustomAudienceUpdate API เป็นเวอร์ชันทดลอง (I6b905)

เวอร์ชัน 1.1.0-beta11

30 ตุลาคม 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta11 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • การอัปเดตนี้จะนําการรองรับการวัดผลใน Privacy Sandbox และ adid API ใน Android R ออก เนื่องจากเลิกใช้งานแล้ว ตอนนี้การเรียกใช้เพื่อรับคลาสตัวจัดการใน Android R จะแสดงผลเป็น Null

เวอร์ชัน 1.1.0-beta10

21 สิงหาคม 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta10 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มตัวสร้าง Java ที่โอเวอร์โหลดซึ่งขาดหายไปสําหรับ GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest และ FetchAndJoinCustomAudienceRequest Experimental API (I19e7f)

เวอร์ชัน 1.1.0-beta09

10 กรกฎาคม 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta09 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มตัวสร้าง Java ที่ขาดหายไปสำหรับ GetAdSelectionDataRequest Experimental API (Ifbf88)

เวอร์ชัน 1.1.0-beta08

26 มิถุนายน 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta08 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการรองรับสัญญาณแอปที่ได้รับการปกป้อง
  • รองรับผู้ให้บริการระบบคลาวด์หลายรายสำหรับการประมูลเซิร์ฟเวอร์ B&A

การเปลี่ยนแปลง API

  • API ทดลอง GetAdSelectionDataRequest::seller ต้องระบุค่า (I68044)
  • เพิ่ม GetAdSelectionDataRequest::coordinatorOriginUri API การทดสอบ (I18c0b)
  • เพิ่ม updateSignals API แล้ว (Ia8512)

เวอร์ชัน 1.1.0-beta07

14 พฤษภาคม 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta07 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ขณะนี้ GetTopics รองรับการตอบกลับที่เข้ารหัสโดยเป็นส่วนหนึ่งของ GetTopicsResponse

การเปลี่ยนแปลง API

  • เพิ่ม EncryptedTopic ไปยังชั้นเรียน GetTopicResponse แล้ว (Iab362)

เวอร์ชัน 1.1.0-beta06

17 เมษายน 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta06 มีการคอมมิตเหล่านี้

หมายเหตุ

  • ตั้งแต่ jetpack ของ privacysandbox-ads เวอร์ชัน 1.1.0-beta06 อุปกรณ์ Android R ที่เปิดใช้ Flag ทั้งหมดจะสามารถเข้าถึง PPAPI ได้ สําหรับกรณีการใช้งานที่ไม่ควรรองรับ Android R คุณจะต้องใส่เงื่อนไขเพิ่มเติมภายในโค้ดโดยใช้โค้ด jetpack ของ privacysandbox-ads

ฟีเจอร์ใหม่

  • รองรับความเข้ากันได้แบบย้อนหลังสำหรับ Android R

เวอร์ชัน 1.1.0-beta05

3 เมษายน 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta05 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • เพิ่มการตรวจจับข้อผิดพลาดเมื่อไม่พบคําจํากัดความของคลาสในอุปกรณ์ Android S เนื่องจากไม่มีแท็ก uses-library ในไฟล์ Manifest

เวอร์ชัน 1.1.0-beta04

24 มกราคม 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta04 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • API ใหม่ที่รองรับการรายงานเหตุการณ์ของผู้ใช้หลังการประมูล
  • รองรับการกรองความถี่สูงสุดสําหรับโฆษณารีมาร์เก็ตติ้งแล้ว
  • การรองรับการมอบสิทธิ์เข้าร่วมกลุ่มเป้าหมายที่กำหนดเอง
  • การรองรับการตัดเชนสื่อกลาง Waterfall
  • การรองรับการประมูลที่ได้รับการคุ้มครองในเซิร์ฟเวอร์การเสนอราคาและการประมูล

การเปลี่ยนแปลง API

  • เปิดตัว AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) API เวอร์ชันทดลอง (I86cd2)
  • เปิดตัว ReportEventRequest::inputEvent API เวอร์ชันทดลอง (Ib94f3)
  • ทําให้ ReportImpressionRequest::adSelectionConfig ไม่บังคับ (Ief280)
  • เปิดตัว API ทดลอง AdSelectionManager::getAdSelectionData และ AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • เปิดตัว CustomAudienceManager::fetchAndJoinCustomAudience API เวอร์ชันทดลอง (I09152)
  • เปิดตัว AdSelectionManager::reportEvent API เวอร์ชันทดลอง (I0d7dc)
  • เปิดตัว AdSelectionManager::updateAdCounterHistogram API เวอร์ชันทดลองและแก้ไข AdData เพื่อระบุชุด AdFilters (I87b83)

การแก้ไขข้อบกพร่อง

  • ตอนนี้ระบบจะจับคู่ URI อินพุตในเว็บไซต์/ต้นทางที่แชร์แทนที่จะต้องจับคู่ชื่อโฮสต์ที่ตรงกันทุกประการ
  • แก้ไขการทดสอบที่ไม่สําเร็จเนื่องจากไม่มีรูปแบบ HTTPS (d573058)
  • แก้ไขรูปแบบ HTTPS ที่ขาดหายไปจาก URL ของเว็บ (cecdcb8)
  • เพิ่มคำอธิบายประกอบ throws ลงใน Measurement API (2dba359)

เวอร์ชัน 1.1.0-beta03

15 พฤศจิกายน 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta03 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • รองรับการทำงานร่วมกับเวอร์ชันเก่าสำหรับ Android S

เวอร์ชัน 1.1.0-beta02

4 ตุลาคม 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 เผยแพร่แล้ว เวอร์ชัน 1.1.0-beta02 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • นำการตรวจสอบเวอร์ชัน T+ ออกจากคลาสคำขอการวัด ไคลเอ็นต์ไม่จําเป็นต้องตรวจสอบเวอร์ชันแพลตฟอร์ม T+ ของตนเองเพื่อเข้าถึงคลาสคําขอ privacysandbox MeasurementManager MeasurementManager จะว่างเปล่าเมื่อใช้ลักษณะการทํางานใหม่ (Ieb105)

เวอร์ชัน 1.1.0-beta01

23 สิงหาคม 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 เผยแพร่โดยไม่มีการเปลี่ยนแปลง เวอร์ชัน 1.1.0-beta01 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.1.0-alpha01

9 สิงหาคม 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 และ androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • แนะนำรายการ registerSource (Iae92f)
  • นำการใช้งาน isAtLeastU() API เวอร์ชันทดลองออก (Ie9117, b/289269026)

การแก้ไขข้อบกพร่อง

  • ผสานไฟล์ API เวอร์ชันทดลองและเวอร์ชันสาธารณะ (I15da3, b/278769092)

รุ่น 1.0

เวอร์ชัน 1.0.0-beta05

7 มิถุนายน 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta05 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • เพิ่มการตรวจสอบส่วนขยาย SDK 5 รายการลงใน TopicsManager
  • เพิ่มการพึ่งพา coroutine ของ Kotlin เป็น 1.7.1 เพื่อป้องกันข้อผิดพลาดในการสร้างคลาสซ้ำใน gradle

เวอร์ชัน 1.0.0-beta04

10 พฤษภาคม 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta04 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • แก้ปัญหาการล็อกตายเมื่อผู้เรียกใช้เรียกใช้ API การวัดผลของ adservices ในเธรดหลัก (I65361)

เวอร์ชัน 1.0.0-beta03

19 เมษายน 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เปิดใช้ Preview API สําหรับ Topics

เวอร์ชัน 1.0.0-beta02

22 มีนาคม 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta02 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • เปิดใช้ MeasurementManager API สําหรับส่วนขยาย SDK เวอร์ชัน 5 ขึ้นไป
  • ปิดใช้ MeasurementManager API สําหรับส่วนขยาย SDK เวอร์ชัน 4 และต่ำกว่า

เวอร์ชัน 1.0.0-beta01

22 กุมภาพันธ์ 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 เผยแพร่โดยไม่มีการเปลี่ยนแปลงที่สำคัญ เวอร์ชัน 1.0.0-beta01 เผยแพร่จากสาขาภายใน

การเปลี่ยนแปลงลักษณะการทำงาน

  • การรายงานการระบุแหล่งที่มาถูกปิดใช้และไม่พร้อมใช้งานในรุ่นนี้

เวอร์ชัน 1.0.0-alpha01

11 มกราคม 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 และ androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 เผยแพร่จากสาขาภายใน

  • ซึ่งเป็นไลบรารี Jetpack ใหม่ที่ช่วยให้ผสานรวมกับ Privacy Preserving API ของ Privacy Sandbox ได้ (Topics, FLEDGE และ Attribution Reporting)
  • คุณสามารถใช้ Privacy Sandbox API ของ Jetpack แทน Privacy Sandbox API ที่มีให้ใน Extension SDK 4