عرض إعلان

عندما يعرض مزاد Protected Audience API أحد الإعلانات المرشّحة، يمكن أن يكون يتم عرضه على شكل رقم URN مبهم، يُستخدَم لعرض إعلان في iframe FencedFrameConfig الذي يُستخدَم لعرض الإعلان في إطار محاط بسياج

سيشرح هذا الدليل ماهية الإطار المحاط بسور وسبب الحاجة إليه، بالإضافة إلى كيفية عرض إعلان بأي من الطريقتين. لإلقاء نظرة أكثر تفصيلاً على التفاصيل الإطارات، يمكنك العثور على مزيد من المعلومات في هذا الدليل أو في الاقتراح.

ما هي الإطارات المسوّرة؟

الإطار المحاط (<fencedframe>) هو عنصر HTML للمحتوى المضمّن، تشبه iframe. على عكس iframe، يحدّ الإطار المحميّ من الاتصال بين الأجهزة. مع سياق التضمين للسماح بوصول الإطار إلى بيانات مواقع إلكترونية متعددة بدون مشاركته مع سياق التضمين. وبالمثل، فإنّ أي بيانات طرف أول في لا يمكن مشاركة سياق التضمين مع الإطار المحاط بحدود.

على سبيل المثال، لنفترض أن news.example (سياق التضمين) يتضمن إعلانًا من shoes.example في إطار مسيّج. لا يمكن لـ news.example استخراج البيانات من وshoes.example في الإعلان، ولا يمكن لـ shoes.example معرفة بيانات الطرف الأول من news.example

كيف تعمل الإطارات المحمية؟

تستخدِم الإطارات المحمية العنصر FencedFrameConfig للتنقّل. يمكن لهذا الكائن من مزاد يستخدم Protected Audience API وبعد ذلك، يتم تعيين كائن التهيئة على أنه السمة config على عنصر الإطار المحمي. يختلف هذا عن iframe يتم فيه تعيين عنوان URL أو رقم URN غير شفاف للسمة src. تشير رسالة الأشكال البيانية يحتوي الكائن FencedFrameConfig على السمة url للقراءة فقط. ومع ذلك، نظرًا لأن تتطلب حالات الاستخدام الحالية إخفاء عنوان URL الفعلي للمورد الداخلي، تُرجع هذه الخاصية قيمة السلسلة المعتمة عند قراءتها.

لا يمكن للإطار المحاط بسور استخدام postMessage للتواصل مع أداة التضمين. ومع ذلك، يمكن أن يستخدم إطار محاط بسور postMessage مع iframe داخل العنصر. محددة.

سيتم عزل الإطارات المحظورة عن الناشر بطرق أخرى. الناشر لن يتمكن من الوصول إلى نموذج العناصر في المستند (DOM) داخل إطار محاط بسياج، وسيعرض الإطار لا يمكن الوصول إلى DOM الخاص بالناشر. علاوةً على ذلك، يمكن استخدام سمات مثل name يتم ضبطها على أي قيمة ويراقبها الناشر، ولا تتوفر في الإطارات.

تعمل الإطارات الخاضعة لقيود مثل سياق تصفّح المستوى الأعلى (مثل المتصفح) ). على الرغم من أنّ إطارًا مسوّرًا في حالات استخدام معيّنة (مثل opaque-ads) يمكن أن يتضمّن بيانات من مواقع إلكترونية متعددة (مثل مجموعة الاهتمامات في Protected Audience API) لا يمكن للإطار الوصول إلى وحدة تخزين غير مقسَّمة أو ملفات تعريف الارتباط. opaque-ads مسيّج إمكانية الوصول إلى قسم فريد لملف تعريف الارتباط والتخزين غير المستند إلى ملفات تعريف الارتباط.

ويمكن الحصول على مزيد من التفاصيل حول خصائص الإطارات المحاطة بسور في الموضح.

عرض إعلان في إطار محاط بحدود

يتم إرجاع FencedFrameConfig من مزاد Protected Audience API، شريطة أنّه تم ضبط مَعلمة resolveToConfig في AuctionConfig على "صحيح":

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true
});

بعد حصولك على الإعدادات، يمكنك تعيينها إلى config لإطار محاط بحدود. للانتقال بين الإطار إلى المورد الذي تمثله الإعدادات. لا تتوافق الإصدارات السابقة من Chrome مع السمة resolveToConfig، لذلك يمكنك يتعين عليه تأكيد أنه تم الوعد بـ FencedFrameConfig قبل التنقل:

if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
  const frame = document.createElement('fencedframe');
  frame.config = frameConfig;
}

عرض إعلان في إطار iframe

إذا لم تضبط السمة AuctionConfig السمة resolveToConfig بشكل صريح أو إذا تم ضبطها إلى خطأ، تعرض runAdAuction() رقم URN غير شفاف. يمكن تعيين رقم URN هذا src الخاصة بـ iframe لعرض الإعلان.