برای دسترسی به APIهای مرتبط و اندازه‌گیری Privacy Sandbox در کروم و اندروید، توسعه‌دهندگان باید در Privacy Sandbox ثبت‌نام کنند. این شامل گزارش‌دهی انتساب، مخاطبان محافظت‌شده، موضوعات، تجمیع خصوصی و ذخیره‌سازی مشترک می‌شود. ثبت‌نام توسعه‌دهنده، نهادهایی را که این APIها را فراخوانی می‌کنند، تأیید می‌کند و داده‌های مورد نیاز برای پیکربندی و استفاده صحیح از APIها را جمع‌آوری می‌کند. ثبت‌نام، یک لایه حفاظتی اضافی به شفافیت و شناسایی افرادی که داده‌ها را جمع‌آوری می‌کنند، اضافه می‌کند و تلاش‌ها برای سوءاستفاده از APIها برای جمع‌آوری داده‌های غیرضروری را کاهش می‌دهد. برای ارائه شفافیت قابل حسابرسی، اطلاعات ثبت‌نام در مورد شرکت به‌صورت عمومی منتشر می‌شود. شرکت‌ها باید حداقل پنج هفته برای تکمیل فرآیند ثبت‌نام برنامه‌ریزی کنند. این شامل زمان برای رسیدگی به هرگونه مشکل غیرمنتظره در ارسال کنسول یا سایر مشکلاتی است که ممکن است پیش بیاید. این شامل هیچ زمان اضافی که شرکت‌ها ممکن است برای آماده‌سازی داخلی قبل از ارسال فرم نیاز داشته باشند، نمی‌شود.
قبل از اینکه شروع کنی
قبل از شروع ثبت نام، با استفاده از کنسول Privacy Sandbox یک حساب کاربری ایجاد کنید. درباره ایجاد حساب کاربری بیشتر بدانید.
نحوه ثبت نام
برای ثبت نام، توسعه‌دهندگان باید از کنسول Privacy Sandbox استفاده کنند . شما باید اطلاعات زیر را ارائه دهید:
- اطلاعات مربوط به کسب و کار شما
- این شامل یک آدرس ایمیل تماس و پیوندهایی به سیاست‌های حفظ حریم خصوصی شما می‌شود.
- APIها و سرویس‌هایی که قصد استفاده از آنها را دارید
- برخی از سرویس‌ها به اطلاعات اضافی نیاز دارند، مانند جزئیات مربوط به ارائه‌دهنده‌ی فضای ابری شما
- سایت یا نام SDK هایی که می خواهید ثبت کنید
- اینجا جایی است که APIها را از آنجا فراخوانی خواهید کرد
- گواهی‌هایی در مورد استفاده شما از APIها
- اگر در حال ثبت سایتی هستید، باید یک فایل تأیید را در سرور خود بارگذاری کنید
سایت، Android SDK یا برنامه Android خود را ثبت کنید
در طول ثبت‌نام، باید یک سایت یا SDK (یا هر دو) که برای فراخوانی APIها استفاده خواهید کرد، ارائه دهید.
نحوه ثبت نام شما بستگی به نحوه فراخوانی API های Privacy Sandbox دارد:
- اگر شما یک توسعه‌دهنده وب هستید و سایت شما مستقیماً APIهای Privacy Sandbox را فراخوانی می‌کند، باید سایت خود را در قسمت ثبت‌نام ارائه دهید.
- اگر توسعه‌دهنده‌ی SDK اندروید هستید، نام SDK خود را در بخش ثبت‌نام ارائه دهید. اگر SDK شما از APIهای Attribution Reporting، Protected Audience یا هر دو استفاده می‌کند، سایت خود را نیز در بخش ثبت‌نام ارائه دهید. برنامه‌هایی که از SDK شما استفاده می‌کنند نیازی به ثبت‌نام جداگانه ندارند، مگر اینکه APIهای Privacy Sandbox را مستقیماً از کد خود فراخوانی کنند. اگر APIهای Attribution Reporting را فوراً در مقیاس بزرگ روی اندروید آزمایش می‌کنید، باید تمام منابع مورد استفاده خود را ارائه دهید.
- اگر شما یک توسعه‌دهنده اپلیکیشن هستید و اپلیکیشن شما مستقیماً APIهای Attribution Reporting، Protected Audience یا هر دو را فراخوانی می‌کند، باید هنگام ثبت‌نام، سایت خود را ارائه دهید.
- اگر شما یک توسعه‌دهنده اپلیکیشن هستید و عملکرد تبلیغات خود را به‌طور کامل به یک SDK واگذار می‌کنید، نیازی به طی کردن مراحل ثبت‌نام ندارید.
هر سایت یا SDK که APIهای Privacy Sandbox را فراخوانی می‌کند، نیاز به یک ثبت‌نام منحصر به فرد دارد و باید به صورت جداگانه تأیید شود. برنامه‌هایی که APIهای Privacy Sandbox را مستقیماً فراخوانی می‌کنند، ممکن است در یک ثبت‌نام واحد گنجانده شوند. اگر قصد دارید چندین API را فراخوانی کنید، هر کدام را در طول فرآیند ثبت‌نام مشخص کنید. توجه: سایتی که در آن ثبت‌نام می‌کنید، همان سایتی است که برای بازیابی کلیدهای رمزگذاری برای استفاده از Topics در اندروید و کلید امضای شما برای استفاده از Protected Audience در اندروید استفاده خواهد شد. اطلاعات بیشتر در مورد نقطه پایانی رمزگذاری برای Topics در اندروید و اطلاعات بیشتر برای کلیدهای امضای Protected Audience .
به‌روزرسانی اطلاعات ثبت‌نام
شما می‌توانید پس از تکمیل، جزئیات ثبت‌نام خود را از طریق کنسول به‌روزرسانی کنید. ثبت‌نام فعلی شما تا زمان بررسی تغییرات، فعال خواهد ماند.
اگر هر یک از اطلاعات زیر تغییر کند، باید نسخه جدیدی از فایل گواهی خود را دوباره بارگذاری کنید:
- پیوندهای سیاست حفظ حریم خصوصی
- اطلاعات سایت
- API های انتخاب شده
وضعیت‌های ثبت‌نام
پس از ثبت نام، مراحل پیشرفت کار به شرح زیر است:
- نقد و بررسی
- ما در حال بررسی ثبت نام شما هستیم. نیازی به انجام هیچ کاری نیست.
- تنظیم پرونده تایید صلاحیت
- ثبت نام شما تأیید شد. برای سایت‌ها، یک فایل تأیید باید ظرف 30 روز تنظیم شود.
- ثبت نام تکمیل شد
- شما با موفقیت ثبت نام کرده و پرونده گواهی خود را (در صورت لزوم) تنظیم کرده‌اید. هیچ اقدام دیگری لازم نیست.
- خطاهای مربوط به فایل‌های تأیید هویت
- فایل تاییدیه در جای اشتباهی قرار دارد
- در طول مهلت ۳۰ روزه، ما نتوانستیم فایل تأییدیه سایت شما را پیدا کنیم.
- ثبت‌نام به حالت تعلیق درآمد
- فایل گواهی در بازه زمانی ۳۰ روز اولیه به درستی تنظیم نشده است یا پس از ثبت نام موفق قبلی، دیگر قابل دسترسی نیست. لطفاً برای اطلاعات بیشتر با privacy-sandbox-enrollment@google.com تماس بگیرید.
- فایل تاییدیه در جای اشتباهی قرار دارد
جدول زمانی ثبت نام
پس از ارسال ثبت‌نام شما، درخواست شما را بررسی و پردازش خواهیم کرد. پس از اتمام بررسی، تأییدیه‌ای در کنسول مشاهده خواهید کرد و می‌توانید برای راه‌اندازی به فایل تأیید خود دسترسی پیدا کنید. این فایل باید ظرف 30 روز پس از تأیید ثبت‌نام، از مسیر /.well-known در سایتی که در آن ثبت‌نام شده است، به‌طور عمومی در دسترس قرار گیرد. توسعه‌دهندگان اندروید می‌توانند شناسه ثبت‌نام را در اختیار توسعه‌دهندگان برنامه قرار دهند تا برنامه‌ها بتوانند کنترل دسترسی جزئی را تنظیم کنند. برای اطلاعات بیشتر، به مستندات خدمات تبلیغاتی ویژه API در اندروید مراجعه کنید. توجه: وارد کردن اطلاعات صحیح در درخواست اولیه و پاسخ به هرگونه سؤال از تیم پشتیبانی فنی گوگل به موقع، به سرعت بخشیدن به روند کار کمک می‌کند.
ثبت نام برای محیط‌های توسعه مختلف
محیط‌های آزمایشی، بتا، تضمین کیفیت و تست شما در صورتی که از همان سایت محیط اصلی شما استفاده کنند، به طور خودکار ثبت می‌شوند. می‌توانید بدون نیاز به ثبت‌نام، به صورت محلی تست کنید. برای تست محلی، ما از Chrome 116 با یک Chrome flag و سوئیچ CLI، overrideهای توسعه‌دهندگان را ارائه می‌دهیم:
- پرچم:
chrome://flags/#privacy-sandbox-enrollment-overrides - رابط خط فرمان:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
محدودیت‌ها
هنگام تعیین ساختار ثبت‌نام سازمان خود، به محدودیت‌های ثبت‌نام توسعه‌دهندگان زیر توجه کنید:
- یک سایت فقط می‌تواند به یک ثبت‌نام مرتبط باشد.
- یک ثبت نام فقط شامل یک سایت است.
- محدودیت‌های خاص SDK:
- یک ثبت نام ممکن است شامل چندین SDK باشد.
- یک SDK مشخص فقط می‌تواند به یک ثبت نام (enrollment) مرتبط باشد.
- ثبت نام‌های اضافی مجاز است، اما باید برای محصولات یا خطوط تجاری مستقلی باشد که به وضوح مشخص و قابل تأیید عمومی باشند (یعنی، یک وب‌سایت عمومی مربوطه وجود داشته باشد که محصول خاص را توضیح دهد). شما نمی‌توانید چندین ثبت نام برای یک محصول داشته باشید. این گواهی‌ها برای هر ثبت نام به صورت جداگانه اعمال می‌شوند.
- با ثبت‌نام بر اساس محدوده سایت، یک ثبت‌نام واحد می‌تواند تعداد نامحدودی از مبدأها را پوشش دهد، البته تا زمانی که آنها در یک سایت باشند. با این حال، محدودیت نرخ گزارش یک مبدأ به ازای هر منبع ( کروم ، اندروید ) به این معنی است که شما عموماً به یک مبدأ برای هر ناشر محدود هستید.
ثبت نام چندگانه برای یک نهاد واحد
نهادهای پیچیده‌تری که محصولات متعدد و منحصر به فردی دارند، ممکن است برای بیش از یک ثبت نام درخواست دهند. به عنوان مثال، اگر شرکت شما دارای یک خط 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 تا زمان بازیابی فایل با شکست مواجه شوند.
توجه داشته باشید که:
- Privacy Sandbox فایل گواهی را از تکنسین‌های تبلیغات ثبت‌نام‌شده دریافت می‌کند. این کار فایل را حداکثر ساعتی یک‌بار دریافت می‌کند. فراخوانی‌های API درخواستی برای دریافت فایل گواهی ایجاد نمی‌کنند.
- هدف این است که فایل گواهی به صورت عمومی در دسترس باشد. تکنسین تبلیغات باید انتظار برخی درخواست‌های واکشی از طرف اشخاص خارجی، از جمله محققان، تنظیم‌کنندگان و کاربران (خارج از درخواست‌های واکشی از Privacy Sandbox infra) را داشته باشد. تکنسین‌های تبلیغات باید همان فایلی را که به گوگل ارائه می‌دهند، به آنها نیز ارائه دهند.
برای مباحث مربوط به گواهی‌های اندروید، توسعه‌دهندگان برنامه و SDK باید با گواهی در فرم ثبت‌نام در کنسول موافقت کنند و نیازی به قرار دادن فایل گواهی در سرور خود ندارند، مگر اینکه از APIهای Privacy Sandbox دیگری استفاده کنند.
به‌روزرسانی گواهی‌نامه برای افزودن APIهای بیشتر
اگر تصمیم دارید APIهای بیشتری را در تاریخ بعدی در ثبت‌نام خود بگنجانید، باید ثبت‌نام خود را به‌روزرسانی کنید. به عنوان بخشی از این فرآیند، قبل از اینکه بتوانید APIهای جدید را فراخوانی کنید، یک فایل تأیید به‌روزرسانی‌شده دریافت خواهید کرد که باید از مسیر .well-known در سایت شما در دسترس قرار گیرد.
به‌روزرسانی به آخرین نسخه فایل تأییدیه
همه شرکت‌های ثبت‌شده باید آخرین نسخه فایل گواهی‌نامه‌ای که از گوگل دریافت کرده‌اند را به‌روزرسانی کنند.
فایل‌های گواهی پس از مدت زمان مشخصی منقضی نمی‌شوند . فایل‌های گواهی جدید یا به‌روزرسانی‌شده ممکن است هر از گاهی با تکامل چارچوب گواهی ارائه شوند (برای مثال، گواهی‌های جدید مختص API اضافه می‌شوند).
خرابی‌های اعتبارسنجی گواهی
دسترسی فقط در صورتی قطع می‌شود که سروری که فایل گواهی را بررسی می‌کند، نتواند مکرراً آن را تأیید کند. یک خطا یا مشکل در سرویس‌دهی باعث تعلیق دسترسی نمی‌شود.
برای جزئیات بیشتر، به گیت‌هاب در مورد گواهی‌ها مراجعه کنید.
داده‌های توسعه‌دهندگان اندروید
نهادهایی که قصد استفاده از APIهای Privacy Sandbox را در اندروید دارند، می‌توانند از طریق رابط کاربری کنسول به شناسه ثبت‌نام خود دسترسی پیدا کنند که می‌تواند در پیکربندی AdServices یک برنامه گنجانده شود. این امر به توسعه‌دهندگان برنامه اجازه می‌دهد تا کنترل دقیقی بر روی فناوری‌های تبلیغاتی که برنامه یا SDKهای آنها با آنها تعامل دارند، داشته باشند.