Spécifications de contenu de flux dans msn Partner Hub

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

Articles

Galeries

Vidéo

Images

Liens connexes

Réseaux sociaux

Règles de métadonnées de flux

Authentification de flux

Encodage de document

Formats de flux pris en charge

Flux volumineux

Limites et gestion des erreurs

Extension des flux avec des espaces de noms

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.

Instructions relatives aux titres

1. Longueur: Les titres de plus de 150 caractères seront rejetés, sauf si un titre court est également fourni. Pour éviter la troncation sur les cartes promotionnelles MSN, conservez les titres sous 75 caractères.

   1. Pour Copilot Discover, les cartes de contenu promotionnel nécessitent un titre court de 54 caractères ou moins.
   2. Pour envoyer des titres courts, utilisez ce format :
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Si aucun titre court n’est fourni, MSN peut générer une version condensée à l’aide de l’IA. Cette version s’affiche sur la carte promo, tandis que votre titre d’origine reste sur la page de l’article.

2. URL: N’incluez pas d’URL ou d’URL raccourcies.

3. Grammaire: Les titres doivent être corrects grammaticalement. Les conventions courantes sont acceptables. Maintenir un temps cohérent. Les questions ou instructions indirectes sont autorisées. Les guillemets sont acceptables même s’ils ne sont pas grammaticalement corrects.

4. Capitalisation:

   1. Les acronymes doivent être dans ALL CAPS.

   2. Les mots peuvent être en majuscules pour mettre l’accent sur tous les mots.

   3. Utilisez l’un des styles suivants :

      1. Cas de titre
      2. Tous les mots
      3. Cas de phrase

5. Orthographe: Doit être exempt de fautes d’orthographe. Les variations régionales sont acceptables. Les noms moins connus doivent toujours être acceptés.

6. Ponctuation: Utilisez une ponctuation minimale mais nécessaire. Les points et les virgules peuvent être utilisés indifféremment. Évitez les ponctuations non conventionnelles, sauf si elles font partie d’une personnalisation spécifique. Les titres n’ont pas besoin de se terminer par un point.

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.

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

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 principale qui accompagne le titre du contenu. 

• Les formats de fichiers acceptés sont JPG, GIF ou PNG
• La taille d’image recommandée est de 1280 x 720 px, avec une taille minimale de 640 x 360 px
• Les proportions d’image souhaitées sont de 16:9
• La taille de fichier maximale doit être de 2 Mo

Liens connexes

Les publications de tous types peuvent avoir des liens connexes en bas du contenu. Les liens associés doivent avoir un emplacement de lien, un texte d’affichage et une miniature pour s’afficher.

Réseaux sociaux

MSN prend en charge les incorporations à partir de :

• Twitter
• Facebook
• Instagram
• Pinterest
• infogr.am
• Spotify
• S' épanouir
• Google Maps
• Giphy
• Reddit
• TikTok

MSN recommande d’utiliser le code incorporé par défaut fourni par le site source. Cliquez ici pour 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 à l’adresse 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é.