Les spécifications de contenu de flux dans MSN Partner Hub sont conçues pour garantir que le contenu des partenaires est ingéré, validé et publié de manière efficace et précise. Ces spécifications couvrent différents aspects de la gestion du contenu, notamment les types de contenu pris en charge, les formats, les règles de métadonnées et les instructions pour le maintien de l’intégrité et de la fiabilité des flux.
MSN prend en charge :
-
Articles, galeries et vidéo
-
Sources de flux HTTPS. L’utilisation de TLS/SSL est fortement recommandée.
MSN ne prend pas en charge :
-
Liens contenant des noms d’utilisateur ou des mots de passe dans la ressource ou les paramètres
-
Liste verte d’adresses IP
-
Adresses IP statiques
Dans cet article
Formats de flux pris en charge
Articles
Les articles sont des billets composés de texte, d’images et de vidéos. Les articles ne sont pas obligatoires pour avoir des images, mais seuls les articles qui incluent des images peuvent être publiés automatiquement.
Galeries
Les galeries sont des diaporamas composés d’images et de légendes. Les galeries doivent avoir des images incorporées à publier.
Vidéo
Les vidéos peuvent être publiées par elles-mêmes ou incluses dans des articles. Une publication vidéo ingérée à partir de votre flux sera réhébergée sur MSN, tandis qu’une vidéo hébergée sur un site tiers tel que YouTube ou DailyMotion sera incorporée via l’hébergement de ce site.
Les vidéos hébergées sur MSN génèrent plusieurs débits binaires pour le transcodage multi-appareil et le streaming adaptatif.
Formats de conteneur vidéo pris en charge
AVI, MPEG, MP4, WMV, M4V
Codecs vidéo pris en charge
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Formats audio pris en charge
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protocoles pris en charge
HTTP, FTP
Extensions de fichier prises en charge
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Taille de la vidéo
Les vidéos sont recommandées pour au moins 720p, 3Mbps. La taille maximale du fichier vidéo est de 2 Go. Les fichiers volumineux, tels que les vidéos 4K et les vidéos plus longues, peuvent échouer l’ingestion.
Remarque : La mise à l’échelle n’étant pas prise en charge, une qualité de fichier vidéo élevée est recommandée.
Images
Les images ne peuvent pas être des publications par elles-mêmes. Elles doivent être incorporées dans un article ou une galerie ou jointes à une publication vidéo sous forme de miniature.
Formats d’image pris en charge
WebP, PNG, JPG, GIF
Remarque : Les gif ne peuvent pas être utilisés comme images miniatures. Leur utilisation dans le contenu main n’est pas recommandée en raison d’une qualité limitée.
Taille de l’image
Images dans le contenu
Il est recommandé que la hauteur ou la largeur des images soit d’au moins 720 px. La taille maximale du fichier image est de 15 Mo. Les images peuvent être n’importe quelle proportion, mais peuvent ne pas s’afficher correctement si le rapport est inférieur à 0,5 ou supérieur à 1,89.
Vignettes
L’image miniature est l’image main qui accompagne le titre du contenu.
-
La taille d’image recommandée est de 1200 x 624 px, avec un DPI minimal de 72.
-
Les proportions d’image souhaitées sont de 1,91:1
-
La taille de fichier maximale doit être de 2 Mo
Réseaux sociaux
MSN prend en charge les incorporations à partir de :
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
infogr.am
-
Spotify
-
Prospérer
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN recommande d’utiliser le code incorporé par défaut fourni par le site source. Cliquez icipour voir des exemples de code incorporé pour les sites de réseaux sociaux courants.
Règles de métadonnées de flux
-
L’éditeur doit disposer de droits de distribution pour tout le contenu du flux. Si l’éditeur n’a pas le droit de syndiquer certaines images, il DOIT définir « HasSyndicationRights » sur false.
-
Tous les flux doivent être actualisés et mis à jour régulièrement avant d’être mis en ligne.
-
Le mappage personnalisé n’est pas pris en charge, tous les champs doivent être spécifiés conformément aux exemples donnés.
-
Les points de terminaison partenaires doivent être statiques/immuables lorsqu’il n’est pas nécessaire de générer des valeurs dynamiques telles que des segments de routage, des valeurs de chaîne de requête et des valeurs d’en-tête de requête HTTP.
-
Tous les éléments du flux doivent être dans la même langue que celle configurée pour le flux.
-
L’encodage est UTF-8 par défaut, sauf indication contraire dans la balise xml. L’ingestion des flux mixtes ou en encodage échoue.
-
Les flux ne doivent pas contenir de caractères non autorisés non placés dans une séquence d’échappement, tels que « & », « < », « > », des guillemets doubles et des guillemets simples. Les éléments avec des caractères de contrôle ne pourront pas être ingérés.
-
Microsoft peut supprimer tous les liens de nature principalement promotionnelle.
-
Les e-mails des contacts de l’éditeur doivent être stockés lorsque la marque de l’éditeur est embarquée pour l’utiliser pour informer l’éditeur de contenu de problèmes de site en direct, tels que les flux obsolètes.
Détection des modifications de flux
MSN enregistre les ressources pendant l’ingestion en traitant uniquement les flux qui ont du contenu nouveau ou mis à jour. Les modifications peuvent être signalées de deux manières :
HTTP ETags
Les éditeurs peuvent envoyer une requête avec un en-tête ETag, qui agit comme une somme de contrôle pour le contenu du flux. La balise est mise en cache et renvoyée dans l’en-tête If-None-Match lors de la demande du flux.
Date de la dernière modification
Le contenu envoyé avec un en-tête Last Modified sera mis en cache, la requête suivante recevant un en-tête If-Modified-Since . Les serveurs de flux répondent avec un code status 304 si aucune modification n’a été apportée depuis la dernière date de modification.
Authentification de flux
L’authentification du flux n’est pas requise. Les éditeurs peuvent ingérer du contenu avec rien de plus qu’une URL de source de flux s’ils le souhaitent, mais MSN prend également en charge l’authentification de base et OAuth 2.0. Cliquez ici pour afficher un graphique détaillant le processus d’ingestion de flux.
Authentification de base
MSN prend en charge l’authentification de base comme spécifié dans RFC 7517. Pour ajouter l’authentification de base à votre flux, fournissez :
-
Nom d’utilisateur
-
Mot de passe
-
URL de flux sécurisé
OAuth 2.0
Pour ajouter l’authentification OAuth 2.0 à votre flux, fournissez :
-
URL du serveur de jetons de sécurité
-
Client_ID
-
Grant_Type
-
Étendue (facultatif, utilisé pour indiquer le niveau d’accès. Cette valeur sera envoyée telle qu’elle est.)
-
URL de flux sécurisé
Encodage de document
MSN utilise l’encodage UTF-8 par défaut. Vous pouvez remplacer cela en remplaçant l’attribut d’encodage du nœud prolog par une valeur d’encodage valide.
Formats de flux pris en charge
MSN prend en charge RSS, ATOM et certains sous-ensembles de Media RSS, Dublin Core et d’autres espaces de noms détaillés dans Media RSS.
Flux volumineux
MSN recommande de conserver une taille de flux inférieure à 30 éléments frais à tout moment, mais vous pouvez utiliser la fonctionnalité de pagination de flux d’ATOM pour activer l’ingestion de fenêtre glissante de votre flux.
Limites et gestion des erreurs
La taille maximale du flux est de 10 Mo et la taille maximale de l’image est de 14 Mo. MSN déclenche automatiquement une escalade si le contenu ingéré a plus de trois jours. Si vous avez des exigences d’âge de contenu différentes, contactez-nous à PartnerHubSupport@microsoft.com. MSN tente à nouveau les flux qui ont des erreurs, mais si les erreurs persistent, vous serez averti d’examiner. MSN désactive automatiquement l’ingestion de contenu des flux qui restent dans un état d’erreur pendant une période prolongée.
Extension des flux avec des espaces de noms
Vous pouvez étendre le vocabulaire et les termes de flux dans les flux XML avec leur préfixe recommandé. MSN reconnaît uniquement les éléments et les attributs explicitement spécifiés dans les exemples de code répertoriés. Tout espace de noms non pris en charge sera ignoré.
|
Nom de l’extension |
Prefix (Préfixe) |
Espace de noms |
|---|---|---|
|
Rss multimédia |
média |
http://search.yahoo.com/mrss/ |
|
Métadonnées Dublin Core |
courant continu |
http://purl.org/dc/elements/1.1/ |
|
Conditions principales de Dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Services d’ingestion Microsoft propriétaires |
mi |
http://schemas.ingestion.microsoft.com/common/ |
