للوصول إلى واجهات برمجة التطبيقات ذات الصلة بالقياس والصلة بـ "مبادرة حماية الخصوصية" على Chrome وAndroid، على المطوّرين التسجيل في "مبادرة حماية الخصوصية". ويشمل ذلك تقارير تحديد المصدر والجمهور المحمي والمواضيع والتجميع الخاص ومساحة التخزين المشتركة. توفّر عملية تسجيل المطوّرين آلية للتحقّق من الكيانات التي تستدعي واجهات برمجة التطبيقات هذه، وجمع البيانات الخاصة بالمطوّر اللازمة لضبط واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" واستخدامها بشكلٍ صحيح. تضيف عملية التسجيل هذه طبقة إضافية من الحماية إلى جانب القيود الهيكلية المفروضة على كل واجهة برمجة تطبيقات، وذلك من خلال إضافة شفافية إلى الجهة التي تجمع البيانات والحد من محاولات إساءة استخدام واجهات برمجة التطبيقات لجمع بيانات أكثر من المطلوب. لتوفير شفافية يمكن التدقيق فيها، سيتم نشر معلومات التسجيل عن الشركة بشكل علني. على الشركات التخطيط لمدة خمسة أسابيع على الأقل لإكمال عملية التسجيل، وذلك من وقت إرسال نموذج التسجيل. ويشمل ذلك الوقت اللازم لمعالجة أي مشاكل في إرسال النموذج أو أي مشاكل أخرى قد تنشأ. ولا يشمل ذلك أيّ وقت إضافي قد تحتاجه الشركات للتحضير الداخلي قبل إرسال النموذج.
قبل البدء
قبل بدء عملية التسجيل، تأكَّد من توفُّر رقم D-U-N-S لمؤسستك. هذا رقم فريد مكوَّن من تسعة أرقام تقدّمه شركة Dun & Bradstreet ويُستخدَم لتحديد هوية نشاطك التجاري، ويتم التحقّق منه كجزء من عملية إثبات التسجيل في إطار "مبادرة حماية الخصوصية". إذا تم إصدار عدة أرقام نظام ترقيم البيانات العالمي (DUNS) لشركتك، قدِّم رقم المستوى الأعلى الذي يمثّل كيان مؤسستك بشكل عام. إذا لم يكن نشاطك التجاري كيانًا قانونيًا، لن تتمكّن من الحصول على رقم D-U-N-S.
للتحقّق مما إذا كانت شركتك تمتلك رقم D-U-N-S مخصّصًا لها أو للحصول على رقم D-U-N-S جديد، يُرجى تقديم طلب باستخدام نموذج التسجيل. توفّر Google عملية طلب مجانية ومُسرَّعة من شركة Dun & Bradstreet لهذا الغرض. بعد تقديم الطلب، سنرسل إليك رسالة إلكترونية تتضمّن رابطًا فريدًا صالحًا لمرة واحدة فقط للانتقال إلى الصفحة المقصودة الخاصة بـ Google وإرسال تفاصيل نشاطك التجاري. إذا لم تُكمِل إرسال معلوماتك، عليك طلب رابط آخر من Google.
الحصول على رقم D-U-N-S بصفتك فردًا
إذا كنت فردًا غير تابع لمؤسسة أو إذا تعذّر على مؤسستك الحصول على رقم D-U-N-S، يمكنك التسجيل كفرد في نموذج التسجيل. قد يتم تضمين جميع المعلومات (باستثناء معلومات تحديد الهوية الشخصية) التي يتم جمعها أثناء تسجيل المطوّرين في تقارير "مبادرة حماية الخصوصية". ستكون هذه التقارير متاحة للجميع.
كيفية التسجيل
للتسجيل، على المطوّرين إكمال نموذج التسجيل. يطلب النموذج المعلومات التالية:
- معلومات الاتصال بالنشاط التجاري
- رقم D-U-N-S لمؤسستك
- واجهات برمجة التطبيقات التي تخطّط لاستخدامها ومعلومات ضبط واجهات برمجة التطبيقات
على المطوّرين أيضًا الموافقة على شهادات حول استخدامهم لواجهات برمجة تطبيقات Privacy Sandbox المسجّلة.
تسجيل موقعك الإلكتروني أو حزمة تطوير البرامج (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 ومزيد من المعلومات حول مفاتيح التوقيع في ميزة جمهور محمي
تعديل معلومات التسجيل
يمكنك تعديل معلومات التسجيل باستخدام نموذج التسجيل. ستحلّ التعديلات محلّ الردود السابقة.
المخطط الزمني للتسجيل
بعد إرسال نموذج التسجيل، سنراجع طلبك وسنعالجه. بعد اكتمال عملية المراجعة، ستصلك رسالة تأكيد إلكترونية تتضمّن رقم تعريف فريدًا لحساب المطوِّر المُدرَج وملف الإقرار. يجب إتاحة الملف للجميع من المسار /.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 واحدة، يُرجى ملء نموذج عملية طلب التسجيل المتعدّد بالإضافة إلى إرسال نموذج التسجيل العادي لأول عملية تسجيل تطلبها. بعد إرسال الطلب، ستتم مراجعته وستتلقّى رسالة إلكترونية عند اكتمال عملية المراجعة.
إرسال عمليات تسجيل متعددة باستخدام رقم D-U-N-S نفسه
إذا كنت تتقدم بطلبات لعمليات تسجيل متعددة باستخدام نموذج "عملية طلب التسجيل المتعدد"، يمكنك استخدام رقم D-U-N-S نفسه في كل عملية تسجيل.
إعادة التوجيه باستخدام ميزة "تقارير تحديد المصدر"
لنفترض أنّ الموقع الإلكتروني "أ" غير مسجَّل ولكنّ الموقع الإلكتروني "ب" مسجَّل. سيرسل "أداة إدارة الطلبات" إشعارات إلى عناوين URL لإعادة التوجيه حتى في حال عدم تسجيلها. نتيجةً لذلك، ستتم إعادة التوجيه من siteA.com إلى siteB.com. ومع ذلك، لن يتم تسجيل المصادر وعوامل التفعيل إلا من تكنولوجيات الإعلان المسجَّلة.
التسجيل في خدمة تجميع البيانات
تتوفّر حاليًا عملية تسجيل منفصلة لعناصر الخادم وواجهات برمجة التطبيقات الخاصة بالعملاء (لنظامَي التشغيل Chrome وAndroid). يجب ملء نموذجَي التسجيل لاستخدام "خدمة التجميع". نحن نسعى إلى تبسيط العمليات. في الوقت الحالي، تتوفّر خدمة تجميع منفصلة. أثناء التسجيل في "خدمة التجميع"، عليك التسجيل باستخدام موقع إلكتروني يجب أن يكون هو الموقع الإلكتروني نفسه (المخطّط، النطاق في المستوى الأعلى مسبوقًا باسم) المسجّل من خلال عملية تسجيل المطوّر.
يجب أن يتضمّن كل تسجيل في "خدمة التجميع" رقم تعريف حساب AWS أو حساب خدمة Google Cloud Platform الذي سيتم نشر "خدمة التجميع" فيه. تتيح تكنولوجيات الإعلان المرونة في ربط مواقع إلكترونية متعددة بحساب واحد، أو حسابات متعددة بموقع إلكتروني واحد لتلبية احتياجات الاختبار والعمليات وكفاءة التكلفة المختلفة.
تحميل ملف الإقرار
بعد التسجيل في عملية إثبات الهوية واجتيازها، سنرسل ملفًا يحتوي على شهادات اعتماد خاصة بواجهة برمجة التطبيقات إلى عنوان البريد الإلكتروني الذي قدّمته. ستتوفّر لك فترة تنفيذ مدتها 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.