للوصول إلى واجهات برمجة التطبيقات ذات الصلة بالقياس والصلة بـ "مبادرة حماية الخصوصية" على Chrome وAndroid، على المطوّرين التسجيل في "مبادرة حماية الخصوصية". ويشمل ذلك تقارير تحديد المصدر والجمهور المحمي والمواضيع والتجميع الخاص ومساحة التخزين المشتركة. يُجري برنامج تسجيل المطوّرين عملية تحقّق من الكيانات التي تطلب بيانات من واجهات برمجة التطبيقات هذه، ويجمع البيانات اللازمة لضبط واجهات برمجة التطبيقات واستخدامها بشكل صحيح. توفّر عملية التسجيل طبقة إضافية من الحماية والشفافية حول الجهة التي تجمع البيانات، كما تقلّل من محاولات إساءة استخدام واجهات برمجة التطبيقات لجمع بيانات غير ضرورية. لتوفير شفافية يمكن التدقيق فيها، يتم إتاحة معلومات التسجيل عن الشركة للجميع. على الشركات التخطيط لمدة خمسة أسابيع على الأقل لإكمال عملية التسجيل. ويشمل ذلك الوقت اللازم لحلّ أي مشاكل غير متوقّعة في عملية الإرسال من خلال وحدة التحكّم أو أي مشاكل أخرى قد تظهر. ولا يشمل ذلك أيّ وقت إضافي قد تحتاجه الشركات للتحضير الداخلي قبل إرسال النموذج.
قبل البدء
قبل بدء التسجيل، أنشئ حسابًا باستخدام وحدة تحكّم Privacy Sandbox. مزيد من المعلومات حول إنشاء الحسابات
كيفية التسجيل
للتسجيل، على المطوّرين استخدام وحدة التحكّم لحماية الخصوصية. يجب تقديم المعلومات التالية:
- معلومات عن نشاطك التجاري
- ويشمل ذلك عنوان بريد إلكتروني للتواصل وروابط تؤدي إلى سياسات الخصوصية.
- واجهات برمجة التطبيقات والخدمات التي تخطّط لاستخدامها
- تتطلّب بعض الخدمات معلومات إضافية، مثل تفاصيل عن مقدّم خدمة السحابة الإلكترونية.
- الموقع الإلكتروني أو اسم حِزم SDK التي تريد تسجيلها
- هذا هو المكان الذي ستستدعي منه واجهات برمجة التطبيقات.
- شهادات حول استخدامك لواجهات برمجة التطبيقات
- إذا كنت بصدد تسجيل موقع إلكتروني، عليك تحميل ملف شهادات اعتماد إلى خادمك.
تسجيل موقعك الإلكتروني أو حزمة تطوير البرامج (SDK) لنظام التشغيل Android أو تطبيق Android
أثناء التسجيل، عليك تقديم موقع إلكتروني أو حزمة تطوير برامج (SDK) (أو كليهما) ستستخدمهما للاتصال بواجهات برمجة التطبيقات.
تعتمد طريقة التسجيل على كيفية استدعاء واجهات برمجة التطبيقات Privacy Sandbox API:
- إذا كنت مطوّر ويب وكان موقعك الإلكتروني يستدعي واجهات برمجة تطبيقات Privacy Sandbox مباشرةً، عليك تقديم موقعك الإلكتروني في عملية التسجيل.
- إذا كنت مطوّر حزمة SDK لنظام التشغيل Android، قدِّم اسم حزمة SDK في عملية التسجيل. إذا كانت حزمة SDK تستخدِم Attribution Reporting API أو Protected Audience API أو كلتاهما، قدِّم موقعك الإلكتروني في عملية التسجيل أيضًا. لا تحتاج التطبيقات التي تستخدم حزمة SDK إلى التسجيل بشكل منفصل، ما لم تستدعي واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" مباشرةً من رمزها البرمجي. إذا كنت تختبر واجهات برمجة تطبيقات Attribution Reporting API على Android على نطاق واسع على الفور، عليك تقديم جميع المصادر التي تستخدمها.
- إذا كنت مطوّر تطبيقات وكان تطبيقك يستدعي Attribution Reporting API أو Protected Audience API أو كليهما مباشرةً، عليك تقديم موقعك الإلكتروني أثناء التسجيل.
- إذا كنت مطوّر تطبيقات وفوّضت وظيفة عرض الإعلانات بالكامل إلى حزمة تطوير برامج (SDK)، لن تحتاج إلى إكمال عملية التسجيل.
يتطلّب كل موقع إلكتروني أو حِزمة تطوير برامج (SDK) تستدعي واجهات برمجة التطبيقات في "مبادرة حماية الخصوصية" عملية تسجيل فريدة ويجب أن يتم إثبات امتثالها بشكلٍ فردي. يمكن تضمين التطبيقات التي تستدعي واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" مباشرةً في عملية تسجيل واحدة. إذا كنت تخطّط لاستدعاء واجهات برمجة تطبيقات متعددة، حدِّد كل واجهة منها أثناء عملية التسجيل. ملاحظة: الموقع الإلكتروني الذي تسجّل من خلاله هو الموقع الإلكتروني نفسه الذي سيتم استخدامه لاسترداد مفاتيح التشفير لاستخدام ميزة "المواضيع" على Android ومفتاح التوقيع لاستخدام ميزة "شريحة الجمهور المحمية" على Android. مزيد من المعلومات حول نقطة نهاية التشفير في Topics على Android ومزيد من المعلومات حول مفاتيح التوقيع في شريحة الجمهور المحمية
تعديل معلومات التسجيل
يمكنك تعديل تفاصيل التسجيل من خلال وحدة التحكّم بعد اكتمال عملية التسجيل. سيظلّ تسجيلك الحالي نشطًا أثناء مراجعة التغييرات التي أجريتها.
في حال تغيّر أي من المعلومات التالية، عليك إعادة تحميل نسخة جديدة من ملف الإقرار:
- روابط سياسة الخصوصية
- معلومات عن الموقع
- واجهات برمجة التطبيقات المحدّدة
حالات التسجيل
بعد إرسال طلب التسجيل، إليك مراحل التقدّم التي قد تظهر لك:
- المراجعة
- نحن نراجع طلب تسجيلك. وليس عليك اتّخاذ أي إجراء.
- إعداد ملف الإقرار
- تمت الموافقة على تسجيلك. بالنسبة إلى المواقع الإلكترونية، يجب إعداد ملف إثبات الهوية في غضون 30 يومًا.
- اكتمال التسجيل
- لقد سجّلت ملف الإقرار وأعددته بنجاح (إذا لزم الأمر). لا يلزم اتخاذ أي إجراء آخر.
- أخطاء في ملفات الإقرار
- ملف الإقرار في مكان غير صحيح
- خلال فترة الـ 30 يومًا، لم نتمكّن من تحديد موقع ملف الإقرار لموقعك الإلكتروني.
- تم تعليق التسجيل
- لم يتم إعداد ملف الإقرار بشكل صحيح خلال فترة الـ 30 يومًا الأولى أو لم يعُد بإمكانك العثور عليه بعد تسجيل ناجح سابق. يُرجى التواصل مع privacy-sandbox-enrollment@google.com للحصول على مزيد من المعلومات.
- ملف الإقرار في مكان غير صحيح
المخطط الزمني للتسجيل
بعد إرسال طلب التسجيل، سنراجعه وسنعالجه. بعد اكتمال المراجعة، ستظهر لك رسالة تأكيد في وحدة التحكّم وستتمكّن من الوصول إلى ملف شهادة الاعتماد لإجراء عملية الإعداد. يجب إتاحة الملف للجميع من مسار /.well-known على الموقع الإلكتروني الذي تم تسجيله فيه خلال 30 يومًا من تاريخ الموافقة على التسجيل. يمكن لمطوّري تطبيقات Android تقديم رقم تعريف التسجيل لمطوّري التطبيقات حتى تتمكّن التطبيقات من ضبط التحكّم الدقيق في الوصول. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات ضبط خدمات الإعلانات المتعلّقة بواجهة برمجة التطبيقات في Android.
ملاحظة: يساعد إدخال معلومات صحيحة في العينة الأصلية التي تم إرسالها والردّ على أي استفسارات من فريق الدعم الفني في Google في الوقت المناسب على تسريع العملية.
التسجيل في بيئات تطوير مختلفة
سيتم تسجيل بيئات الاختبار والإصدار التجريبي وضمان الجودة والنشر التجريبي تلقائيًا إذا كانت تستخدم الموقع الإلكتروني نفسه المستخدَم في بيئة الإنتاج. يمكنك إجراء الاختبار على الجهاز بدون التسجيل. للاختبار على الجهاز، نوفّر خيارات إلغاء إعدادات المطوّرين من الإصدار 116 من Chrome باستخدام علامة Chrome ومفتاح تبديل سطر الأوامر:
- الرمز البرمجي:
chrome://flags/#privacy-sandbox-enrollment-overrides - وحدة التحكّم في الخطوط:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
القيود
يُرجى مراعاة القيود التالية المفروضة على تسجيل المطوّرين عند تحديد بنية تسجيل مؤسستك:
- لا يمكن ربط موقع إلكتروني واحد إلا بتسجيل واحد.
- يحتوي التسجيل الواحد على موقع إلكتروني واحد فقط.
- القيود المتعلّقة بحِزم SDK:
- قد يحتوي التسجيل الواحد على حِزم تطوير برامج متعددة.
- لا يمكن ربط حزمة SDK معيّنة إلا بتسجيل واحد.
- يُسمح بعمليات التسجيل الإضافية، ولكن يجب أن تكون لمنتجات أو مجالات عمل مستقلة تم إنشاؤها بوضوح ويمكن التحقّق منها بشكل علني (أي أن يكون هناك موقع إلكتروني علني مقابل يوضّح المنتج المحدّد). لا يمكنك إجراء عمليات تسجيل متعددة للمنتج نفسه. تنطبق الإقرارات على كل عملية تسجيل على حدة.
- من خلال التسجيل على مستوى الموقع الإلكتروني، يمكن أن يشمل التسجيل الفردي عددًا غير محدود من مصادر البيانات، ما دامت على الموقع الإلكتروني نفسه. ومع ذلك، فإنّ الحدّ الأقصى لعدد مصادر إعداد التقارير (Chrome وAndroid) هو مصدر واحد لكل ناشر.
عمليات تسجيل متعدّدة لكيان واحد
يمكن أن تتقدّم الكيانات الأكثر تعقيدًا التي تمتلك منتجات متعددة وفريدة بطلب للحصول على أكثر من عملية تسجيل واحدة. على سبيل المثال، إذا كانت شركتك تمتلك خطّ عمل لخدمة SSP وDSP، قد تكون مؤهّلة للاشتراكات المتعدّدة.
يجب أن يكون لكل منتج مواقع إلكترونية منفصلة يمكن من خلالها طلب واجهات برمجة التطبيقات. سيُطلب منك تقديم تمثيل علني لكل منتج تطلب تسجيله (على سبيل المثال، رابط يؤدي إلى موقع إلكتروني متاح للجميع يوضّح المنتج).
إذا كنت تريد تسجيل أكثر من موقع إلكتروني أو حزمة SDK واحدة، انتقِل إلى علامة التبويب "عمليات التسجيل" في شريط التنقّل في وحدة التحكّم. بعد الموافقة على عملية التسجيل الأولى، يمكنك النقر على "طلب عمليات التسجيل" لطلب إضافة المزيد. بعد إرسال الطلب، ستتم مراجعته وستتلقّى رسالة إلكترونية وستظهر الحالة في وحدة التحكّم عند اكتمال عملية المراجعة.
إعادة التوجيه باستخدام ميزة "تقارير تحديد المصدر"
لنفترض أنّ الموقع الإلكتروني "أ" غير مسجَّل ولكنّ الموقع الإلكتروني "ب" مسجَّل. سيرسل "أداة إدارة الطلبات" إشعارات إلى عناوين URL لإعادة التوجيه حتى في حال عدم تسجيلها. نتيجةً لذلك، ستتم إعادة التوجيه من siteA.com إلى siteB.com. ومع ذلك، لن يتم تسجيل المصادر وعوامل التفعيل إلا من تكنولوجيات الإعلان المسجَّلة.
التسجيل في خدمة تجميع البيانات
يُعدّ تسجيل خدمة التجميع جزءًا من عملية تسجيل وحدة التحكّم. يجب أن يتضمّن كل تسجيل في "خدمة التجميع" رقم تعريف حساب AWS أو حساب خدمة Google Cloud الذي سيتم نشر "خدمة التجميع" فيه. تتوفّر لتكنولوجيات الإعلان المرونة في ربط عدة مواقع إلكترونية بحساب واحد، أو ربط حسابات متعددة بموقع إلكتروني واحد لتلبية احتياجات مختلفة متعلقة بالاختبارات والعمليات وكفاءة التكلفة.
تحميل ملف الإقرار
بعد التسجيل في البرنامج واجتياز عملية إثبات الهوية، ستتمكّن من الوصول إلى ملف الإقرار في وحدة التحكّم. ستتوفّر لك فترة تنفيذ تبلغ 30 يومًا من وقت استلام ملف الإقرار، وذلك لوضع ملف الإقرار بشكل نهائي. خلال هذه الفترة، سيظل بإمكانك طلب بيانات من واجهات برمجة التطبيقات لمدة 30 يومًا، ولكن من المتوقّع ألا يتم تسجيلك ما لم تتمكّن من الالتزام بلغة بيان الشهادة خلال فترة التنفيذ التي تبلغ 30 يومًا.
لإكمال عملية التسجيل، عليك إتاحة الملف من مسار .well-known العام على الموقع الإلكتروني الذي تم تسجيله. على سبيل المثال، إذا سجّلت https://example.com، ضَع ملف الشهادة في https://example.com/.well-known/privacy-sandbox-attestations.json. يمكنك أيضًا استخدام عمليات إعادة التوجيه عبر بروتوكول HTTP إلى النطاقات الفرعية لموقعك الإلكتروني المسجَّل فقط لعرض ملف الشهادة.
يجب الالتزام بشهادات الاعتماد والاحتفاظ بملف الشهادة طوال مدة التسجيل. يتم التحقّق من ملفات الشهادة بشكل روتيني، وسيؤدي عدم الاحتفاظ بها في مكانها لفترة طويلة إلى تعذُّر طلبات البيانات من واجهة برمجة التطبيقات إلى أن تتم استعادة الملف.
يُرجى العلم بما يلي:
- ستسترجع "مبادرة حماية الخصوصية" ملف الشهادة من تكنولوجيات الإعلان المسجّلة. لن تُجري هذه المهمة عملية جلب للملف أكثر من مرة في الساعة. لن تؤدي طلبات البيانات من واجهة برمجة التطبيقات إلى بدء طلب استرجاع لملف شهادة الاعتماد.
- من المفترض أن يكون ملف الإقرار متاحًا للجميع. من المفترض أن تتوقّع تقنية الإعلان بعض طلبات الجلب من جهات خارجية، بما في ذلك الباحثون والمشرِفون والمستخدمون (باستثناء طلبات الجلب من بنية "مبادرة حماية الخصوصية"). يجب أن تعرِض تكنولوجيات عرض الإعلانات الملف نفسه الذي تعرِضه على Google.
بالنسبة إلى بيانات اعتماد Topics على Android، على مطوّري التطبيقات وحِزم SDK الموافقة على بيانات الاعتماد ضمن نموذج التسجيل في وحدة التحكّم، ولا يحتاجون إلى وضع ملف بيانات اعتماد على خادمهم ما لم يستخدموا واجهات برمجة تطبيقات أخرى في "مبادرة حماية الخصوصية".
تعديل شهادة الاعتماد لإضافة المزيد من واجهات برمجة التطبيقات
إذا قرّرت تضمين المزيد من واجهات برمجة التطبيقات في تسجيلك في وقت لاحق، عليك تعديل تسجيلك. كجزء من هذه العملية، سيصلك ملف شهادة اعتماد معدَّل يجب توفيره من مسار .well-known على موقعك الإلكتروني، قبل أن تتمكّن من طلب واجهات برمجة التطبيقات الجديدة.
التحديث إلى أحدث إصدار من ملف الإقرار
على جميع الشركات المسجّلة التحديث إلى أحدث إصدار من ملف الإقرار الذي تلقّته من Google.
لا تنتهي صلاحية ملفات الإقرار بعد فترة زمنية محدّدة. قد يتم توفير ملفات شهادات اعتماد جديدة أو معدَّلة من حين لآخر مع تطور إطار عمل الشهادات (على سبيل المثال، تتم إضافة شهادات اعتماد جديدة خاصة بواجهة برمجة التطبيقات).
حالات تعذُّر التحقّق من صحة بيانات الاعتماد
ولن يتم قطع إمكانية الوصول إلا إذا تعذّر على الخادم الذي يفحص ملف الشهادة التحقّق منه بشكل متكرّر. ولن يؤدي خطأ واحد أو مشكلة في العرض إلى تعليق إمكانية الوصول.
لمزيد من التفاصيل، يُرجى الاطّلاع على GitHub حول بيانات الاعتماد.
بيانات مطوّري تطبيقات Android
يمكن للجهات التي تريد استخدام واجهات برمجة تطبيقات إطار عمل "الخصوصية في وضع التخزين المؤقت" على Android الوصول إلى معرّف التسجيل من خلال واجهة مستخدم وحدة التحكّم، ويمكن تضمينه في إعدادات AdServices للتطبيق. يتيح ذلك لمطوّري التطبيقات التحكّم بدقة في تقنيات الإعلان التي يتفاعل معها تطبيقاتهم أو حِزم SDK.