หากต้องการเข้าถึง Privacy Sandbox Relevance API และ Measurement API ใน Chrome และ Android นักพัฒนาซอฟต์แวร์ต้องลงทะเบียนกับ Privacy Sandbox ซึ่งรวมถึง Attribution Reporting, Protected Audience, Topics, Private Aggregation และพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน การลงทะเบียนนักพัฒนาแอปจะยืนยันนิติบุคคลที่เรียกใช้ API เหล่านี้ และรวบรวมข้อมูลที่จำเป็นในการกำหนดค่าและใช้ API อย่างถูกต้อง การลงทะเบียน จะเพิ่มการป้องกันอีกชั้นและเพิ่มความโปร่งใสเกี่ยวกับผู้ที่ เก็บรวบรวมข้อมูล รวมถึงลดความพยายามในการใช้ API ในทางที่ผิดเพื่อเก็บรวบรวม ข้อมูลที่ไม่จำเป็น เราจะเปิดเผยข้อมูลการลงทะเบียนเกี่ยวกับบริษัทต่อสาธารณะเพื่อให้มีความโปร่งใสที่ตรวจสอบได้ บริษัทควรวางแผนล่วงหน้าอย่างน้อย 5 สัปดาห์เพื่อ ทําให้กระบวนการลงทะเบียนเสร็จสมบูรณ์ ซึ่งรวมถึงเวลาในการแก้ไขปัญหาที่ไม่คาดคิด เกี่ยวกับการส่งคอนโซลหรือปัญหาอื่นๆ ที่อาจเกิดขึ้น ซึ่งไม่รวมถึงระยะเวลารอคอยเพิ่มเติมที่บริษัทอาจต้องใช้ในการเตรียมการภายใน ก่อนส่งแบบฟอร์ม
ก่อนเริ่มต้น
ก่อนเริ่มการลงทะเบียน ให้สร้างบัญชีโดยใช้คอนโซล Privacy Sandbox ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้าง บัญชี
วิธีลงทะเบียน
หากต้องการลงทะเบียน นักพัฒนาแอปต้องใช้ Privacy Sandbox Console คุณต้องระบุข้อมูลต่อไปนี้
- ข้อมูลเกี่ยวกับธุรกิจของคุณ
- ซึ่งรวมถึงอีเมลติดต่อและลิงก์ไปยังนโยบายความเป็นส่วนตัว
- API และบริการที่คุณวางแผนจะใช้
- บางบริการต้องใช้ข้อมูลเพิ่มเติม เช่น รายละเอียดเกี่ยวกับผู้ให้บริการระบบคลาวด์
- เว็บไซต์หรือชื่อของ SDK ที่คุณต้องการลงทะเบียน
- นี่คือส่วนที่คุณจะเรียก API
- การรับรองเกี่ยวกับการใช้งาน API
- หากลงทะเบียนเว็บไซต์ คุณจะต้องอัปโหลดไฟล์การรับรองไปยังเซิร์ฟเวอร์
ลงทะเบียนเว็บไซต์, Android SDK หรือแอป Android
ในระหว่างการลงทะเบียน คุณต้องระบุเว็บไซต์หรือ SDK (หรือทั้ง 2 อย่าง) ที่จะใช้
เพื่อเรียก API
วิธีลงทะเบียนจะขึ้นอยู่กับวิธีเรียกใช้ Privacy Sandbox API ดังนี้
- หากคุณเป็นนักพัฒนาเว็บและเว็บไซต์ของคุณเรียกใช้ Privacy Sandbox API โดยตรง คุณควรระบุเว็บไซต์ในการลงทะเบียน
- หากคุณเป็นนักพัฒนา Android SDK โปรดระบุชื่อ SDK ในการลงทะเบียน หาก SDK ใช้ Attribution Reporting, Protected Audience หรือทั้ง 2 API ให้ระบุเว็บไซต์ของคุณในการลงทะเบียนด้วย แอปที่ใช้ SDK ของคุณไม่จำเป็นต้องลงทะเบียนแยกต่างหาก เว้นแต่จะเรียกใช้ Privacy Sandbox API โดยตรงจากโค้ดของตนเอง หากคุณกำลังทดสอบ Attribution Reporting API ใน Android ที่ ระดับขนาดทันที คุณจะต้องระบุต้นทางทั้งหมดที่ใช้
- หากคุณเป็นนักพัฒนาแอปและแอปของคุณเรียกใช้ Attribution Reporting, Protected Audience หรือทั้ง 2 API โดยตรง คุณควรระบุเว็บไซต์ของคุณ ในระหว่างการลงทะเบียน
- หากคุณเป็นนักพัฒนาแอปและมอบสิทธิ์ฟังก์ชันการทำงานของโฆษณาให้ SDK ทั้งหมด คุณไม่จำเป็นต้องผ่านกระบวนการลงทะเบียน
ทุกเว็บไซต์หรือ SDK ที่เรียกใช้ Privacy Sandbox API จะต้องมีการลงทะเบียนที่ไม่ซ้ำกัน และต้องรับรองแยกกัน แอปที่เรียกใช้ Privacy Sandbox API โดยตรงอาจรวมอยู่ในการลงทะเบียนครั้งเดียว หากวางแผนที่จะเรียกใช้ API หลายรายการ ให้ระบุแต่ละรายการในระหว่างกระบวนการลงทะเบียน หมายเหตุ: เว็บไซต์ที่คุณลงทะเบียนคือเว็บไซต์เดียวกันกับที่จะใช้เพื่อดึงข้อมูลการเข้ารหัส คีย์สําหรับการใช้ Topics ใน Android และคีย์การลงนามสําหรับการใช้ Protected Audience ใน Android ข้อมูลเพิ่มเติมเกี่ยวกับปลายทางการเข้ารหัสสำหรับTopics ใน Android และข้อมูลเพิ่มเติม สำหรับการลงนามคีย์สำหรับ Protected Audience
อัปเดตข้อมูลการลงทะเบียน
คุณอัปเดตรายละเอียดการลงทะเบียนผ่านคอนโซลได้เมื่อลงทะเบียนเสร็จแล้ว การลงทะเบียนที่มีอยู่จะยังคงใช้งานได้ในขณะที่การเปลี่ยนแปลงอยู่ระหว่างการตรวจสอบ
หากมีการเปลี่ยนแปลงข้อมูลต่อไปนี้ คุณจะต้องอัปโหลดไฟล์การรับรองเวอร์ชันใหม่ซ้ำ
- ลิงก์นโยบายความเป็นส่วนตัว
- ข้อมูลเว็บไซต์
- เลือก API แล้ว
สถานะการลงทะเบียน
หลังจากส่งการลงทะเบียนแล้ว คุณอาจเห็นขั้นตอนความคืบหน้าต่อไปนี้
- รีวิว
- เรากำลังตรวจสอบการลงทะเบียนของคุณ คุณไม่ต้องดำเนินการใดๆ
- ตั้งค่าไฟล์การรับรอง
- การลงทะเบียนของคุณได้รับอนุมัติแล้ว สำหรับเว็บไซต์ คุณต้องตั้งค่าไฟล์การรับรองภายใน 30 วัน
- ลงทะเบียนเสร็จสมบูรณ์
- คุณลงทะเบียนและตั้งค่าไฟล์การรับรองเรียบร้อยแล้ว (หากจำเป็น) ไม่ต้องดำเนินการเพิ่มเติม
- ข้อผิดพลาดเกี่ยวกับไฟล์การรับรอง
- ไฟล์การรับรองอยู่ผิดที่
- ภายในระยะเวลา 30 วัน เราไม่พบไฟล์การรับรองสำหรับเว็บไซต์ของคุณ
- การลงทะเบียนถูกระงับ
- ไม่ได้ตั้งค่าไฟล์การรับรองอย่างถูกต้องภายใน ช่วง 30 วันแรก หรือไม่พบไฟล์ดังกล่าวอีกหลังจากลงทะเบียนสำเร็จ ก่อนหน้านี้ โปรดติดต่อ privacy-sandbox-enrollment@google.com เพื่อขอข้อมูลเพิ่มเติม
- ไฟล์การรับรองอยู่ผิดที่
ลำดับเวลาการลงทะเบียน
หลังจากส่งการลงทะเบียนแล้ว เราจะตรวจสอบและประมวลผลใบสมัครของคุณ เมื่อการตรวจสอบเสร็จสมบูรณ์แล้ว คุณจะเห็นการยืนยันใน
คอนโซลและจะเข้าถึงไฟล์การรับรองเพื่อตั้งค่าได้ คุณต้องเผยแพร่ไฟล์ต่อสาธารณะจากเส้นทาง /.well-known ในเว็บไซต์ที่ลงทะเบียนภายใน 30 วันนับจากวันที่อนุมัติการลงทะเบียน
นักพัฒนาแอป Android
สามารถระบุรหัสการลงทะเบียนแก่นักพัฒนาแอปเพื่อให้แอปตั้งค่าการควบคุมการเข้าถึงแบบละเอียดได้ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบ
กำหนดค่าบริการโฆษณาเฉพาะ API
ของ Android
หมายเหตุ: การป้อนข้อมูลที่ถูกต้องในการส่งครั้งแรกและการตอบคำถามจากทีมสนับสนุนด้านเทคนิคของ Google อย่างทันท่วงทีจะช่วยเร่งกระบวนการให้เร็วขึ้น
การลงทะเบียนสำหรับสภาพแวดล้อมการพัฒนาต่างๆ
ระบบจะลงทะเบียนสภาพแวดล้อมการจัดเตรียม เบต้า QA และการทดสอบโดยอัตโนมัติหากใช้เว็บไซต์เดียวกันกับสภาพแวดล้อมที่ใช้งานจริง คุณทดสอบในเครื่องได้โดยไม่ต้องลงทะเบียน สำหรับการทดสอบในเครื่อง เราจะ ให้การลบล้างสำหรับนักพัฒนาซอฟต์แวร์จาก Chrome 116 ด้วย Chrome Flag และสวิตช์ CLI
- ธง:
chrome://flags/#privacy-sandbox-enrollment-overrides - CLI:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
ข้อจำกัด
โปรดทราบข้อจำกัดในการลงทะเบียนนักพัฒนาแอปต่อไปนี้เมื่อกำหนดโครงสร้างการลงทะเบียนขององค์กร
- เว็บไซต์ 1 เว็บไซต์จะลิงก์กับการลงทะเบียนได้เพียง 1 รายการ
- การลงทะเบียน 1 ครั้งจะมีได้เพียงเว็บไซต์เดียว
- ข้อจำกัดเฉพาะของ SDK
- การลงทะเบียน 1 รายการอาจมี SDK หลายรายการ
- SDK หนึ่งๆ จะลิงก์กับการลงทะเบียนได้เพียงครั้งเดียว
- คุณลงทะเบียนเพิ่มเติมได้ แต่ต้องเป็นการลงทะเบียนสำหรับผลิตภัณฑ์หรือกลุ่มธุรกิจอิสระที่จัดตั้งขึ้นอย่างชัดเจนและตรวจสอบได้แบบสาธารณะ (กล่าวคือ มีเว็บไซต์สาธารณะที่เกี่ยวข้องซึ่งอธิบายผลิตภัณฑ์นั้นๆ โดยเฉพาะ) คุณลงทะเบียนผลิตภัณฑ์เดียวกันหลายครั้งไม่ได้ การรับรองจะมีผลกับการลงทะเบียนแต่ละรายการ
- การลงทะเบียนระดับเว็บไซต์ช่วยให้การลงทะเบียนครั้งเดียวครอบคลุมต้นทางได้ไม่จำกัด ตราบใดที่ต้นทางเหล่านั้นเป็นแบบเดียวกัน อย่างไรก็ตาม ขีดจํากัดอัตราต้นทางที่รายงาน 1 รายการต่อแหล่งที่มา (Chrome, Android) หมายความว่าโดยทั่วไปคุณจะจํากัดไว้ที่ 1 ต้นทางต่อผู้เผยแพร่โฆษณา
การลงทะเบียนหลายครั้งสำหรับนิติบุคคลเดียว
นิติบุคคลที่มีความซับซ้อนมากขึ้นซึ่งมีผลิตภัณฑ์ที่ไม่ซ้ำกันหลายรายการอาจสมัครลงทะเบียนได้มากกว่า 1 ครั้ง ตัวอย่างเช่น หากบริษัทของคุณมีธุรกิจ SSP และ DSP คุณอาจมีสิทธิ์ลงทะเบียนหลายครั้ง
ผลิตภัณฑ์แต่ละรายการต้องมีเว็บไซต์แยกต่างหากเพื่อใช้เรียก API คุณจะต้องระบุการนำเสนอต่อสาธารณะสำหรับผลิตภัณฑ์แต่ละรายการที่คุณขอลงทะเบียน (เช่น ลิงก์ไปยังเว็บไซต์ที่แสดงต่อสาธารณะซึ่งอธิบายผลิตภัณฑ์)
หากต้องการลงทะเบียนเว็บไซต์หรือ SDK มากกว่า 1 รายการ ให้ไปที่แท็บ "การลงทะเบียน" ในการนำทางของคอนโซล หลังจากได้รับอนุมัติการลงทะเบียนครั้งแรกแล้ว คุณสามารถเลือก "ขอลงทะเบียน" เพื่อขอเพิ่มได้ เมื่อส่งแล้ว ระบบจะตรวจสอบใบสมัครและคุณจะได้รับอีเมล รวมถึงเห็นสถานะที่แสดงในคอนโซลเมื่อกระบวนการตรวจสอบเสร็จสมบูรณ์
เปลี่ยนเส้นทางด้วยการรายงานการระบุแหล่งที่มา
ลองนึกถึงกรณีที่เว็บไซต์ ก ไม่ได้ลงทะเบียน แต่เว็บไซต์ ข ลงทะเบียน ARA จะ Ping URL สำหรับการเปลี่ยนเส้นทางแม้ว่าจะไม่ได้ลงทะเบียนก็ตาม ด้วยเหตุนี้ การเปลี่ยนเส้นทางจาก siteA.com ไปยัง siteB.com จึงจะใช้งานได้ อย่างไรก็ตาม ระบบจะลงทะเบียนแหล่งที่มาและทริกเกอร์จากเทคโนโลยีโฆษณาที่ลงทะเบียนเท่านั้น
ลงทะเบียนใช้บริการรวมข้อมูล
การลงทะเบียนบริการรวมข้อมูลเป็นส่วนหนึ่งของกระบวนการลงทะเบียนคอนโซล การลงทะเบียนบริการรวบรวมข้อมูลแต่ละครั้งต้องมีรหัสบัญชี AWS หรือบัญชีบริการ Google Cloud ซึ่งจะมีการติดตั้งใช้งานบริการรวบรวมข้อมูล เทคโนโลยีโฆษณามีความยืดหยุ่นในการลิงก์เว็บไซต์หลายแห่งกับบัญชีเดียว หรือลิงก์หลายบัญชีกับเว็บไซต์เดียวเพื่อตอบสนองความต้องการด้านการทดสอบ การปฏิบัติงาน และประสิทธิภาพด้านต้นทุนต่างๆ
อัปโหลดไฟล์การรับรอง
เมื่อลงทะเบียนและผ่านกระบวนการยืนยันแล้ว คุณจะเข้าถึงไฟล์การรับรองในคอนโซลได้ คุณจะมีระยะเวลาการติดตั้งใช้งาน 30 วันนับจากเวลาที่ได้รับไฟล์การรับรอง เพื่อสรุปการวางไฟล์การรับรอง ในระหว่างนี้ คุณยังคงเรียกใช้ API ได้เป็นเวลา 30 วัน แต่เราคาดหวังว่าคุณจะไม่ลงทะเบียนจนกว่าจะปฏิบัติตามภาษาการรับรองได้ในช่วงระยะเวลาการติดตั้งใช้งาน 30 วัน
หากต้องการลงทะเบียนให้เสร็จสมบูรณ์ ให้เผยแพร่ไฟล์จากเส้นทาง .well-known สาธารณะในเว็บไซต์ที่ลงทะเบียน เช่น หากคุณลงทะเบียน https://example.com ให้วางไฟล์การรับรองที่ https://example.com/.well-known/privacy-sandbox-attestations.json นอกจากนี้ คุณยังใช้การเปลี่ยนเส้นทาง HTTP เฉพาะกับโดเมนย่อยของเว็บไซต์ที่ลงทะเบียนเพื่อแสดงไฟล์การรับรองได้ด้วย
คุณต้องปฏิบัติตามการรับรองและเก็บไฟล์การรับรองไว้ตลอดระยะเวลาการลงทะเบียน เราจะตรวจสอบไฟล์การรับรองเป็นประจำ และหากไม่เก็บไฟล์ไว้เป็นเวลานานจะทำให้การเรียก API ล้มเหลวจนกว่าจะมีการกู้คืนไฟล์
โปรดทราบว่า
- Privacy Sandbox จะดึงข้อมูลไฟล์การรับรองจากเทคโนโลยีโฆษณาที่ลงทะเบียน งานนี้จะดึงข้อมูลไฟล์ไม่เกิน 1 ครั้งต่อชั่วโมง การเรียก API จะไม่ทริกเกอร์คำขอเรียกข้อมูลสำหรับไฟล์การรับรอง
- โดยมีจุดประสงค์เพื่อให้ไฟล์การรับรองพร้อมใช้งานต่อสาธารณะ เทคโนโลยีโฆษณาควรคาดหวังคำขอเรียกข้อมูลบางอย่างจากบุคคลภายนอก ซึ่งรวมถึงนักวิจัย หน่วยงานกำกับดูแล และผู้ใช้ (นอกเหนือจากคำขอเรียกข้อมูลจากโครงสร้างพื้นฐานของ Privacy Sandbox) เทคโนโลยีโฆษณาต้องแสดงไฟล์เดียวกันกับที่แสดงต่อ Google
สำหรับ Attestation ของ Topics ใน Android นักพัฒนาแอปและ SDK ต้องยอมรับ Attestation ภายในแบบฟอร์มการลงทะเบียนในคอนโซล และไม่จำเป็นต้องวางไฟล์ Attestation ไว้ในเซิร์ฟเวอร์ เว้นแต่จะใช้ Privacy Sandbox API อื่นๆ
อัปเดตการรับรองเพื่อเพิ่ม API อื่นๆ
หากตัดสินใจที่จะรวม API เพิ่มเติมในการลงทะเบียนในภายหลัง คุณจะต้องอัปเดตการลงทะเบียน ในกระบวนการนี้ คุณจะได้รับไฟล์การรับรองที่อัปเดตแล้ว ซึ่งต้องพร้อมใช้งานจากเส้นทาง .well-known ในเว็บไซต์ก่อนจึงจะเรียกใช้ API ใหม่ได้
อัปเดตไฟล์การรับรองเป็นเวอร์ชันล่าสุด
บริษัทที่ลงทะเบียนทั้งหมดต้องอัปเดตไฟล์การรับรองที่ได้รับจาก Google เป็นเวอร์ชันล่าสุด
ไฟล์การรับรองไม่หมดอายุหลังจากผ่านไประยะเวลาหนึ่ง เราอาจจัดหาไฟล์การรับรองใหม่หรือที่อัปเดตแล้วเป็นครั้งคราวเมื่อเฟรมเวิร์กการรับรองมีการเปลี่ยนแปลง (เช่น มีการเพิ่มการรับรองใหม่ที่เฉพาะเจาะจง API)
การตรวจสอบการรับรองไม่สำเร็จ
ระบบจะตัดสิทธิ์เข้าถึงก็ต่อเมื่อเซิร์ฟเวอร์ที่ตรวจสอบไฟล์การรับรองไม่สามารถตรวจสอบไฟล์ดังกล่าวได้ซ้ำๆ ข้อผิดพลาดหรือปัญหาการแสดงเพียงรายการเดียวจะไม่ทำให้ระบบระงับการเข้าถึง
ดูรายละเอียดเพิ่มเติมได้ที่ GitHub เกี่ยวกับการรับรอง
ข้อมูลนักพัฒนาแอป Android
นิติบุคคลที่ต้องการใช้ Privacy Sandbox API ใน Android สามารถเข้าถึงรหัสการลงทะเบียนผ่าน UI ของคอนโซล ซึ่งสามารถรวมไว้ในการกำหนดค่า AdServices ของแอปได้ ซึ่งช่วยให้นักพัฒนาแอปควบคุมเทคโนโลยีโฆษณาที่แอปหรือ SDK โต้ตอบด้วยได้อย่างละเอียด