Do you build things with AMP? Fill out the AMP Developer Survey!
AMP

تكامل التكنولوجيا الخاص بك مع AMP

نشكرك على الاهتمام بالمساهمة في AMP! نحن نقدر مشاركتك في جعل الويب منصة سهلة للمستخدم.

أنشأ الناشرون أكثر من 1.4 مليار مستند AMP، والتي تجري استضافتها على أكثر من 750 مجال فريد. ولم يكن لهذا النمو أن يتحقق لولا الدعم من أكثر من 100 شركة تكنولوجيا خارجية، تتكامل بالفعل مع AMP.

إذا كنت موفر تكنولوجيا للناشرين أو المعلنين على الويب، فإننا ندعوك لإضافة دعم إلى AMP لكي يتمكن عملاؤك من مواصلة الاستفادة من التكنولوجيا الخاصة بك في حين العمل على تحقيق رؤيتنا ببناء تجربة ويب أفضل.

يوضح هذا المستند توقعات الجهات الخارجية من AMP ويحدد مستويات المساهمة.

إرشادات المساهمة

تخضع جميع المساهمات العامة لـ إرشادات AMPHTML العمومية في CONTRIBUTING.md. نتوقع من الجهة الخارجية بأن تقوم باختبار مساهمتها بدرجات مختلفة والمحافظة عليها وتحديثها.

لكي تتأهل مستويات المساهمة للإدراج، يجب أن تستوفي ما يلي:

يوجد ثلاث مستويات للمساهمة من الجهات الخارجية. وتعتمد المستويات على مقدار المنطق المضاف:

  • منطق المكون: رمز يشير إلى الميزات الرئيسية والوظائف لمكون AMP.
  • منطق الجهة الخارجية: وهو منطق خاص بالجهة الخارجية. ويتيح هذا المنطق للمكون الاستفادة من خدمة الجهة الخارجية.

كلما زاد المنطق المضاف إلى مستودع AMP، خاصة المنطق المتعلق بالجهة الخارجية، زاد مستوى المساهمة. ويتطلب المستوى الأعلى من المساهمة المزيد من الالتزام من الجهة الخارجية.

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

بعد تحديد مستوى المساهمة الذي يلبي حالة الاستخدام الخاصة بك، افتح مشكلة GitHub للبدء.

مساهمة المستوى 1

تستخدم مساهمات المستوى 1 المنطق المميز للمكونات الموجودة. وهي تحمّل المنطق الخاص بالجهة الخارجية كوحدة JavaScript مخصصة عبر iframe الأصلي. على سبيل المثال، توفر العديد من شبكات الإعلانات إعلاناتها عن طريق مكون amp-ad، ولكنها تتحكم في كيفية عرض الإعلانات عن طريق المنطق الخاص بها.

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

المنطق الخاص بالجهة الخارجية الوحيد الذي يتم تسجيله في مستودع AMP هو تكوين الجهة الخارجية. في العادة لا تتطلب إضافة جهة خارجية جديدة إلى مساهمة المستوى 1 تصميم مراجعة. يمكن للجهات الخارجية اتباع مستند التكامل للمكون، مثل تكامل شبكات الإعلانات في AMP.

التوقعات للجهات الخارجية

  • المحافظة على JavaScript مخصص للمورد وتقديمه بشكل مستقل.
  • توفير اختبارات لتكويناتهم والاستجابة للمشكلات.
  • توفير قناة استكشاف الأعطال وإصلاحها للمطورين.
  • الاستجابة لأي وجميع بلاغات الأعطال المتعلقة بخدمتهم.

مثال المستوى 1

amp-ad

يجب أن يقرأ موفرو الإعلانات مراجعة التطوير و تعليمات التطوير لإضافة الدعم الخاص بك لـ amp-ad. وتبعًا لتقنية الإعلانات التي توفرها شركتك، فقد تجد تعليمات التكامل هذه مفيدة.

يوجد الكثير من موفري الإعلانات الذين أضافوا دعمًا لميزات متعلقة بالإعلانات مثل amp-ad. فيما يلي مثال طلب سحب من شبكة الإعلانات Criteo.

مساهمة المستوى 2

تستخدم مساهمات المستوى 2 منطق الميزة للمكونات الموجودة. ويجري تسجيل المنطق بأكمله في مستودع AMP، ولا يمكن تحميل أي Javascript مخصص في إطار iframe. على سبيل المثال، يضيف موفرو التحليلات تكويناتهم إلى مكون amp-analytics لكن مع تضمين نقطة النهاية لتتبع البيانات، مثل عدد مرات النقر من المستخدم.

تضيف الجهات الخارجية تكوينات أو ميزات، مثل واجهات برمجة التطبيقات الجديدة إلى المكونات الموجودة لتنفيذ وظائفها. وإذا كان هذا المكون غير موجود فقد تقترح مكونًا جديدًا

يجري تسجيل منطق الأعمال بالكامل في مستودع AMP، ولكن المنطق الخاص بالجهة الخارجية الذي يتم تسجيله فقط هو تكوين الجهة الخارجية. إذا كان المكون يعمل مع ملف تكوين مقدم من جهة خارجية، فلا يلزم إجراء مراجعة للتصميم. إذا كان تكوين الجهة الخارجية ينفذ ميزة جديدة أو مكونًا جديدًا، فعندئذ يلزم أن يجتاز مراجعة تصميم AMP.

توقعات الجهات الخارجية

  • إضافة خدمة جهة خارجية جديدة إلى مساهمة المستوى 2 في العادة لا يحتاج إلى مراجعة تصميم. يمكن أن تتبع الجهة الخارجية وثائق ذلك المكون.
  • يحتاج اقتراح مكون جديد لمساهمة المستوى 2 إلى منطق ميزة قابل للمشاركة من جانب خدمات الجهة الخارجية الأخرى.

أمثلة المستوى 2

amp-analytics

تسمح لك تحليلات AMP بإرسال الأحداث مرة أخرى إلى الخادم استنادًا إلى المشغلات التي كونتها. قمنا بتأليف دليل تكامل التحليلات لتمكينك من الشروع في العمل.

إذا كنت تريد فقط إضافة بكسل تتبع مع معلمات ديناميكية إلى عنوان URL للتتبع الخاص بك، فافحص amp-pixel. تأكد من توثيق الاستخدام على صفحات الدعم الخاصة بك للمطورين الذين قد يحتاجون إلى استخدام التكنولوجيا الخاصة بك مع AMP.

يوجد موفرو تحليلات قاموا بإضافة دعم لـ amp-analytics. فيما يلي مثال لطلب سحب من موفر التحليلات Parse.ly.

amp-call-tracking

إذا كنت توفر خدمات قياس تتبع الاستدعاء، فيمكن دعم حالة الاستخدام الخاصة بك من خلال amp-call-tracking. يقوم هذا المكون ديناميكيًا باستبدال رقم هاتف بارتباط تشعبي لتمكين تتبع الاستدعاء، من خلال تنفيذ طلب CORS لاستبدال الرقم.

لمعرفة المزيد حول كيف يعمل هذا المكون، يرجى مراجعة المستندات المرجعية.

مساهمة المستوى 3

تقدم مساهمة المستوى 3 مكونًا جديدًا خاصًا بالجهة الخارجية. وهذا ينطبق فقط إذا كانت الجهات الخارجية غير قادرة على:

  • العثور على مكون موجود لحالة الاستخدام الخاصة بهم.
  • طلب تحسينات الميزة لتلبية حالة الاستخدام الخاصة بهم.
  • اقتراح مكون ينطبق على خدمات الجهة الخارجية الأخرى.

توقعات الجهات الخارجية

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