تفويض إدارة الجمهور إلى جهة خارجية

اطّلِع على كيفية التحكّم في إدارة شرائح الجمهور باستخدام سياسة الأذونات أو التفويض لجهة خارجية من خلال ضبط عنوان URL لأذونات .well-known.

يجب أن يتطابق أصل سياق استدعاء joinAdInterestGroup() مع مصدر مالك مجموعة الاهتمامات، لذلك يجب طلب joinAdInterestGroup() من إطار iframe (على سبيل المثال، من وسيط عرض الطلب) ما لم يتطابق أصل مالك مجموعة الاهتمامات مع مصدر المستند الحالي (على سبيل المثال، موقع إلكتروني يضم مجموعات اهتمامات خاصة به).

يتطلّب تطبيق "joinAdInterestGroup()" إذنًا من:

وهذا يعني أنه لا يمكن لـ "malicious.example" استدعاء joinAdInterestGroup() لمجموعة اهتمامات مملوكة من قِبل "dsp.example.com"، بدون منح "dsp.example.com" الإذن.

إذن من الموقع الإلكتروني الذي تمت زيارته

ويمكن منح الإذن من المصدر نفسه أو من مصدر آخر.

يتم تلقائيًا منح الإذن لمكالمات joinAdInterestGroup() من المصدر نفسه الذي تمت زيارته من الموقع الإلكتروني، (بمعنى آخر، من المصدر نفسه لإطار المستوى الأعلى للصفحة الحالية). يمكن للمواقع الإلكترونية استخدام عنوان سياسة الأذونات join-ad-interest-group لإيقاف مكالمات joinAdInterestGroup().

لا يمكن طلب joinAdInterestGroup() من مصادر متعددة (أي أصول مختلفة عن الصفحة الحالية) إلا إذا ضبط الموقع الإلكتروني الذي تتم زيارته سياسة أذونات تسمح بالمكالمات إلى joinAdInterestGroup() من إطارات iframe من مصادر متعددة.

إذن من مالك مجموعة الاهتمامات

يتم منح إذن مالك مجموعة الاهتمامات بشكل ضمني من خلال طلب joinAdInterestGroup() من إطار iframe من المصدر نفسه المصدر لمالك مجموعة الاهتمامات. على سبيل المثال، يمكن أن يستدعي إطار iframe dsp.example.com للسمة joinAdInterestGroup() لمجموعات الاهتمامات التي يملكها dsp.example.com.

في الواقع، يمكن تشغيل joinAdInterestGroup() في صفحة أو إطار iframe على نطاق المالك، أو يمكن تفويضه إلى نطاقات أخرى مقدَّمة باستخدام قائمة على عنوان URL لـ .well-known.

عند انتقال إطار إلى نطاق معيّن من خلال استدعاء joinAdInterestGroup() أو leaveAdInterestGroup() أو clearOriginJoinedAdInterestGroups() لمجموعة اهتمامات لها مالك مختلف، سيجلب المتصفّح عنوان URL https://owner.domain/.well-known/interest-group/permissions/?origin=frame.origin، حيث يمثّل owner.domain النطاق الذي يملك مجموعة الاهتمامات ويمثّل frame.origin مصدر الإطار. يستخدم الاسترجاع وضع حذف بيانات الاعتماد، باستخدام مفتاح قسم الشبكة للإطار الذي استدعى الطريقة. لتجنُّب تسريب البيانات من مصادر متعددة عبر Promise الذي تم عرضه بشكل غير متوقّع، يستخدم الجلب وضع النقاط. يجب أن يكون الردّ الذي تم استرجاعه من نوع JSON MIME وأن يكون بالتنسيق:

{ "joinAdInterestGroup": true/false,
  "leaveAdInterestGroup": true/false
}

الإشارة إلى ما إذا كان المصدر في المسار يمتلك الأذونات للانضمام إلى مجموعات الاهتمامات التي يملكها النطاق الذي يتم إرسال الطلب إليه أو مغادرة المجموعات ذات الاهتمامات المشتركة يُفترض أن تكون الأذونات المفقودة false. بما أنّ استدعاء navigator.joinAdInterestGroup() باستخدام lifetimeMs من 0 يؤدي إلى مغادرة مجموعة اهتمامات، يسمح joinAdInterestGroup: true أيضًا للمصدر باستدعاء navigator.leaveAdInterestGroup()، حتى إذا كان leaveadInterestGroup غير متوفّر أو تم ضبطه على false. يُرجى العِلم أنّ كلاً من leaveAdInterestGroup() وclearOriginJoinedAdInterestGroups() يتحقّق من إذن leaveAdInterestGroup.