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