AMP

amp-pixel

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

الوصف مكوِّن يمكن استخدامه كبكسل تتبع نموذجي لحساب مرات مشاهدة الصفحة.
التنسيقات المعتمدة fixed وnodisplay
أمثلة يمكن الاطّلاع على مثال amp-pixel في الموقع "AMP بالمثال".

السلوك

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

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

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

عند معالجة عناوين AMP URL في الرأس المُحيل لطلبات التحليلات، أزِل المعلَمة usqp أو تجاهلها. يستخدم Google هذه المعلَمة لتشغيل تجارب "لذاكرة التخزين المؤقت لصفحات AMP من Google".

السمات

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.

Need more help?

You've read this document a dozen times but it doesn't really cover all of your questions? Maybe other people felt the same: reach out to them on Stack Overflow.

Go to Stack Overflow
Found a bug or missing a feature?

The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.

Go to GitHub