برای دسترسی به 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 یا حساب سرویس GCP باشد که در آن سرویس تجمع مستقر میشود. Adtech ها این انعطاف پذیری را دارند که چندین سایت را به یک حساب کاربری یا چندین حساب را به یک سایت برای نیازهای مختلف تست، عملیاتی و کارایی هزینه پیوند دهند.
فایل گواهینامه خود را آپلود کنید
پس از ثبتنام و گذراندن مراحل تأیید، ما فایلی حاوی گواهیهای مربوط به 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 آنها با آنها تعامل دارند.
،برای دسترسی به 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 یا حساب سرویس GCP باشد که در آن سرویس تجمع مستقر میشود. Adtech ها این انعطاف پذیری را دارند که چندین سایت را به یک حساب کاربری یا چندین حساب را به یک سایت برای نیازهای مختلف تست، عملیاتی و کارایی هزینه پیوند دهند.
فایل گواهینامه خود را آپلود کنید
پس از ثبتنام و گذراندن مراحل تأیید، ما فایلی حاوی گواهیهای مربوط به 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 آنها با آنها تعامل دارند.
،برای دسترسی به 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 های ماسه ای حریم خصوصی دارد:
- اگر شما یک توسعه دهنده وب هستید و سایت شما به طور مستقیم با API های Sandbox حریم خصوصی تماس می گیرد ، باید سایت خود را در ثبت نام ارائه دهید.
- اگر یک توسعه دهنده SDK Android هستید ، نام SDK خود را در ثبت نام ارائه دهید. اگر SDK شما از گزارش انتساب ، مخاطبان محافظت شده یا هر دو API استفاده می کند ، سایت خود را نیز در ثبت نام ارائه می دهد. برنامه هایی که از SDK شما استفاده می کنند ، نیازی به ثبت نام جداگانه ندارند ، مگر اینکه آنها API های Sandbox Privacy را مستقیماً از کد خودشان صدا کنند. اگر در حال آزمایش API های گزارش انتساب در Android در مقیاس بلافاصله هستید ، باید تمام منشاء مورد استفاده خود را ارائه دهید.
- اگر شما یک توسعه دهنده برنامه هستید و برنامه شما گزارش انتساب ، مخاطبان محافظت شده یا هر دو API را مستقیماً فراخوانی می کند ، باید سایت خود را در هنگام ثبت نام ارائه دهید.
- اگر شما یک توسعه دهنده برنامه هستید و عملکرد تبلیغات خود را کاملاً به SDK واگذار می کنید ، نیازی به انجام روند ثبت نام ندارید.
هر سایتی یا SDK که API های ماسه ای حریم خصوصی را فراخوانی می کند ، نیاز به ثبت نام منحصر به فرد دارد و باید به صورت جداگانه تصدیق کند. برنامه هایی که به طور مستقیم با API های ماسه ای حریم خصوصی تماس می گیرند ممکن است در یک ثبت نام واحد گنجانده شوند. اگر قصد دارید با چندین API تماس بگیرید ، هر یک را در طی مراحل ثبت نام مشخص کنید. توجه: سایتی که با آن ثبت نام می کنید همان سایتی است که برای بازیابی کلیدهای رمزگذاری برای استفاده از موضوعات در Android و کلید امضا برای استفاده شما از مخاطبان محافظت شده در Android استفاده می شود. اطلاعات بیشتر در مورد نقطه پایان رمزگذاری برای موضوعات مربوط به Android و اطلاعات بیشتر برای امضای کلیدها برای مخاطبان محافظت شده .
اطلاعات ثبت نام را به روز کنید
می توانید اطلاعات ثبت نام خود را با استفاده از فرم ثبت نام به روز کنید. به روزرسانی ها پاسخ های قبلی را جایگزین می کنند.
جدول زمانی ثبت نام
پس از ارسال فرم ثبت نام شما ، برنامه شما را مرور و پردازش خواهیم کرد. پس از اتمام بررسی ، یک ایمیل تأیید با یک شناسه حساب ثبت نام منحصر به فرد توسعه دهنده و پرونده تأیید ارسال می شود. این پرونده باید از مسیر /.well-known
شناخته شده در سایتی که در طی 30 روز از دریافت شناسه حساب و پرونده تأیید ثبت نام کرده است ، در دسترس عموم قرار گیرد. توسعه دهندگان Android می توانند شناسه ثبت نام را به برنامه نویسان برنامه ارائه دهند تا برنامه ها بتوانند کنترل دسترسی دانه ای را تنظیم کنند. برای اطلاعات بیشتر ، به مستندات خدمات تبلیغاتی خاص API ANDROID مراجعه کنید. توجه: پس از تکمیل فرم ثبت نام به طور صحیح در کل ، بررسی ثبت نام انجام می شود. وارد کردن اطلاعات صحیح در مورد ارسال اصلی و پاسخ به هرگونه سوالات از تیم پشتیبانی Google Tech به موقع به سرعت بخشیدن به روند کمک می کند.
ثبت نام برای محیط های مختلف توسعه
در صورت استفاده از همان سایت با محیط تولید شما ، محیط های مرحله بندی ، بتا ، QA و آزمایش شما به طور خودکار ثبت نام می کنند. شما می توانید بدون ثبت نام در محلی آزمایش کنید. برای آزمایش محلی ، ما با پرچم Chrome و سوئیچ CLI ، از برنامه های توسعه دهنده از Chrome 116 استفاده می کنیم:
- پرچم:
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 یا حساب خدمات GCP باشد که در آن سرویس جمع آوری مستقر خواهد شد. AdTechs انعطاف پذیری در پیوند چندین سایت به یک حساب یا چندین حساب به یک سایت برای نیازهای مختلف آزمایش ، عملیاتی و راندمان هزینه دارد.
پرونده تأیید خود را بارگذاری کنید
پس از ثبت نام و تصویب روند تأیید ، پرونده ای را ارسال می کنیم که حاوی گواهینامه های خاص API به آدرس ایمیل شما ارائه شده است. شما از زمان دریافت شناسه حساب و پرونده تأیید ، یک دوره اجرای 30 روزه خواهید داشت تا قرار دادن پرونده تأیید خود را نهایی کنید. در این مدت شما هنوز هم می توانید 30 روز با API تماس بگیرید ، اما انتظار می رود که در این مدت به زبان تأیید پایبند باشید.
برای تکمیل ثبت نام ، باید این پرونده را از طریق مسیر .well-known
در سایت که در سایت ثبت نام شده است ، در دسترس قرار دهید. به عنوان مثال ، اگر https://example.com
ثبت نام می کنید ، پرونده تأیید را در https://example.com/.well-known/privacy-sandbox-attestations.json
قرار دهید. شما نمی توانید از HTTP Redirects برای خدمت به پرونده تأیید استفاده کنید. پرونده تأیید باید در فهرست .well-known
در سایت شما قرار داشته باشد. نمی تواند به مکان دیگری هدایت شود (به عنوان مثال ، یک زیر دامنه یا یک سایت دیگر.)
شما باید از تصدیق پیروی کنید و پرونده تأیید را برای مدت زمان ثبت نام در نظر بگیرید. پرونده های تأیید به طور معمول تأیید می شوند ، و عدم موفقیت طولانی مدت در جای خود باعث می شود تماس های API تا زمان ترمیم پرونده از بین بروند.
توجه داشته باشید که:
- حریم خصوصی Sandbox یک کار سمت سرور را برای واکشی پرونده تصدیق از فناوری های ثبت شده ثبت شده اجرا می کند و بر اساس محتوای پرونده ، یک لیست مجاز را می سازد. سپس این لیست اجازه با مرورگر و همچنین سیستم عامل همگام سازی می شود. این کار بیش از یک بار در ساعت پرونده را واکشی می کند.
- هدف این است که پرونده تأیید عمومی در دسترس باشد. فناوری تبلیغی باید انتظار داشته باشد که برخی از درخواست های واکشی از طرفهای خارجی ، از جمله محققان ، تنظیم کننده ها و کاربران (خارج از درخواست های واکشی از حریم خصوصی Sandbox Infra). فناوری های تبلیغاتی باید همان پرونده را برای آنها ارائه دهند که به Google خدمت می کنند.
- هر تماس API درخواست واکشی برای پرونده تأیید را ایجاد نمی کند.
برای مباحث مربوط به تأییدات Android ، توسعه دهندگان برنامه و SDK باید با تأیید در فرم ثبت نام موافقت کنند و نیازی به قرار دادن یک پرونده تأیید بر روی سرور خود ندارند ، مگر اینکه آنها از API های Sandbox دیگر حریم خصوصی استفاده کنند.
تأیید اعتبار را برای اضافه کردن API های بیشتر به روز کنید
اگر تصمیم دارید API های بیشتری را در ثبت نام خود در تاریخ بعدی قرار دهید ، باید ثبت نام خود را به روز کنید. به عنوان بخشی از این فرآیند ، قبل از اینکه بتوانید با API های جدید تماس بگیرید ، یک پرونده تأیید شده به روز شده را دریافت خواهید کرد که باید از مسیر .well-known
در سایت خود در دسترس باشد.
آخرین نسخه پرونده تأیید را به روز کنید
کلیه شرکت های ثبت نام شده باید آخرین نسخه پرونده تأییدیه ای را که از Google دریافت کرده اند به روز کنند.
پرونده های تأیید پس از مدت زمان مشخصی منقضی نمی شوند. پرونده های تأیید جدید یا به روز شده ممکن است هر از گاهی ارائه شود زیرا چارچوب تصدیق تکامل می یابد (به عنوان مثال ، گواهی های جدید API اضافه شده و غیره).
خطاهای یک طرفه
دسترسی فقط در صورتی قطع می شود که سرور که پرونده تأیید را بررسی می کند ، بارها قادر به اعتبار آن نباشد. یک خطای واحد یا مسئله خدمت باعث حذف دسترسی نمی شود.
برای اطلاعات بیشتر ، به GitHub در مورد گواهینامه ها مراجعه کنید.
داده های توسعه دهنده اندرویدی
اشخاصی که قصد استفاده از API های Sandbox Privacy را در Android دارند ، یک شناسه حساب ثبت نام ارسال می شوند که می تواند در پیکربندی AdService یک برنامه گنجانده شود. این امر به توسعه دهندگان برنامه اجازه می دهد تا کنترل ریز و درشتی بر تکنیک های تبلیغاتی داشته باشند که برنامه یا SDK آنها با آنها تعامل دارند.
،برای دسترسی به API های مربوط به ارتباط و اندازه گیری Sandbox حریم خصوصی در Chrome و Android ، توسعه دهندگان باید با ماسهبازی حریم خصوصی ثبت نام کنند. این شامل گزارشگری انتساب ، مخاطبان محافظت شده ، مباحث ، جمع آوری خصوصی و ذخیره مشترک است. ثبت نام توسعه دهنده مکانیسمی را برای تأیید اشخاصی که این API ها را می نامند ، و جمع آوری داده های خاص توسعه دهنده مورد نیاز برای پیکربندی صحیح و استفاده از API های ماسه ای حریم خصوصی فراهم می کند. این فرآیند ثبت نام یک لایه اضافی از محافظت در بالای محدودیت های ساختاری که در هر API اعمال می شود ، با افزودن شفافیت به کسانی که در حال جمع آوری داده ها هستند ، و کاهش تلاش برای سوء استفاده از API ها برای جمع آوری داده های بیشتر از آنچه در نظر گرفته شده است ، اضافه می کند. برای ارائه شفافیت قابل شنیدن ، اطلاعات ثبت نام در مورد شرکت علنی می شود. شرکت ها باید حداقل پنج هفته برای تکمیل روند ثبت نام ، از زمان ارسال فرم ثبت نام ، برنامه ریزی کنند. این شامل زمان رسیدگی به هرگونه مشکل در مورد ارسال فرم یا سایر مواردی است که ممکن است بوجود بیاید. این شامل هیچ زمان دیگری نیست که شرکت ها ممکن است قبل از ارسال فرم ، نیاز به آماده سازی داخلی داشته باشند.
قبل از شروع
قبل از شروع ثبت نام ، حتماً شماره DUNS را برای سازمان خود داشته باشید. این یک شماره نه رقمی منحصر به فرد است که توسط Dun & Bradstreet ارائه شده است که برای شناسایی شغل شما استفاده می شود و به عنوان بخشی از فرآیند تأیید ثبت نام Sandbox Privation بررسی می شود. اگر شرکت شما چندین شماره DUNS صادر شده است ، بالاترین سطح را ارائه دهید که نماینده نهاد کلی شرکت شما است. اگر تجارت شما یک نهاد حقوقی نیست ، نمی توانید شماره DUNS را بدست آورید.
برای بررسی اینکه آیا شرکت شما از قبل شماره DUNS اختصاص داده شده یا برای به دست آوردن شماره جدید DUNS ، با استفاده از فرم ثبت نام درخواست کنید. Google یک فرآیند درخواست Dun & Bradstreet را برای این منظور در دسترس دارد. پس از درخواست ، ما برای بازدید از صفحه فرود خاص Google برای ارسال جزئیات کسب و کار خود ، یک ایمیل با یک پیوند منحصر به فرد و یک بار برای شما ارسال خواهیم کرد. اگر ارسال اطلاعات خود را کامل نکنید ، باید پیوند دیگری از Google درخواست کنید.
به عنوان یک فرد شماره DUNS دریافت کنید
اگر فردی هستید و به یک سازمان وابسته نیستید ، یا سازمان شما قادر به دریافت شماره DUNS نیست ، ممکن است به عنوان یک فرد در فرم ثبت نام ثبت نام کنید. کلیه اطلاعات (به استثنای اطلاعات شناسایی شخصی) جمع آوری شده در هنگام ثبت نام توسعه دهنده ممکن است در گزارش های Sandbox Privacy Pliverty گنجانده شود. این گزارش ها در دسترس عموم خواهد بود.
نحوه ثبت نام
برای ثبت نام ، توسعه دهندگان باید فرم ثبت نام را تکمیل کنند . فرم اطلاعات زیر را درخواست می کند:
- اطلاعات تماس کسب و کار
- شماره DUNS برای سازمان شما
- API هایی که قصد دارید از آنها و اطلاعات پیکربندی API استفاده کنید
توسعه دهندگان همچنین باید در مورد استفاده خود از API های Sandbox Plierty ثبت شده ، موافقت خود را موافقت کنند.
برنامه سایت خود ، Android SDK یا Android را ثبت کنید
در حین ثبت نام ، باید یک سایت یا SDK (یا هر دو) را که برای تماس با API استفاده می کنید ، تهیه کنید.
نحوه ثبت نام بستگی به نحوه نامگذاری API های ماسه ای حریم خصوصی دارد:
- اگر شما یک توسعه دهنده وب هستید و سایت شما به طور مستقیم با API های Sandbox حریم خصوصی تماس می گیرد ، باید سایت خود را در ثبت نام ارائه دهید.
- اگر یک توسعه دهنده SDK Android هستید ، نام SDK خود را در ثبت نام ارائه دهید. اگر SDK شما از گزارش انتساب ، مخاطبان محافظت شده یا هر دو API استفاده می کند ، سایت خود را نیز در ثبت نام ارائه می دهد. برنامه هایی که از SDK شما استفاده می کنند ، نیازی به ثبت نام جداگانه ندارند ، مگر اینکه آنها API های Sandbox Privacy را مستقیماً از کد خودشان صدا کنند. اگر در حال آزمایش API های گزارش انتساب در Android در مقیاس بلافاصله هستید ، باید تمام منشاء مورد استفاده خود را ارائه دهید.
- اگر شما یک توسعه دهنده برنامه هستید و برنامه شما گزارش انتساب ، مخاطبان محافظت شده یا هر دو API را مستقیماً فراخوانی می کند ، باید سایت خود را در هنگام ثبت نام ارائه دهید.
- اگر شما یک توسعه دهنده برنامه هستید و عملکرد تبلیغات خود را کاملاً به SDK واگذار می کنید ، نیازی به انجام روند ثبت نام ندارید.
هر سایتی یا SDK که API های ماسه ای حریم خصوصی را فراخوانی می کند ، نیاز به ثبت نام منحصر به فرد دارد و باید به صورت جداگانه تصدیق کند. برنامه هایی که به طور مستقیم با API های ماسه ای حریم خصوصی تماس می گیرند ممکن است در یک ثبت نام واحد گنجانده شوند. اگر قصد دارید با چندین API تماس بگیرید ، هر یک را در طی مراحل ثبت نام مشخص کنید. توجه: سایتی که با آن ثبت نام می کنید همان سایتی است که برای بازیابی کلیدهای رمزگذاری برای استفاده از موضوعات در Android و کلید امضا برای استفاده شما از مخاطبان محافظت شده در Android استفاده می شود. اطلاعات بیشتر در مورد نقطه پایان رمزگذاری برای موضوعات مربوط به Android و اطلاعات بیشتر برای امضای کلیدها برای مخاطبان محافظت شده .
اطلاعات ثبت نام را به روز کنید
می توانید اطلاعات ثبت نام خود را با استفاده از فرم ثبت نام به روز کنید. به روزرسانی ها پاسخ های قبلی را جایگزین می کنند.
جدول زمانی ثبت نام
پس از ارسال فرم ثبت نام شما ، برنامه شما را مرور و پردازش خواهیم کرد. پس از اتمام بررسی ، یک ایمیل تأیید با یک شناسه حساب ثبت نام منحصر به فرد توسعه دهنده و پرونده تأیید ارسال می شود. این پرونده باید از مسیر /.well-known
شناخته شده در سایتی که در طی 30 روز از دریافت شناسه حساب و پرونده تأیید ثبت نام کرده است ، در دسترس عموم قرار گیرد. توسعه دهندگان Android می توانند شناسه ثبت نام را به برنامه نویسان برنامه ارائه دهند تا برنامه ها بتوانند کنترل دسترسی دانه ای را تنظیم کنند. برای اطلاعات بیشتر ، به مستندات خدمات تبلیغاتی خاص API ANDROID مراجعه کنید. توجه: پس از تکمیل فرم ثبت نام به طور صحیح در کل ، بررسی ثبت نام انجام می شود. وارد کردن اطلاعات صحیح در مورد ارسال اصلی و پاسخ به هرگونه سوالات از تیم پشتیبانی Google Tech به موقع به سرعت بخشیدن به روند کمک می کند.
ثبت نام برای محیط های مختلف توسعه
در صورت استفاده از همان سایت با محیط تولید شما ، محیط های مرحله بندی ، بتا ، QA و آزمایش شما به طور خودکار ثبت نام می کنند. شما می توانید بدون ثبت نام در محلی آزمایش کنید. برای آزمایش محلی ، ما با پرچم Chrome و سوئیچ CLI ، از برنامه های توسعه دهنده از Chrome 116 استفاده می کنیم:
- پرچم:
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 یا حساب خدمات GCP باشد که در آن سرویس جمع آوری مستقر خواهد شد. AdTechs انعطاف پذیری در پیوند چندین سایت به یک حساب یا چندین حساب به یک سایت برای نیازهای مختلف آزمایش ، عملیاتی و راندمان هزینه دارد.
پرونده تأیید خود را بارگذاری کنید
پس از ثبت نام و تصویب روند تأیید ، پرونده ای را ارسال می کنیم که حاوی گواهینامه های خاص API به آدرس ایمیل شما ارائه شده است. شما از زمان دریافت شناسه حساب و پرونده تأیید ، یک دوره اجرای 30 روزه خواهید داشت تا قرار دادن پرونده تأیید خود را نهایی کنید. در این مدت شما هنوز هم می توانید 30 روز با API تماس بگیرید ، اما انتظار می رود که در این مدت به زبان تأیید پایبند باشید.
برای تکمیل ثبت نام ، باید این پرونده را از طریق مسیر .well-known
در سایت که در سایت ثبت نام شده است ، در دسترس قرار دهید. به عنوان مثال ، اگر https://example.com
ثبت نام می کنید ، پرونده تأیید را در https://example.com/.well-known/privacy-sandbox-attestations.json
قرار دهید. شما نمی توانید از HTTP Redirects برای خدمت به پرونده تأیید استفاده کنید. پرونده تأیید باید در فهرست .well-known
در سایت شما قرار داشته باشد. نمی تواند به مکان دیگری هدایت شود (به عنوان مثال ، یک زیر دامنه یا یک سایت دیگر.)
شما باید از تصدیق پیروی کنید و پرونده تأیید را برای مدت زمان ثبت نام در نظر بگیرید. پرونده های تأیید به طور معمول تأیید می شوند ، و عدم موفقیت طولانی مدت در جای خود باعث می شود تماس های API تا زمان ترمیم پرونده از بین بروند.
توجه داشته باشید که:
- حریم خصوصی Sandbox یک کار سمت سرور را برای واکشی پرونده تصدیق از فناوری های ثبت شده ثبت شده اجرا می کند و بر اساس محتوای پرونده ، یک لیست مجاز را می سازد. سپس این لیست اجازه با مرورگر و همچنین سیستم عامل همگام سازی می شود. این کار بیش از یک بار در ساعت پرونده را واکشی می کند.
- هدف این است که پرونده تأیید عمومی در دسترس باشد. فناوری تبلیغی باید انتظار داشته باشد که برخی از درخواست های واکشی از طرفهای خارجی ، از جمله محققان ، تنظیم کننده ها و کاربران (خارج از درخواست های واکشی از حریم خصوصی Sandbox Infra). فناوری های تبلیغاتی باید همان پرونده را برای آنها ارائه دهند که به Google خدمت می کنند.
- هر تماس API درخواست واکشی برای پرونده تأیید را ایجاد نمی کند.
برای مباحث مربوط به تأییدات Android ، توسعه دهندگان برنامه و SDK باید با تأیید در فرم ثبت نام موافقت کنند و نیازی به قرار دادن یک پرونده تأیید بر روی سرور خود ندارند ، مگر اینکه آنها از API های Sandbox دیگر حریم خصوصی استفاده کنند.
تأیید اعتبار را برای اضافه کردن API های بیشتر به روز کنید
اگر تصمیم دارید API های بیشتری را در ثبت نام خود در تاریخ بعدی قرار دهید ، باید ثبت نام خود را به روز کنید. به عنوان بخشی از این فرآیند ، قبل از اینکه بتوانید با API های جدید تماس بگیرید ، یک پرونده تأیید شده به روز شده را دریافت خواهید کرد که باید از مسیر .well-known
در سایت خود در دسترس باشد.
آخرین نسخه پرونده تأیید را به روز کنید
کلیه شرکت های ثبت نام شده باید آخرین نسخه پرونده تأییدیه ای را که از Google دریافت کرده اند به روز کنند.
پرونده های تأیید پس از مدت زمان مشخصی منقضی نمی شوند. پرونده های تأیید جدید یا به روز شده ممکن است هر از گاهی ارائه شود زیرا چارچوب تصدیق تکامل می یابد (به عنوان مثال ، گواهی های جدید API اضافه شده و غیره).
خطاهای یک طرفه
دسترسی فقط در صورتی قطع می شود که سرور که پرونده تأیید را بررسی می کند ، بارها قادر به اعتبار آن نباشد. یک خطای واحد یا مسئله سرویس باعث حذف دسترسی نمی شود.
برای اطلاعات بیشتر ، به GitHub در مورد گواهینامه ها مراجعه کنید.
داده های توسعه دهنده اندرویدی
اشخاصی که قصد استفاده از API های Sandbox Privacy را در Android دارند ، یک شناسه حساب ثبت نام ارسال می شوند که می تواند در پیکربندی AdService یک برنامه گنجانده شود. این امر به توسعه دهندگان برنامه اجازه می دهد تا کنترل ریز و درشتی بر تکنیک های تبلیغاتی داشته باشند که برنامه یا SDK آنها با آنها تعامل دارند.