Mengintegrasikan teknologi Anda dengan AMP
Terima kasih atas minat Anda dalam berkontribusi untuk AMP! Kami menghargai partisipasi Anda untuk menjadikan web sebagai platform forward pengguna.
Penayang telah membuat lebih dari 1,4 miliar dokumen AMP yang dihosting di lebih dari 750 ribu domain berbeda. Pertumbuhan ini tidak mungkin terjadi tanpa adanya dukungan yang kuat dari 100 lebih perusahaan teknologi pihak ketiga, yang telah berintegrasi dengan AMP.
Jika Anda adalah penyedia teknologi bagi penayang atau pengiklan di web, kami mengundang Anda untuk menambahkan dukungan ke AMP, sehingga pelanggan dapat terus memanfaatkan teknologi Anda dan mencapai visi bersama kami untuk membuat web yang lebih baik.
Dokumen ini menguraikan ekspektasi pihak ketiga AMP dan menentukan tingkat kontribusi.
Panduan berkontribusi
Semua kontribusi umum tunduk terhadap panduan universal HTML AMP di CONTRIBUTING.md. Kami mengharapkan pihak ketiga untuk menguji, memelihara, dan memperbarui kontribusinya ke berbagai tingkatan.
Agar memenuhi syarat untuk dimasukkan, semua tingkat kontribusi harus:
- Memenuhi persyaratan kelayakan Wikipedia bahasa Inggris.
- Mempertahankan atau meningkatkan jenis tingkat layanan yang sama seperti yang dijanjikan AMP untuk penayang dan pengguna.
- Dibuat dengan kualitas yang baik.
- Membuat saluran pemecahan masalah untuk pelanggan mereka.
- Memberikan cakupan pengujian integrasi yang baik terhadap produksi AMP dan rilis kenari.
- Memenuhi tujuan yang belum ada.
Ada 3 tingkat kontribusi pihak ketiga. Tingkatan bergantung pada jumlah logika yang ditambahkan:
- Logika komponen: Kode yang menentukan fitur inti dan fungsi komponen AMP.
- Logika pihak ketiga: Kode yang dikhususkan untuk pihak ketiga. Logika ini memungkinkan komponen untuk memanfaatkan layanan pihak ketiga.
Semakin banyak logika yang ditambahkan ke repositori AMP, terutama logika khusus pihak ketiga, semakin meningkatkan tingkat kontribusi. Tingkat kontribusi yang tinggi membutuhkan lebih banyak komitmen dari pihak ketiga.
Kontribusi tingkat 1 dan tingkat 2 berbagi komponen antara pihak ketiga. Jika ada komponen yang memenuhi tujuan yang mirip dengan bisnis Anda, pertimbangkan untuk menggunakan kembali komponen tersebut. Ini membutuhkan lebih sedikit usaha dan lebih dapat dipelihara dalam jangka panjang.
Setelah memutuskan tingkat kontribusi yang sesuai dengan contoh penggunaan Anda, buka masalah GitHub untuk memulai.
Kontribusi tingkat 1
Ekstensi amp-ad digunakan untuk menayangkan iklan Display di halaman AMP. Lebih dari 90 penyedia teknologi iklan telah menambahkan dukungan ke AMP. Untuk memulai, baca ringkasan pengembangan atau lihat bagian petunjuk developer untuk menambahkan dukungan Anda ke ekstensi amp-ad. Bergantung pada teknologi iklan yang disediakan oleh perusahaan Anda, petunjuk integrasi ini mungkin berguna.
Ada lebih dari 90 penyedia iklan yang telah menambahkan dukungan untuk fitur yang berkaitan dengan iklan seperti amp-ad . Berikut adalah contoh pull request dari jaringan iklan Criteo.
Satu-satunya logika yang spesifik untuk pihak ketiga yang masuk ke dalam repositori AMP adalah konfigurasi pihak ketiga. Menambahkan pihak ketiga baru ke kontribusi tingkat 1 yang sudah ada biasanya tidak memerlukan tinjauan desain. Pihak ketiga dapat mengikuti dokumentasi integrasi komponen, seperti Mengintegrasikan jaringan iklan ke dalam AMP.
Harapan untuk pihak ketiga
- Memelihara dan menyajikan JavaScript kustom vendor secara mandiri.
- Memberikan pengujian untuk konfigurasinya dan menanggapi masalah.
- Menyediakan saluran pemecahan masalah untuk pengembang.
- Menanggapi setiap dan semua pengajuan atau laporan bug yang terkait dengan layanan mereka.
Contoh tingkat 1
Penayang iklan harus membaca gambaran umum pengembangan dan petunjuk pengembang untuk menambahkan dukungan Anda ke amp-ad. Bergantung pada teknologi iklan yang disediakan perusahaan Anda, petunjuk integrasi ini mungkin berguna bagi Anda.
Banyak penyedia iklan yang telah menambahkan dukungan untuk fitur terkait periklanan, seperti amp-ad. Berikut ini contoh permintaan perubahan dari jaringan iklan Criteo.
Kontribusi tingkat 2
Kontribusi tingkat 2 memanfaatkan logika fitur dari komponen yang sudah ada. Semua logika dimasukkan ke dalam repositori AMP, dan tidak ada Javascript kustom yang dapat dimuat ke dalam iframe. Contohnya: penyedia analitik menambahkan konfigurasi mereka ke komponen amp-analytics, tetapi menyertakan endpoint untuk melacak data, seperti jumlah klik pengguna.
Pihak ketiga menambahkan konfigurasi atau fitur, seperti API baru, ke komponen yang sudah ada untuk menerapkan fungsinya. Jika komponen seperti itu tidak ada, mereka dapat mengusulkan yang baru.
Semua logika bisnis dimasukkan ke dalam repositori AMP, tetapi satu-satunya logika yang spesifik untuk pihak ketiga yang dimasukkan adalah konfigurasi pihak ketiga. Jika komponen berfungsi dengan berkas konfigurasi yang disediakan pihak ketiga, tidak diperlukan tinjauan desain. Jika konfigurasi pihak ketiga menerapkan fitur baru atau komponen baru, maka konfigurasi tersebut harus lulus tinjauan desain AMP.
Harapan pihak ketiga
- Menambahkan layanan pihak ketiga yang baru ke kontribusi tingkat 2 yang sudah ada biasanya tidak memerlukan tinjauan desain. Pihak ketiga dapat mengikuti dokumentasi komponen itu.
- Mengusulkan komponen baru untuk kontribusi tingkat 2 harus memiliki logika fitur yang dapat dibagikan oleh layanan pihak ketiga lainnya.
Contoh tingkat 2
Analitik AMP memungkinkan Anda mengirimkan peristiwa kembali ke server berdasarkan pemicu yang Anda konfigurasi. Kami telah menulis panduan integrasi analitik untuk membantu Anda memulai.
Jika Anda hanya perlu menambahkan piksel pelacakan dengan parameter dinamis ke URL pelacakan Anda, coba amp-pixel. Pastikan untuk mendokumentasikan penggunaan di halaman dukungan Anda untuk pengembang yang mungkin ingin menggunakan teknologi Anda dengan AMP.
Ada penyedia analitik yang telah menambahkan dukungan ke amp-analytics. Berikut ini sampel permintaan perubahan dari penyedia analitik Parse.ly.
Jika Anda menyediakan layanan pengukuran pelacakan panggilan, kasus atau contoh penggunaan Anda mungkin didukung dengan amp-call-tracking. Komponen ini secara dinamis menggantikan nomor telepon di hipertaut (hyperlink) untuk mengaktifkan pelacakan panggilan, dengan menjalankan permintaan CORS untuk mengganti nomor tersebut.
Untuk mempelajari lebih lanjut tentang bagaimana komponen ini dapat berfungsi untuk Anda, silakan kunjungi dokumentasi referensi.
Kontribusi tingkat 3
Kontribusi tingkat 3 memperkenalkan komponen yang spesifik untuk pihak ketiga yang baru. Ini hanya berlaku jika pihak ketiga tidak dapat:
- Menemukan komponen yang sudah ada untuk kasus atau contoh penggunaannya.
- Meminta peningkatan fitur untuk memenuhi kasus atau contoh penggunaannya.
- Mengusulkan komponen yang berlaku pada layanan pihak ketiga lainnya.
Harapan pihak ketiga
- Menulis dan mengusulkan tinjauan desain.
- Pengujian harus bisa menemukan kerusakan.
- Memperbaiki, atau meminta bantuan, jika komponen rusak.
- Menyediakan melalui dokumentasi dengan sampel kode.
- Memelihara dan memperbarui dokumentasi.
- Menyediakan saluran pemecahan masalah bagi pengembang AMP untuk meminta bantuan.