AMP

Important: this documentation is not applicable to your currently selected format email!

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

Description

A tracking pixel to count page views.

 

Supported Layouts

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

الوصف مكوِّن يمكن استخدامه كبكسل تتبع نموذجي لحساب مرات مشاهدة الصفحة.
التنسيقات المعتمدة 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.

هل تحتاج إلى مزيد من المساعدة؟

لقد قرأت هذا المستند عشرات المرات ولكن ألم يُجِب عن جميع أسئلتك؟ ربما حصل ذات الأمر مع أشخاص آخرين: تواصل معهم على Stack Overflow.

الذهاب إلى Stack Overflow
هل وجدت خطأ أو تفتقد لميزة؟

يشجع مشروع AMP مشاركتك ومساهمتك بشدة! ونأمل أن تكون مشاركًا دائمًا في مجتمعنا مفتوح المصدر، ولكننا نشجع أيضًا المساهمات التي تحدث لمرة واحدة في الأمور التي تتحمس لها.

الانتقال إلى GitHub