برای دسترسی به APIهای مربوط به Sandbox حریم خصوصی و اندازه‌گیری در Chrome و Android، برنامه‌نویسان باید در Privacy Sandbox ثبت‌نام کنند. این شامل گزارش دهی، مخاطب محافظت شده، موضوعات، انباشت خصوصی و فضای ذخیره‌سازی مشترک است. ثبت نام برنامه‌نویس مکانیزمی را برای تأیید نهادهایی که این APIها را فراخوانی می‌کنند، و جمع‌آوری داده‌های خاص توسعه‌دهنده مورد نیاز برای پیکربندی و استفاده صحیح از APIهای Privacy Sandbox فراهم می‌کند. این فرآیند ثبت‌نام، با افزودن شفافیت به افرادی که داده‌ها را جمع‌آوری می‌کنند، و کاهش تلاش‌ها برای سوء استفاده از APIها برای جمع‌آوری داده‌های بیشتر از آنچه در نظر گرفته شده است، یک لایه حفاظتی اضافی در بالای محدودیت‌های ساختاری اعمال‌شده در هر API اضافه می‌کند. برای ارائه شفافیت قابل حسابرسی، اطلاعات ثبت نام در مورد شرکت عمومی خواهد شد. شرکت ها باید حداقل پنج هفته برای تکمیل فرآیند ثبت نام، از زمانی که فرم ثبت نام را ارسال می کنند، برنامه ریزی کنند. این شامل زمان رسیدگی به مشکلات مربوط به ارسال فرم یا سایر مشکلاتی است که ممکن است ایجاد شود. این شامل زمان اضافی دیگری که ممکن است شرکت‌ها برای آماده‌سازی داخلی قبل از ارسال فرم نیاز داشته باشند، نمی‌شود.
قبل از اینکه شروع کنی
قبل از شروع ثبت نام، مطمئن شوید که یک شماره DUNS برای سازمان خود دارید. این یک شماره نه رقمی منحصر به فرد ارائه شده توسط Dun & Bradstreet است که برای شناسایی کسب و کار شما استفاده می شود و به عنوان بخشی از فرآیند تأیید ثبت نام در جعبه ایمنی حریم خصوصی بررسی می شود. اگر چندین شماره DUNS برای شرکت شما صادر شده است، بالاترین سطحی را ارائه دهید که نشان دهنده نهاد کلی شرکت شما باشد. اگر کسب و کار شما یک شخص حقوقی نیست، نمی توانید شماره DUNS را دریافت کنید.
برای بررسی اینکه آیا شرکت شما قبلاً شماره DUNS اختصاص داده شده دارد یا برای به دست آوردن یک شماره DUNS جدید، با استفاده از فرم ثبت نام درخواست دهید. Google یک فرآیند درخواست سریع و سریع Dun & Bradstreet برای این منظور در دسترس دارد. هنگامی که درخواست را انجام دادید، یک ایمیل با یک پیوند منحصر به فرد و یکبار برای شما ارسال می کنیم تا از صفحه فرود مخصوص Google بازدید کنید تا جزئیات کسب و کار خود را ارسال کنید. اگر ارسال اطلاعات خود را کامل نکردید، باید پیوند دیگری را از Google درخواست کنید.
یک شماره DUNS به عنوان یک فرد دریافت کنید
اگر شما یک فرد هستید و به یک سازمان وابسته نیستید، یا سازمان شما قادر به دریافت شماره DUNS نیست، می توانید به عنوان یک فرد در فرم ثبت نام ثبت نام کنید. همه اطلاعات (به استثنای اطلاعات قابل شناسایی شخصی) جمع‌آوری‌شده در طول ثبت‌نام برنامه‌نویس ممکن است در گزارش‌های جعبه ایمنی حریم خصوصی گنجانده شود. این گزارش ها برای عموم در دسترس خواهد بود.
نحوه ثبت نام
برای ثبت نام، توسعه دهندگان باید فرم ثبت نام را تکمیل کنند . فرم اطلاعات زیر را درخواست می کند:
- اطلاعات تماس کسب و کار
- شماره DUNS برای سازمان شما
- APIهایی که قصد استفاده از آنها را دارید و اطلاعات پیکربندی API
توسعه‌دهندگان همچنین باید با گواهی‌های مربوط به استفاده از APIهای ثبت‌شده Privacy Sandbox موافقت کنند.
سایت، Android SDK یا برنامه Android خود را ثبت نام کنید
در طول ثبت نام، باید یک سایت یا SDK (یا هر دو) ارائه دهید که از آن برای فراخوانی APIها استفاده کنید.
نحوه ثبت نام بستگی به نحوه نامگذاری APIهای Privacy Sandbox دارد:
- اگر شما یک توسعه‌دهنده وب هستید و سایت شما مستقیماً با APIهای Privacy Sandbox تماس می‌گیرد، باید سایت خود را هنگام ثبت‌نام ارائه دهید.
- اگر یک برنامه‌نویس Android SDK هستید، نام SDK خود را در ثبت‌نام وارد کنید. اگر SDK شما از Attribution Reporting، Protected Audience یا هر دو API استفاده می کند، سایت خود را در ثبت نام نیز ارائه دهید. برنامه‌هایی که از SDK شما استفاده می‌کنند نیازی به ثبت نام جداگانه ندارند، مگر اینکه مستقیماً از طریق کد خود با APIهای Privacy Sandbox تماس بگیرند. اگر فوراً APIهای Attribution Reporting را در Android در مقیاس آزمایش می‌کنید، باید همه مبداهایی را که استفاده می‌کنید ارائه دهید.
- اگر توسعه‌دهنده برنامه هستید و برنامه شما مستقیماً با گزارش‌های Attribution، مخاطبین محافظت‌شده یا هر دو API تماس می‌گیرد، باید سایت خود را در حین ثبت‌نام ارائه دهید.
- اگر یک توسعه‌دهنده برنامه هستید و عملکرد تبلیغات خود را به طور کامل به یک SDK واگذار می‌کنید، نیازی به انجام مراحل ثبت‌نام ندارید.
هر سایت یا SDK که از APIهای Privacy Sandbox فراخوانی می‌کند، نیاز به ثبت نام منحصربه‌فرد دارد و نیاز به تأیید جداگانه دارد. برنامه‌هایی که مستقیماً با Privacy Sandbox تماس می‌گیرند، ممکن است در یک ثبت‌نام گنجانده شوند. اگر قصد دارید چندین API را فراخوانی کنید، هر کدام را در طول فرآیند ثبت نام مشخص کنید. توجه: سایتی که در آن ثبت نام می کنید همان سایتی است که برای بازیابی کلیدهای رمزگذاری برای استفاده از موضوعات در اندروید و کلید امضا برای استفاده شما از مخاطبان محافظت شده در اندروید استفاده می شود. اطلاعات بیشتر در مورد نقطه پایانی رمزگذاری برای موضوعات در Android و اطلاعات بیشتر برای امضای کلید برای مخاطب محافظت شده .
به روز رسانی اطلاعات ثبت نام
شما می توانید اطلاعات ثبت نام خود را با استفاده از فرم ثبت نام به روز کنید. به روز رسانی ها جایگزین پاسخ های قبلی خواهند شد.
جدول زمانی ثبت نام
پس از ارسال فرم ثبت نام، درخواست شما را بررسی و پردازش خواهیم کرد. پس از تکمیل بررسی، یک ایمیل تأیید با شناسه حساب ثبت نام توسعه دهنده منحصر به فرد و فایل تأیید برای شما ارسال می شود. این فایل باید ظرف 30 روز پس از دریافت شناسه حساب و فایل تصدیق، از مسیر /.well-known در سایتی که برای آن ثبت نام شده است، در دسترس عموم قرار گیرد. توسعه دهندگان Android می توانند شناسه ثبت نام را در اختیار توسعه دهندگان برنامه قرار دهند تا برنامه ها بتوانند کنترل دسترسی ریز را تنظیم کنند. برای اطلاعات بیشتر، به مستندات سرویس های تبلیغاتی مخصوص API Android's Configure مراجعه کنید. توجه: بررسی های ثبت نام پس از تکمیل صحیح فرم ثبت نام به طور کامل تکمیل می شود. وارد کردن اطلاعات صحیح در مورد ارسال اصلی خود و پاسخگویی به موقع به هرگونه سؤال از تیم پشتیبانی فنی Google به سرعت بخشیدن به روند کمک می کند.
ثبت نام برای محیط های توسعه مختلف
اگر محیط‌های مرحله‌بندی، بتا، QA و آزمایش شما از همان سایتی که محیط تولید شما استفاده می‌کنند، به‌طور خودکار ثبت‌نام می‌شوند. می توانید بدون ثبت نام به صورت محلی تست کنید. برای آزمایش محلی، ما از Chrome 116 لغو برنامه‌نویسی با پرچم کروم و سوئیچ CLI ارائه می‌کنیم:
- پرچم:
chrome://flags/#privacy-sandbox-enrollment-overrides - CLI:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
محدودیت ها
هنگام تعیین ساختار ثبت نام سازمان خود، به محدودیت های ثبت نام توسعه دهنده زیر توجه کنید:
- یک سایت را فقط می توان به یک ثبت نام پیوند داد.
- یک ثبت نام فقط شامل یک سایت است.
- محدودیت های خاص SDK:
- یک ثبت نام ممکن است حاوی چندین SDK باشد.
- یک SDK داده شده را فقط می توان به یک ثبت نام مرتبط کرد.
- ثبت‌نام‌های اضافی مجاز هستند، اما باید برای محصولات یا خطوط کسب‌وکار مستقلی باشند که به وضوح ایجاد شده‌اند و به‌طور عمومی قابل تأیید هستند (یعنی یک وب‌سایت عمومی مربوطه وجود دارد که محصول خاص را توضیح می‌دهد). نمی توانید چندین ثبت نام برای یک محصول داشته باشید. گواهینامه ها برای هر ثبت نام به صورت جداگانه اعمال می شود.
- با ثبت نام در محدوده سایت، یک ثبت نام می تواند مبدأ نامحدودی را پوشش دهد، تا زمانی که آنها در همان سایت باشند. با این حال، محدودیت یک منبع گزارش در هر منبع ( Chrome ، Android ) به این معنی است که شما معمولاً به یک منبع برای هر ناشر محدود می‌شوید.
ثبت نام های متعدد برای یک نهاد واحد
نهادهای پیچیده تری که چندین محصول منحصر به فرد دارند ممکن است برای بیش از یک ثبت نام درخواست دهند. به عنوان مثال، اگر شرکت شما دارای یک خط کسب و کار SSP و DSP باشد، ممکن است واجد شرایط ثبت نام چندگانه باشید.
هر محصول باید دارای سایت‌های مجزایی باشد که بتوان از آنها APIها را فراخوانی کرد. از شما خواسته می شود برای هر محصولی که درخواست ثبت نام می کنید، نمایندگی عمومی ارائه دهید (به عنوان مثال، پیوند به یک وب سایت عمومی که محصول را توضیح می دهد).
اگر می خواهید بیش از یک سایت یا SDK ثبت نام کنید، علاوه بر ارسال فرم ثبت نام عادی برای اولین ثبت نامی که درخواست می کنید ، فرم فرآیند درخواست ثبت چندگانه را پر کنید. پس از ارسال، درخواست بررسی می شود و پس از تکمیل فرآیند بررسی، ایمیلی دریافت خواهید کرد.
چندین ثبت نام را تحت یک شماره DUNS ارسال کنید
اگر با استفاده از فرم فرآیند درخواست ثبت نام چندگانه درخواست ثبت نام می کنید، می توانید از همان شماره DUNS در هر ثبت نام استفاده کنید.
تغییر مسیر با گزارش اسناد
سناریویی را در نظر بگیرید که در آن سایت A ثبت نام نشده است اما سایت B ثبت نام شده است. ARA URL ها را برای تغییر مسیرها پینگ می کند حتی اگر ثبت نام نکرده باشد. در نتیجه، تغییر مسیر از siteA.com به siteB.com کار خواهد کرد. با این حال، منابع و محرک‌ها فقط از فناوری‌های تبلیغاتی ثبت‌نام شده ثبت می‌شوند.
برای خدمات جمع آوری ثبت نام کنید
در حال حاضر یک فرآیند ثبت نام جداگانه برای عناصر سرور و APIهای سرویس گیرنده (برای Chrome و Android) وجود دارد. هر دو فرم ثبت نام برای استفاده از خدمات جمع آوری الزامی است. ما به دنبال ساده سازی فرآیندها هستیم. در حال حاضر، سرویس تجمع یک فرم جداگانه دارد. شما یک مبدأ (طرح، نام میزبان) را در طول ثبت نام در سرویس تجمیع ثبت می کنید که باید بخشی از همان سایت (طرح، eTLD+1) باشد که از طریق ثبت نام توسعه دهنده ثبت شده است.
هر ثبت نام در سرویس تجمیع باید شامل شناسه حساب AWS باشد که در آن سرویس تجمع مستقر می شود. هر حساب AWS ممکن است فقط به یک ثبت نام در سرویس تجمع مرتبط باشد.
فایل گواهینامه خود را آپلود کنید
پس از ثبت‌نام و گذراندن مراحل تأیید، ما فایلی حاوی گواهی‌های مربوط به API را به آدرس ایمیلی که ارائه کرده‌اید ارسال می‌کنیم. از زمان دریافت شناسه حساب و فایل تصدیق، یک دوره اجرایی 30 روزه خواهید داشت تا قرار دادن پرونده گواهینامه خود را نهایی کنید. در این مدت همچنان می‌توانید به مدت 30 روز با APIها تماس بگیرید، با این حال انتظار می‌رود که در این مدت به زبان گواهینامه پایبند باشید.
برای تکمیل ثبت نام، باید فایل را از مسیر .well-known عمومی در سایتی که ثبت نام کرده اید در دسترس قرار دهید. برای مثال، اگر https://example.com را ثبت نام می کنید، فایل گواهی را در https://example.com/.well-known/privacy-sandbox-attestations.json قرار دهید. شما نمی توانید از تغییر مسیرهای HTTP برای ارائه فایل گواهی استفاده کنید. فایل تصدیق باید در دایرکتوری .well-known در سایت شما قرار داشته باشد. نمی تواند به مکان دیگری هدایت شود (مثلاً یک زیر دامنه یا سایت دیگری).
شما باید گواهینامه ها را رعایت کنید و فایل گواهی را در طول مدت ثبت نام در محل نگه دارید. فایل‌های تأیید به‌طور معمول تأیید می‌شوند، و عدم نگهداری طولانی‌مدت آنها باعث می‌شود تا زمانی که فایل بازیابی نشود، تماس‌های API با شکست مواجه می‌شوند.
توجه داشته باشید که:
- Privacy Sandbox یک کار سمت سرور را اجرا می‌کند تا فایل گواهی را از فن‌آوری‌های تبلیغاتی ثبت‌نام‌شده دریافت کند و یک لیست مجاز بر اساس محتویات فایل بسازد. این لیست مجاز سپس با مرورگر و همچنین سیستم عامل همگام سازی می شود. این کار فایل را بیش از یک بار در ساعت واکشی نمی کند.
- هدف این است که فایل تصدیق در دسترس عموم قرار گیرد. فناوری تبلیغات باید انتظار برخی از درخواست‌های واکشی از طرف‌های خارجی از جمله محققان، تنظیم‌کننده‌ها و کاربران را داشته باشد (خارج از درخواست‌های واکشی Privacy Sandbox infra). تکنسین‌های تبلیغاتی باید همان فایلی را که برای Google ارائه می‌کنند به آنها ارائه دهند.
- هر تماس API یک درخواست واکشی برای فایل گواهی را راه‌اندازی نمی‌کند.
برای موضوعات مربوط به تأییدیه‌های Android، توسعه‌دهندگان برنامه و SDK باید با تأییدیه در فرم ثبت‌نام موافقت کنند و نیازی به قرار دادن فایل تأیید در سرور خود ندارند، مگر اینکه از سایر APIهای Privacy Sandbox استفاده کنند.
برای افزودن API های بیشتر، گواهی را به روز کنید
اگر تصمیم دارید در تاریخ بعدی API های بیشتری را در ثبت نام خود بگنجانید، باید ثبت نام خود را به روز کنید. به عنوان بخشی از این فرآیند، یک فایل گواهی به روز شده دریافت خواهید کرد که باید قبل از اینکه بتوانید APIهای جدید را فراخوانی کنید، از مسیر .well-known در سایت خود در دسترس قرار گیرد.
به آخرین نسخه فایل گواهی به روز رسانی کنید
همه شرکت‌های ثبت‌نام شده باید به آخرین نسخه فایل گواهی که از Google دریافت کرده‌اند به‌روزرسانی کنند.
پرونده های گواهی پس از یک دوره زمانی مشخص منقضی نمی شوند . ممکن است هر چند وقت یکبار با تکامل چارچوب گواهینامه، فایل‌های گواهینامه جدید یا به‌روزرسانی شده ارائه شوند (به عنوان مثال، گواهی‌های جدید مخصوص API اضافه می‌شوند و غیره).
خطاهای یکباره
دسترسی تنها در صورتی قطع می شود که سروری که فایل گواهی را بررسی می کند مکرراً نتواند آن را تأیید کند. یک خطا یا مشکل سرویس باعث حذف دسترسی نمی شود.
برای جزئیات بیشتر، به GitHub در گواهینامه ها مراجعه کنید.
داده های توسعه دهنده اندروید
به نهادهایی که قصد دارند از APIهای جعبه ایمنی حریم خصوصی در Android استفاده کنند، یک شناسه حساب ثبت‌نام ارسال می‌شود که می‌تواند در پیکربندی AdServices برنامه گنجانده شود. این به توسعه دهندگان برنامه اجازه می دهد تا کنترل دقیقی بر فناوری های تبلیغاتی داشته باشند که برنامه یا SDK آنها با آنها تعامل دارند.