برای دسترسی به APIهای مربوط به Sandbox حریم خصوصی و اندازه‌گیری در Chrome و Android، برنامه‌نویسان باید در Privacy Sandbox ثبت‌نام کنند. این شامل گزارش دهی، مخاطب محافظت شده، موضوعات، انباشت خصوصی و فضای ذخیره‌سازی مشترک است. ثبت نام برنامه‌نویس، نهادهایی را که این APIها را فراخوانی می‌کنند تأیید می‌کند و داده‌های مورد نیاز برای پیکربندی و استفاده صحیح از APIها را جمع‌آوری می‌کند. ثبت نام یک لایه حفاظتی اضافی و شفافیت در مورد افرادی که داده‌ها را جمع‌آوری می‌کنند اضافه می‌کند و تلاش‌ها برای سوء استفاده از APIها برای جمع‌آوری داده‌های غیرضروری را کاهش می‌دهد. برای ارائه شفافیت قابل حسابرسی، اطلاعات ثبت نام در مورد شرکت عمومی می شود. شرکت ها باید حداقل پنج هفته برای تکمیل فرآیند ثبت نام برنامه ریزی کنند. این شامل زمان رسیدگی به هر گونه مشکل غیرمنتظره در مورد ارسال کنسول یا سایر مشکلاتی است که ممکن است ایجاد شود. این شامل زمان اضافی دیگری که ممکن است شرکت‌ها برای آماده‌سازی داخلی قبل از ارسال فرم نیاز داشته باشند، نمی‌شود.
قبل از شروع
قبل از شروع ثبت‌نام، با استفاده از Console Privacy Sandbox یک حساب ایجاد کنید. درباره ایجاد حساب کاربری بیشتر بیاموزید.
نحوه ثبت نام
برای ثبت‌نام، توسعه‌دهندگان باید از Console Sandbox Privacy استفاده کنند . شما باید اطلاعات زیر را ارائه دهید:
- اطلاعات در مورد کسب و کار شما
- این شامل آدرس ایمیل تماس و پیوندهایی به خط‌مشی‌های رازداری شما می‌شود
- API ها و سرویس هایی که قصد استفاده از آنها را دارید
- برخی از خدمات به اطلاعات بیشتری نیاز دارند، مانند جزئیات مربوط به ارائه‌دهنده Cloud شما
- سایت یا نام SDK هایی که می خواهید ثبت نام کنید
- اینجا جایی است که APIها را از آن فراخوانی خواهید کرد
- گواهی در مورد استفاده شما از APIها
- اگر در حال ثبت نام سایتی هستید، باید یک فایل گواهی را در سرور خود آپلود کنید
سایت، 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 و اطلاعات بیشتر برای امضای کلید برای مخاطب محافظت شده .
به روز رسانی اطلاعات ثبت نام
پس از تکمیل، می توانید جزئیات ثبت نام خود را از طریق کنسول به روز کنید. ثبت نام موجود شما تا زمانی که تغییرات شما در دست بررسی است فعال باقی می ماند.
اگر هر یک از اطلاعات زیر تغییر کرد، باید نسخه جدیدی از فایل گواهینامه خود را دوباره آپلود کنید:
- پیوندهای سیاست حفظ حریم خصوصی
- اطلاعات سایت
- API ها انتخاب شدند
وضعیت های ثبت نام
پس از ثبت نام خود، این مراحل پیشرفت است که ممکن است مشاهده کنید:
- بررسی کنید
- ما در حال بررسی ثبت نام شما هستیم. هیچ اقدامی لازم نیست.
- تنظیم فایل تصدیق
- ثبت نام شما تایید شد برای سایت ها، یک فایل تصدیق باید ظرف 30 روز تنظیم شود.
- ثبت نام کامل شد
- شما با موفقیت ثبت نام کرده اید و پرونده گواهینامه خود را تنظیم کرده اید (در صورت لزوم). هیچ اقدام دیگری لازم نیست.
- خطا در فایل های تصدیق
- فایل تصدیق در جای اشتباهی قرار گرفته است
- در عرض 30 روز، نتوانستیم فایل گواهی شما را برای سایت شما پیدا کنیم.
- ثبت نام به حالت تعلیق درآمد
- فایل تأیید در پنجره 30 روزه اولیه به درستی تنظیم نشده است یا پس از ثبت نام موفق قبلی، دیگر نمی توان آن را یافت. لطفاً برای اطلاعات بیشتر با privacy-sandbox-enrollment@google.com تماس بگیرید.
- فایل تصدیق در جای اشتباهی قرار گرفته است
جدول زمانی ثبت نام
پس از ثبت نام شما، درخواست شما را بررسی و پردازش خواهیم کرد. پس از اتمام بررسی، تاییدیه ای را در کنسول مشاهده می کنید و می توانید برای راه اندازی به فایل گواهی خود دسترسی داشته باشید. فایل باید ظرف 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 ثبت نام کنید، به برگه «ثبت‌نام‌ها» در ناوبری کنسول بروید. پس از تأیید اولین ثبت‌نام، می‌توانید «درخواست ثبت‌نام» را برای درخواست اضافه کردن موارد بیشتر انتخاب کنید. پس از ارسال، درخواست بررسی می‌شود و ایمیلی دریافت می‌کنید و پس از تکمیل فرآیند بررسی، وضعیت منعکس شده در کنسول را مشاهده می‌کنید.
تغییر مسیر با گزارش اسناد
سناریویی را در نظر بگیرید که در آن سایت A ثبت نام نشده است اما سایت B ثبت نام شده است. ARA URL ها را برای تغییر مسیرها پینگ می کند حتی اگر ثبت نام نکرده باشد. در نتیجه، تغییر مسیر از siteA.com به siteB.com کار خواهد کرد. با این حال، منابع و محرک‌ها فقط از فناوری‌های تبلیغاتی ثبت‌نام شده ثبت می‌شوند.
برای خدمات جمع آوری ثبت نام کنید
ثبت نام سرویس تجمیع بخشی از فرآیند ثبت نام کنسول است. هر ثبت‌نام در سرویس جمع‌آوری باید شامل شناسه حساب AWS یا حساب سرویس Google Cloud باشد که در آن سرویس تجمع مستقر می‌شود. فن‌آوری‌های تبلیغاتی این انعطاف‌پذیری را دارند که چندین سایت را به یک حساب یا چندین حساب را به یک سایت برای نیازهای مختلف آزمایشی، عملیاتی و کارآمدی هزینه پیوند دهند.
فایل گواهینامه خود را آپلود کنید
پس از ثبت نام و گذراندن مراحل تأیید، می‌توانید به فایل تأییدیه خود در کنسول دسترسی پیدا کنید. از زمان دریافت فایل تصدیق، 30 روز مهلت اجرایی خواهید داشت تا قرار دادن پرونده گواهینامه خود را نهایی کنید. در این مدت همچنان می‌توانید به مدت 30 روز با APIها تماس بگیرید، اما انتظار می‌رود که ثبت‌نام نکنید، مگر اینکه بتوانید در طول دوره اجرای 30 روزه به زبان گواهینامه پایبند باشید.
برای تکمیل ثبت نام، فایل را از مسیر .well-known عمومی در سایتی که ثبت نام کرده اید در دسترس قرار دهید. برای مثال، اگر https://example.com ثبت نام می کنید، فایل گواهی را در https://example.com/.well-known/privacy-sandbox-attestations.json قرار دهید. همچنین می‌توانید از ریدایرکت‌های HTTP فقط به زیر دامنه‌های سایت ثبت‌شده خود برای ارائه فایل گواهی استفاده کنید.
شما باید گواهینامه ها را رعایت کنید و فایل گواهی را در طول مدت ثبت نام در محل نگه دارید. فایل‌های تأیید به‌طور معمول تأیید می‌شوند، و عدم نگهداری طولانی‌مدت آنها باعث می‌شود تا زمانی که فایل بازیابی نشود، تماس‌های API با شکست مواجه می‌شوند.
توجه داشته باشید که:
- جعبه ایمنی حریم خصوصی فایل گواهی را از فناوری‌های آگهی ثبت‌نام شده دریافت می‌کند. این کار فایل را بیش از یک بار در ساعت واکشی نمی کند. تماس‌های API درخواست واکشی برای فایل گواهی را راه‌اندازی نمی‌کنند.
- هدف این است که فایل تصدیق در دسترس عموم قرار گیرد. فناوری تبلیغات باید انتظار برخی از درخواست‌های واکشی از طرف‌های خارجی، از جمله محققان، تنظیم‌کننده‌ها و کاربران را داشته باشد (خارج از درخواست‌های واکشی Privacy Sandbox infra). تکنسین‌های تبلیغاتی باید همان فایلی را که برای Google ارائه می‌کنند به آنها ارائه دهند.
برای موضوعات مربوط به تأییدیه‌های Android، برنامه‌نویسان برنامه و SDK باید با تأییدیه در فرم ثبت‌نام در کنسول موافقت کنند و نیازی به قرار دادن فایل تأیید در سرور خود ندارند، مگر اینکه از سایر APIهای Privacy Sandbox استفاده کنند.
برای افزودن API های بیشتر، گواهی را به روز کنید
اگر تصمیم دارید در تاریخ بعدی API های بیشتری را در ثبت نام خود بگنجانید، باید ثبت نام خود را به روز کنید. به عنوان بخشی از این فرآیند، یک فایل گواهی به روز شده دریافت خواهید کرد که باید قبل از اینکه بتوانید APIهای جدید را فراخوانی کنید، از مسیر .well-known در سایت خود در دسترس قرار گیرد.
به آخرین نسخه فایل گواهی به روز رسانی کنید
همه شرکت‌های ثبت‌نام شده باید به آخرین نسخه فایل گواهی که از Google دریافت کرده‌اند به‌روزرسانی کنند.
پرونده های گواهی پس از یک دوره زمانی مشخص منقضی نمی شوند. ممکن است هر از چندگاهی با تکامل چارچوب گواهی، فایل‌های گواهی جدید یا به‌روزرسانی شده ارائه شوند (به عنوان مثال، گواهی‌های ویژه API اضافه می‌شوند).
عدم موفقیت در تأیید اعتبار
دسترسی تنها در صورتی قطع می شود که سروری که فایل گواهی را بررسی می کند مکرراً نتواند آن را تأیید کند. یک خطا یا مشکل سرویس باعث تعلیق دسترسی نمی شود.
برای جزئیات بیشتر، به GitHub در گواهینامه ها مراجعه کنید.
داده های توسعه دهنده اندروید
نهادهایی که قصد استفاده از Privacy Sandbox API در Android را دارند می‌توانند از طریق رابط کاربری کنسول به شناسه ثبت نام خود دسترسی داشته باشند، که می‌تواند در پیکربندی AdServices برنامه گنجانده شود. این به توسعه دهندگان برنامه اجازه می دهد تا کنترل دقیقی بر فناوری های تبلیغاتی داشته باشند که برنامه یا SDK آنها با آنها تعامل دارند.
،برای دسترسی به APIهای مربوط به Sandbox حریم خصوصی و اندازه‌گیری در Chrome و Android، برنامه‌نویسان باید در Privacy Sandbox ثبت‌نام کنند. این شامل گزارش دهی، مخاطب محافظت شده، موضوعات، انباشت خصوصی و فضای ذخیره‌سازی مشترک است. ثبت نام برنامه‌نویس، نهادهایی را که این APIها را فراخوانی می‌کنند تأیید می‌کند و داده‌های مورد نیاز برای پیکربندی و استفاده صحیح از APIها را جمع‌آوری می‌کند. ثبت نام یک لایه حفاظتی اضافی و شفافیت در مورد افرادی که داده‌ها را جمع‌آوری می‌کنند اضافه می‌کند و تلاش‌ها برای سوء استفاده از APIها برای جمع‌آوری داده‌های غیرضروری را کاهش می‌دهد. برای ارائه شفافیت قابل حسابرسی، اطلاعات ثبت نام در مورد شرکت عمومی می شود. شرکت ها باید حداقل پنج هفته برای تکمیل فرآیند ثبت نام برنامه ریزی کنند. این شامل زمان رسیدگی به هر گونه مشکل غیرمنتظره در مورد ارسال کنسول یا سایر مشکلاتی است که ممکن است ایجاد شود. این شامل زمان اضافی دیگری که ممکن است شرکت‌ها برای آماده‌سازی داخلی قبل از ارسال فرم نیاز داشته باشند، نمی‌شود.
قبل از شروع
قبل از شروع ثبت‌نام، با استفاده از Console Privacy Sandbox یک حساب ایجاد کنید. درباره ایجاد حساب کاربری بیشتر بیاموزید.
نحوه ثبت نام
برای ثبت‌نام، توسعه‌دهندگان باید از Console Sandbox Privacy استفاده کنند . شما باید اطلاعات زیر را ارائه دهید:
- اطلاعات در مورد کسب و کار شما
- این شامل آدرس ایمیل تماس و پیوندهایی به خط‌مشی‌های رازداری شما می‌شود
- API ها و سرویس هایی که قصد استفاده از آنها را دارید
- برخی از خدمات به اطلاعات بیشتری نیاز دارند، مانند جزئیات مربوط به ارائه‌دهنده Cloud شما
- سایت یا نام SDK هایی که می خواهید ثبت نام کنید
- اینجا جایی است که APIها را از آن فراخوانی خواهید کرد
- گواهی در مورد استفاده شما از APIها
- اگر در حال ثبت نام سایتی هستید، باید یک فایل گواهی را در سرور خود آپلود کنید
سایت، 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 و اطلاعات بیشتر برای امضای کلید برای مخاطب محافظت شده .
به روز رسانی اطلاعات ثبت نام
پس از تکمیل، می توانید جزئیات ثبت نام خود را از طریق کنسول به روز کنید. ثبت نام موجود شما تا زمانی که تغییرات شما در دست بررسی است فعال باقی می ماند.
اگر هر یک از اطلاعات زیر تغییر کرد، باید نسخه جدیدی از فایل گواهینامه خود را دوباره آپلود کنید:
- پیوندهای سیاست حفظ حریم خصوصی
- اطلاعات سایت
- API ها انتخاب شدند
وضعیت های ثبت نام
پس از ثبت نام خود، این مراحل پیشرفت است که ممکن است مشاهده کنید:
- بررسی کنید
- ما در حال بررسی ثبت نام شما هستیم. هیچ اقدامی لازم نیست.
- تنظیم فایل تصدیق
- ثبت نام شما تایید شد برای سایت ها، یک فایل تصدیق باید ظرف 30 روز تنظیم شود.
- ثبت نام کامل شد
- شما با موفقیت ثبت نام کرده اید و پرونده گواهینامه خود را تنظیم کرده اید (در صورت لزوم). هیچ اقدام دیگری لازم نیست.
- خطا در فایل های تصدیق
- فایل تصدیق در جای اشتباهی قرار گرفته است
- در عرض 30 روز، نتوانستیم فایل گواهی شما را برای سایت شما پیدا کنیم.
- ثبت نام به حالت تعلیق درآمد
- فایل تأیید در پنجره 30 روزه اولیه به درستی تنظیم نشده است یا پس از ثبت نام موفق قبلی، دیگر نمی توان آن را یافت. لطفاً برای اطلاعات بیشتر با privacy-sandbox-enrollment@google.com تماس بگیرید.
- فایل تصدیق در جای اشتباهی قرار گرفته است
جدول زمانی ثبت نام
پس از ثبت نام شما، درخواست شما را بررسی و پردازش خواهیم کرد. پس از اتمام بررسی، تاییدیه ای را در کنسول مشاهده می کنید و می توانید برای راه اندازی به فایل گواهی خود دسترسی داشته باشید. فایل باید ظرف 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 ثبت نام کنید، به برگه «ثبت‌نام‌ها» در ناوبری کنسول بروید. پس از تأیید اولین ثبت‌نام، می‌توانید «درخواست ثبت‌نام» را برای درخواست اضافه کردن موارد بیشتر انتخاب کنید. پس از ارسال، درخواست بررسی می‌شود و ایمیلی دریافت می‌کنید و پس از تکمیل فرآیند بررسی، وضعیت منعکس شده در کنسول را مشاهده می‌کنید.
تغییر مسیر با گزارش اسناد
سناریویی را در نظر بگیرید که در آن سایت A ثبت نام نشده است اما سایت B ثبت نام شده است. ARA URL ها را برای تغییر مسیرها پینگ می کند حتی اگر ثبت نام نکرده باشد. در نتیجه، تغییر مسیر از siteA.com به siteB.com کار خواهد کرد. با این حال، منابع و محرک‌ها فقط از فناوری‌های تبلیغاتی ثبت‌نام شده ثبت می‌شوند.
برای خدمات جمع آوری ثبت نام کنید
ثبت نام سرویس تجمیع بخشی از فرآیند ثبت نام کنسول است. هر ثبت‌نام در سرویس جمع‌آوری باید شامل شناسه حساب AWS یا حساب سرویس Google Cloud باشد که در آن سرویس تجمع مستقر می‌شود. فن‌آوری‌های تبلیغاتی این انعطاف‌پذیری را دارند که چندین سایت را به یک حساب یا چندین حساب را به یک سایت برای نیازهای مختلف آزمایشی، عملیاتی و کارآمدی هزینه پیوند دهند.
فایل گواهینامه خود را آپلود کنید
پس از ثبت نام و گذراندن مراحل تأیید، می‌توانید به فایل تأییدیه خود در کنسول دسترسی پیدا کنید. از زمان دریافت فایل تصدیق، 30 روز مهلت اجرایی خواهید داشت تا قرار دادن پرونده گواهینامه خود را نهایی کنید. در این مدت همچنان می‌توانید به مدت 30 روز با APIها تماس بگیرید، اما انتظار می‌رود که ثبت‌نام نکنید، مگر اینکه بتوانید در طول دوره اجرای 30 روزه به زبان گواهینامه پایبند باشید.
برای تکمیل ثبت نام، فایل را از مسیر .well-known عمومی در سایتی که ثبت نام کرده اید در دسترس قرار دهید. برای مثال، اگر https://example.com ثبت نام می کنید، فایل گواهی را در https://example.com/.well-known/privacy-sandbox-attestations.json قرار دهید. همچنین می‌توانید از ریدایرکت‌های HTTP فقط به زیر دامنه‌های سایت ثبت‌شده خود برای ارائه فایل گواهی استفاده کنید.
شما باید گواهینامه ها را رعایت کنید و فایل گواهی را در طول مدت ثبت نام در محل نگه دارید. فایل‌های تأیید به‌طور معمول تأیید می‌شوند، و عدم نگهداری طولانی‌مدت آنها باعث می‌شود تا زمانی که فایل بازیابی نشود، تماس‌های API با شکست مواجه می‌شوند.
توجه داشته باشید که:
- جعبه ایمنی حریم خصوصی فایل گواهی را از فناوری‌های آگهی ثبت‌نام شده دریافت می‌کند. این کار فایل را بیش از یک بار در ساعت واکشی نمی کند. تماس‌های API درخواست واکشی برای فایل گواهی را راه‌اندازی نمی‌کنند.
- هدف این است که فایل تصدیق در دسترس عموم قرار گیرد. فناوری تبلیغات باید انتظار برخی از درخواست‌های واکشی از طرف‌های خارجی، از جمله محققان، تنظیم‌کننده‌ها و کاربران را داشته باشد (خارج از درخواست‌های واکشی Privacy Sandbox infra). تکنسین‌های تبلیغاتی باید همان فایلی را که برای Google ارائه می‌کنند به آنها ارائه دهند.
برای موضوعات مربوط به تأییدیه‌های Android، برنامه‌نویسان برنامه و SDK باید با تأییدیه در فرم ثبت‌نام در کنسول موافقت کنند و نیازی به قرار دادن فایل تأیید در سرور خود ندارند، مگر اینکه از سایر APIهای Privacy Sandbox استفاده کنند.
برای افزودن API های بیشتر، گواهی را به روز کنید
اگر تصمیم دارید در تاریخ بعدی API های بیشتری را در ثبت نام خود بگنجانید، باید ثبت نام خود را به روز کنید. به عنوان بخشی از این فرآیند، یک فایل گواهی به روز شده دریافت خواهید کرد که باید قبل از اینکه بتوانید APIهای جدید را فراخوانی کنید، از مسیر .well-known در سایت خود در دسترس قرار گیرد.
به آخرین نسخه فایل گواهی به روز رسانی کنید
همه شرکت‌های ثبت‌نام شده باید به آخرین نسخه فایل گواهی که از Google دریافت کرده‌اند به‌روزرسانی کنند.
پرونده های گواهی پس از یک دوره زمانی مشخص منقضی نمی شوند. ممکن است هر از چندگاهی با تکامل چارچوب گواهی، فایل‌های گواهی جدید یا به‌روزرسانی شده ارائه شوند (به عنوان مثال، گواهی‌های ویژه API اضافه می‌شوند).
عدم موفقیت در تأیید اعتبار
دسترسی تنها در صورتی قطع می شود که سروری که فایل گواهی را بررسی می کند مکرراً نتواند آن را تأیید کند. یک خطا یا مشکل سرویس باعث تعلیق دسترسی نمی شود.
برای جزئیات بیشتر، به GitHub در گواهینامه ها مراجعه کنید.
داده های توسعه دهنده اندروید
نهادهایی که قصد استفاده از Privacy Sandbox API در Android را دارند می‌توانند از طریق رابط کاربری کنسول به شناسه ثبت نام خود دسترسی داشته باشند، که می‌تواند در پیکربندی AdServices برنامه گنجانده شود. این به توسعه دهندگان برنامه اجازه می دهد تا کنترل دقیقی بر فناوری های تبلیغاتی داشته باشند که برنامه یا SDK آنها با آنها تعامل دارند.