<a name="amp-pixel"></a> `amp-pixel`

[جدول المحتويات]

السلوك

يتصرف مكوِّن amp-pixel كبكسل تتبع بسيط img. يأخذ عنوان URL واحدًا لكنه يوفر متغيرات يمكن استبدالها بالمكوِّن في سلسلة عنوان URL عند إرسال الطلب. راجع قسم الاستبدالات لمعرفة مزيد من التفاصيل.

في هذا المثال الأساسي، يصدر amp-pixel طلب GET بسيطًا إلى عنوان URL المحدد ويتجاهل النتيجة.

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"></amp-pixel>

السمات

src (مطلوبة)

هي عنوان URL بسيط لنقطة نهاية بعيدة والتي يجب أن تتبع البروتوكول https.

referrerpolicy (اختياريّة)

تشبه هذه السمة سمة referrerpolicy على <img> إلا أن no-referrer هي القيمة الوحيدة المقبولة. في حال تحديد referrerpolicy=no-referrer، تتم إزالة الرأس referrer من الطلب HTTP.

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"
    referrerpolicy="no-referrer"></amp-pixel>

allow-ssr-img (اختياريّة)

تشير هذه السمة المستخدَمة في تصميمات إعلانات AMP4ADS إلى أنه في إطار التحويل ما بعد مرحلة التحقق، يمكن وضع عنصر img مباشرة داخل العنصر amp-pixel، ما يسمح بإرسال فحص الاتصال بالتوازي مع جلب/تنفيذ وقت تشغيل AMP. وهو ما يعني عدم توسيع أي وحدات ماكرو داخل عنوان URL لذا استخدَم السمة فقط إذا لم تكن متوفرة في src.

السمات المشتركة

يتضمن هذا العنصر السمات المشتركة التي تشمل مكونات AMP.

الاستبدالات

يسمح amp-pixel بجميع استبدالات متغيرات عناوين URL القياسية. اطّلِع على دليل الاستبدالات للحصول على المزيد من المعلومات.

في المثال التالي، قد يتم إرسال طلب لصفحة مثل https://foo.com/pixel?0.8390278471201 حيث يتم إنشاء قيمة RANDOM بشكل عشوائي عند كل ظهور.

<amp-pixel src="https://foo.com/pixel?RANDOM"
    layout="nodisplay"></amp-pixel>

التصميم

يجب ألا يكون للمكوِّن amp-pixel تصميم.

التحقق

اطِّلع على قواعد amp-pixel في مواصفات مدقق AMP.