Specyfikacje zawartości kanału informacyjnego w Centrum partnerskim MSN mają na celu zapewnienie, że zawartość od partnerów jest ponawiane, weryfikowane i publikowane wydajnie i dokładnie. Specyfikacje te obejmują różne aspekty zarządzania zawartością, w tym obsługiwane typy zawartości, formaty, reguły metadanych oraz wskazówki dotyczące dbania o kondycję i niezawodność kanału informacyjnego.
Witryna MSN obsługuje:
-
Artykuły, galerie i klipy wideo
-
Źródła strumieniowe HTTPS. Zdecydowanie zalecane jest używanie protokołu TLS/SSL.
Witryna MSN nie obsługuje:
-
Linki zawierające nazwy użytkowników lub hasła w zasobie lub parametrach
-
Lista adresów IP
-
Statyczne adresy IP
W tym artykule
Reguły metadanych strumieniowych
Uwierzytelnianie kanału informacyjnego
Artykuły
Artykuły to wpisy składające się z tekstu, obrazów i klipów wideo. Artykuły nie muszą zawierać obrazów, ale można automatycznie publikować tylko artykuły zawierające obrazy.
Galerie
Galerie to pokazy slajdów składające się z obrazów i podpisów. Galerie muszą mieć osadzone obrazy do opublikowania.
Klip wideo
Klipy wideo można publikować samodzielnie lub dołączać do artykułów. Wpis wideo pobrany z Twojego kanału informacyjnego zostanie ponownie pobrany w witrynie MSN, natomiast klip wideo hostowany w witrynie innej firmy, takiej jak YouTube lub DailyMotion, zostanie osadzony za pośrednictwem hostingu tej witryny.
Klipy wideo hostowane w witrynie MSN generują wiele szybkości transmisji bitów na potrzeby transkodowania wielu urządzeń i adaptacyjnego przesyłania strumieniowego.
Obsługiwane formaty kontenera wideo
AVI, MPEG, MP4, WMV, M4V
Obsługiwane kodery-dekodery wideo
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Obsługiwane formaty audio
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Obsługiwane protokoły
HTTP, FTP
Obsługiwane rozszerzenia plików
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Rozmiar wideo
Zaleca się, aby klipy wideo były o rozmiarze co najmniej 720p i 3 Mb/s. Maksymalny rozmiar pliku wideo wynosi 2 GB. Duże pliki, takie jak filmy 4K i dłuższe klipy wideo, mogą kończyć się niepowodzeniem.
Uwaga: Skalowanie nie jest obsługiwane, dlatego zalecana jest wysoka jakość plików wideo.
Obrazy
Obrazy nie mogą być wpisami własnymi. Muszą one zostać osadzone w artykule lub galerii albo dołączone do wpisu wideo jako miniatura.
Obsługiwane formaty obrazów
WebP, PNG, JPG, GIF
Uwaga: Plików GIF nie można używać jako obrazów miniatur. Używanie ich w głównej zawartości nie jest zalecane ze względu na ograniczoną jakość.
Rozmiar obrazu
Obrazy w zawartości
Zaleca się, aby obrazy miały wysokość lub szerokość co najmniej 720 pikseli. Maksymalny rozmiar pliku obrazu wynosi 15 MB. Obrazy mogą mieć dowolny współczynnik proporcji, ale mogą nie być wyświetlane poprawnie, jeśli stosunek jest mniejszy niż 0,5 lub większy niż 1,89.
Miniatur
Obraz miniatury to główny obraz towarzyszący nagłówkowi zawartości.
-
Zalecany rozmiar obrazu to 1200x624 pikseli i minimalna rozdzielczość 72.
-
Pożądany współczynnik proporcji obrazu to 1,91:1
-
Maksymalny rozmiar pliku powinien wynosić 2 MB
Media społecznościowe
Usługa MSN obsługuje osadzania z:
-
Twitter
-
Serwis Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Kwitnąć
-
Mapy Google
-
Giphy
-
Reddit
-
TikTok
MSN zaleca użycie domyślnego kodu osadzania udostępnionego przez witrynę źródłową. Kliknij tutaj, aby zobaczyć przykłady kodu osadzania dla typowych witryn mediów społecznościowych.
Reguły metadanych strumieniowych
-
Wydawca musi mieć prawa do rozpowszechniania całej zawartości w kanale informacyjnym. Jeśli wydawca nie ma praw do grupowania niektórych obrazów, MUSI ustawić wartość "HasSyndicationRights" na fałsz.
-
Przed rozpoczęciem transmisji na żywo wszystkie kanały informacyjne muszą być świeże i regularnie aktualizowane.
-
Mapowanie niestandardowe nie jest obsługiwane, wszystkie pola muszą być określone zgodnie z podanymi przykładami.
-
Punkty końcowe partnerów muszą być statyczne/niezmieniane w przypadku, gdy nie ma potrzeby tworzenia żadnych wartości dynamicznych, takich jak segmenty tras, wartości ciągów zapytań i wartości nagłówka żądania HTTP.
-
Wszystkie elementy w kanale informacyjnym muszą być w tym samym języku skonfigurowanym dla kanału informacyjnego.
-
Kodowanie jest domyślnie utf-8, chyba że określono inaczej w tagu xml. Nie można połknąć kanałów z kodowaniem lub mieszanym kodowaniem.
-
Kanały informacyjne nie powinny zawierać żadnych niedozwolonych znaków, takich jak "&", "<", ">", cudzysłowy podwójne i pojedyncze. Nie można połknąć elementów zawierających znaki kontrolne.
-
Firma Microsoft może usuwać linki o charakterze głównie promocyjnym.
-
Wiadomości e-mail osób kontaktowych wydawcy muszą być przechowywane, gdy na tablicy znajduje się marka wydawcy, aby powiadamiać wydawcę zawartości o problemach z witryną na żywo, takich jak nieaktualne kanały informacyjne.
Wykrywanie zmiany kanału informacyjnego
Usługa MSN zapisuje zasoby podczas pozyskiwania, przetwarzając tylko kanały informacyjne, które mają nową lub zaktualizowaną zawartość. Zmiany mogą być oflagowane na dwa sposoby:
Tagi HTTP
Wydawcy mogą wysłać żądanie z nagłówkiem ETag, który działa jak suma kontrolna zawartości kanału informacyjnego. Tag zostanie zapisany w pamięci podręcznej i wysłany z powrotem w nagłówku If-None-Match podczas żądania kanału informacyjnego.
Ostatnia modyfikacja
Zawartość wysłana z nagłówkiem Ostatnia modyfikacja zostanie zapisana w pamięci podręcznej, a kolejne żądanie otrzyma nagłówek If-Modified-Since . Serwery kanałów informacyjnych będą odpowiadać z kodem stanu 304, jeśli od daty ostatniej modyfikacji nie wprowadzono żadnych zmian.
Uwierzytelnianie kanału informacyjnego
Uwierzytelnianie kanału informacyjnego nie jest wymagane. Wydawcy mogą spożywać zawartość zawierającą tylko adres URL źródła strumieniowego, jeśli sobie tego życzą, ale witryna MSN obsługuje również uwierzytelnianie podstawowe i OAuth 2.0. Kliknij tutaj, aby wyświetlić wykres przedstawiający proces pozyskiwania kanału informacyjnego.
Uwierzytelnianie podstawowe
MsN obsługuje uwierzytelnianie podstawowe określone w RFC 7517. Aby dodać podstawowe uwierzytelnianie do kanału informacyjnego, podaj:
-
Nazwa użytkownika
-
Hasło
-
Adres URL zabezpieczonego kanału informacyjnego
OAuth 2.0
Aby dodać uwierzytelnianie OAuth 2.0 do kanału informacyjnego, podaj:
-
Adres URL serwera tokenu zabezpieczeń
-
Client_ID
-
Grant_Type
-
Zakres (opcjonalne, używane do wskazywania poziomu dostępu. Ta wartość zostanie wysłana w stanie takim, w jakim jest).
-
Adres URL zabezpieczonego kanału informacyjnego
Kodowanie dokumentu
W usłudze MSN domyślnie jest używane kodowanie UTF-8. Można to zastąpić, zmieniając atrybut kodowania węzła prolog na prawidłową wartość kodowania.
Obsługiwane formaty kanałów informacyjnych
Msn obsługuje RSS, ATOM i niektóre podzbiory Media RSS, Dublin Core i inne przestrzenie nazw wyszczególnione w Media RSS.
Duże kanały informacyjne
MSN zaleca utrzymywanie rozmiaru kanału informacyjnego mniejszego niż 30 świeżych elementów przez cały czas, ale możesz użyć funkcji stronicowania kanału informacyjnego ATOM, aby włączyć wysuwane okno pozyskiwania kanału informacyjnego.
Limity i obsługa błędów
Maksymalny rozmiar kanału informacyjnego to 10 MB , a maksymalny — 14 MB. Usługa MSN automatycznie wyzwala eskalację, jeśli spożywana zawartość ma więcej niż trzy dni. Jeśli masz inne wymagania dotyczące wieku treści, skontaktuj się z nami pod adresem PartnerHubSupport@microsoft.com. Usługa MSN spróbuje ponownie kanałów informacyjnych, które mają błędy, ale jeśli błędy będą się powtarzać, zostanie wyświetlone powiadomienie o konieczności zbadania problemu. Witryna MSN automatycznie wyłącza pozyskiwanie zawartości z kanałów informacyjnych, które pozostają w stanie błędu przez dłuższy czas.
Rozszerzanie kanałów informacyjnych za pomocą obszarów nazw
Możesz rozszerzyć słownictwo i terminy kanałów informacyjnych opartych na języku XML wraz z zalecanym prefiksem. Usługa MSN rozpoznaje tylko elementy i atrybuty jawnie określone w podanych przykładach kodu. Każda nieobsługiowana przestrzeń nazw zostanie zignorowana.
|
Nazwa rozszerzenia |
Prefiks |
Przestrzeń nazw |
|---|---|---|
|
Media RSS |
multimedia |
http://search.yahoo.com/mrss/ |
|
Metadane podstawowe w Dublinie |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Postanowienia dotyczące dublina core |
dcterms |
http://purl.org/dc/terms/ |
|
Zastrzeżone usługi firmy Microsoft w zakresie pozyskiwania |
mi |
http://schemas.ingestion.microsoft.com/common/ |
