Spesifikasi konten umpan di Hub Mitra MSN dirancang untuk memastikan bahwa konten dari mitra diselamatkan, divalidasi, dan diterbitkan secara efisien dan akurat. Spesifikasi ini mencakup berbagai aspek manajemen konten, termasuk tipe konten yang didukung, format, aturan metadata, dan panduan untuk menjaga kesehatan dan keandalan umpan.
MSN mendukung:
-
Artikel, Galeri, dan Video
-
Sumber umpan HTTPS. Menggunakan TLS/SSL sangat disarankan.
MSN tidak mendukung:
-
Tautan yang berisi nama pengguna atau kata sandi dalam sumber daya atau parameter
-
Daftar ip
-
IP statis
Di artikel ini
Artikel
Artikel adalah postingan yang terdiri dari teks, gambar, dan video. Artikel tidak diharuskan untuk memiliki gambar, tetapi hanya artikel yang menyertakan gambar yang dapat diterbitkan secara otomatis.
Galeri
Galeri adalah peragaan slide yang terdiri dari gambar dan keterangan. Galeri harus memiliki gambar yang disematkan untuk diterbitkan.
Video
Video dapat diposting sendiri atau disertakan dalam artikel. Postingan video yang disematkan dari umpan Anda akan dihosting ulang di MSN, sementara video yang dihosting di situs pihak ketiga seperti YouTube atau DailyMotion akan disematkan melalui hosting situs tersebut.
Video yang dihosting di MSN akan menghasilkan beberapa bitrate untuk streaming adaptif dan transcoding multi-perangkat.
Format wadah video yang didukung
AVI, MPEG, MP4, WMV, M4V
Codec video yang didukung
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Format audio yang didukung
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protokol yang didukung
HTTP, FTP
Ekstensi file yang didukung
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Ukuran video
Video disarankan setidaknya 720p, 3Mbps. Ukuran file video maksimum adalah 2GB. File besar, seperti video 4K dan video yang lebih panjang, mungkin gagal diserap.
Catatan:Â Peningkatan tidak didukung, sehingga kualitas file video yang tinggi disarankan.
Gambar
Gambar tidak dapat diposting sendiri. Artikel harus disematkan ke dalam artikel atau galeri atau dilampirkan ke postingan video sebagai gambar mini.
Format gambar yang didukung
WebP, PNG, JPG, GIF
Catatan:Â GIF tidak dapat digunakan sebagai gambar mini. Penggunaannya dalam konten utama tidak disarankan karena kualitas yang terbatas.
Ukuran gambar
Gambar dalam konten
Disarankan agar gambar memiliki tinggi atau lebar minimal 720px. Ukuran file gambar maksimum adalah 15MB. Gambar dapat berupa rasio aspek apa pun tetapi mungkin tidak ditampilkan dengan benar jika rasio kurang dari .5 atau lebih besar dari 1,89.
Gambar mini
Gambar mini adalah gambar utama yang menyertai judul konten.Â
-
Ukuran gambar yang disarankan adalah 1200x624px, dengan DPI minimum 72.
-
Rasio aspek gambar yang diinginkan adalah 1,91:1
-
Ukuran file maksimum harus 2MB
Media sosial
MSN mendukung semat dari:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Berkembang
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN menyarankan penggunaan kode semat default yang disediakan oleh situs sumber. Klik di siniuntuk melihat contoh kode semat untuk situs media sosial umum.
Aturan metadata umpan
-
Publisher harus memiliki hak distribusi untuk semua konten di dalam umpan. Jika penerbit tidak memiliki hak untuk menyindikasikan beberapa gambar, mereka HARUS mengatur "HasSyndicationRights" ke false.
-
Semua umpan harus segar dan diperbarui secara teratur sebelum diluncurkan.
-
Pemetaan kustom tidak didukung, semua bidang harus ditentukan sesuai contoh tertentu.
-
Titik akhir mitra harus statis/tidak berubah ketika tidak ada persyaratan untuk menyusun nilai dinamis apa pun seperti segmen rute, nilai string kueri, dan nilai header permintaan HTTP.
-
Semua item dalam umpan harus berada dalam satu bahasa yang sama yang dikonfigurasi untuk umpan.
-
Pengodean adalah UTF-8 secara default kecuali ditentukan lain dalam tag xml. Umpan dengan campuran atau pengodean akan gagal dicerna.
-
Umpan tidak boleh berisi karakter ilegal yang tidak dilepas seperti "&", "<", ">", tanda kutip ganda, dan tanda kutip tunggal. Item dengan karakter kontrol akan gagal dicerna.
-
Microsoft dapat melucuti tautan apa pun yang bersifat promosi.
-
Email orang kontak Publisher harus disimpan saat merek penerbit ditumpangi untuk digunakan untuk memberi tahu penerbit konten tentang masalah situs langsung seperti umpan lama.
Deteksi perubahan umpan
MSN menyimpan sumber daya selama penyerapan dengan hanya memproses umpan yang memiliki konten baru atau yang diperbarui. Perubahan dapat ditandai dengan dua cara:
HTTP ETags
Penerbit bisa mengirim permintaan dengan header ETag, yang bertindak seperti checksum untuk konten umpan. Tag akan disinggahkan dan dikirim kembali di header If-None-Match saat meminta umpan.
Terakhir diubah
Konten yang dikirim dengan header Terakhir Diubah akan disinggahkan, dengan permintaan selanjutnya menerima header If-Modified-Since . Server umpan akan merespons dengan kode status 304 jika tidak ada perubahan yang dibuat sejak tanggal terakhir diubah.
Autentikasi umpan
Autentikasi umpan tidak diperlukan. Penerbit dapat menyelami konten dengan tidak lebih dari URL sumber umpan jika menginginkannya, tetapi MSN juga mendukung Autentikasi dasar dan OAuth 2.0. Klik di sini untuk melihat bagan yang menjelaskan proses penyerapan umpan.
Autentikasi dasar
MSN mendukung autentikasi dasar seperti yang ditentukan dalam RFC 7517. Untuk menambahkan autentikasi dasar ke umpan Anda, sediakan:
-
Nama Pengguna
-
Kata sandi
-
URL Umpan Aman
OAuth 2.0
Untuk menambahkan autentikasi OAuth 2.0 ke umpan Anda, sediakan:
-
URL Server Token Keamanan
-
Client_ID
-
Grant_Type
-
Lingkup (Opsional, digunakan untuk menunjukkan tingkat akses. Nilai ini akan dikirim sebagaimana adanya.)
-
URL Umpan Aman
Pengodean dokumen
MSN menggunakan pengodean UTF-8 secara default. Anda dapat menimpanya dengan mengubah atribut pengodean simpul prolog menjadi nilai pengodean yang valid.
Format umpan yang didukung
MSN mendukung RSS, ATOM, dan beberapa subset RSS Media, Dublin Core, dan ruang nama lain yang dirinci dalam RSS Media.
Umpan besar
MSN menyarankan untuk mempertahankan ukuran umpan kurang dari 30 item segar sepanjang waktu, tetapi Anda dapat menggunakan fitur halaman Umpan ATOM untuk mengaktifkan penyerapan jendela geser umpan Anda.
Batasan dan penanganan kesalahan
Ukuran umpan maksimum adalah 10MB dan ukuran gambar maksimum adalah 14MB. MSN secara otomatis memicu eskalasi jika konten yang dicerna berumur lebih dari tiga hari. Jika Anda memiliki persyaratan usia konten yang berbeda, hubungi kami di PartnerHubSupport@microsoft.com. MSN mencoba kembali umpan yang memiliki kesalahan, tetapi jika kesalahan tetap ada, Anda akan diberi tahu untuk menyelidikinya. MSN secara otomatis menonaktifkan penyerapan konten dari umpan yang tetap berada dalam status kesalahan untuk jangka waktu yang lama.
Memperluas umpan dengan ruang nama
Anda dapat memperluas kosakata umpan dan istilah dalam umpan berbasis XML beserta prefiks yang disarankan. MSN hanya mengenali elemen dan atribut yang ditentukan secara eksplisit dalam contoh kode yang tercantum. Ruang nama apa pun yang tidak didukung akan diabaikan.
|
Nama Ekstensi |
Prefiks |
Kumpulan nama |
|---|---|---|
|
Media RSS |
media |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
arus searah |
http://purl.org/dc/elements/1.1/ |
|
Ketentuan Dublin Core |
dcterms |
http://purl.org/dc/terms/ |
|
Layanan Penyerapan Microsoft Milik |
mi |
http://schemas.ingestion.microsoft.com/common/ |
