As especificações de conteúdo do feed no MsN Partner Hub foram concebidas para garantir que os conteúdos dos parceiros são ingeridos, validados e publicados de forma eficiente e precisa. Estas especificações abrangem vários aspetos da gestão de conteúdos, incluindo tipos de conteúdo suportados, formatos, regras de metadados e diretrizes para manter o estado de funcionamento e a fiabilidade dos feeds.
O MSN suporta:
-
Artigos, Galerias e Vídeo
-
Origens de feed HTTPS. A utilização de TLS/SSL é altamente recomendada.
O MSN não suporta:
-
Ligações que contêm nomes de utilizador ou palavras-passe no recurso ou parâmetros
-
Lista de permissões de IP
-
IPs Estáticos
Neste artigo
Artigos
Os artigos são publicações que consistem em texto, imagens e vídeos. Os artigos não têm de ter imagens, mas apenas os artigos que incluem imagens podem ser publicados automaticamente.
Galerias
As galerias são apresentações de diapositivos compostas por imagens e legendas. As galerias têm de ter imagens incorporadas para serem publicadas.
Vídeo
Os vídeos podem ser publicados por si próprios ou incluídos em artigos. Uma publicação de vídeo ingerida a partir do seu feed será realojada no MSN, enquanto um vídeo alojado num site de terceiros, como o YouTube ou o DailyMotion, será incorporado através do alojamento desse site.
Os vídeos alojados no MSN irão gerar múltiplas velocidades de transmissão para transcodificação de vários dispositivos e transmissão em fluxo adaptável.
Formatos de contentor de vídeo suportados
AVI, MPEG, MP4, WMV, M4V
Codecs de vídeo suportados
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Formatos de áudio suportados
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protocolos suportados
HTTP, FTP
Extensões de ficheiro suportadas
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Tamanho do vídeo
Recomenda-se que os vídeos sejam, pelo menos, 720p e 3 Mbps. O tamanho máximo do ficheiro de vídeo é de 2 GB. Os ficheiros grandes, como vídeos 4K e vídeos mais longos, podem falhar a ingestão.
Nota: O dimensionamento não é suportado, pelo que é recomendada uma elevada qualidade de ficheiro de vídeo.
Imagens
As imagens não podem ser publicações por conta própria. Têm de ser incorporados num artigo ou galeria ou anexados a uma publicação de vídeo como uma miniatura.
Formatos de imagem suportados
WebP, PNG, JPG, GIF
Nota: Os GIFs não podem ser utilizados como imagens em miniatura. A sua utilização no conteúdo principal não é recomendada devido à qualidade limitada.
Tamanho da imagem
Imagens no conteúdo
Recomenda-se que as imagens têm, pelo menos, 720 px de altura ou largura. O tamanho máximo do ficheiro de imagem é de 15 MB. As imagens podem ser qualquer proporção, mas podem não ser apresentadas corretamente se a proporção for inferior a 0,5 ou superior a 1,89.
Imagens em miniatura
A imagem em miniatura é a imagem principal que acompanha o cabeçalho do conteúdo.
-
O tamanho de imagem recomendado é 1200x624px, com um DPI mínimo de 72.
-
A proporção da imagem pretendida é 1,91:1
-
O tamanho máximo do ficheiro deve ser de 2 MB
Redes sociais
O MSN suporta incorporações de:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Florescer
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
O MSN recomenda a utilização do código de incorporação predefinido fornecido pelo site de origem. Clique aquipara ver exemplos de código de incorporação para sites de redes sociais comuns.
Regras de metadados do feed
-
O Publisher tem de ter direitos de distribuição para todos os conteúdos no feed. Se o fabricante não tiver direitos para sindicalizar algumas imagens, tem de definir "HasSyndicationRights" como falso.
-
Todos os feeds têm de estar frescos e a atualizar regularmente antes de entrar em direto.
-
O mapeamento personalizado não é suportado, todos os campos têm de ser especificados de acordo com os exemplos indicados.
-
Os pontos finais dos parceiros têm de ser estáticos/inalterados quando não existe nenhum requisito para criar valores dinâmicos, tais como segmentos de rota, valores de cadeia de consulta e valores de cabeçalho de pedido HTTP.
-
Todos os itens no feed têm de estar no mesmo idioma único configurado para o feed.
-
A codificação é UTF-8 por predefinição, salvo especificação em contrário na etiqueta xml. Os feeds com combinação ou codificação não irão ingerir.
-
Os feeds não devem conter carateres ilegais não escapados, como "&", "<", ">", aspas duplas e plicas. Os itens com carateres de controlo não irão ingerir.
-
A Microsoft pode retirar qualquer ligação de natureza principalmente promocional.
-
Os e-mails das pessoas de contacto do Publisher têm de ser armazenados quando a marca do editor é integrada para ser utilizada para notificar o editor de conteúdos de problemas de sites em direto, como feeds obsoletos.
Deteção de alterações de feeds
O MSN guarda recursos durante a ingestão ao processar apenas feeds com conteúdo novo ou atualizado. As alterações podem ser sinalizadas de duas formas:
HTTP ETags
Os editores podem enviar um pedido com um cabeçalho ETag, que funciona como uma soma de verificação para os conteúdos do feed. A etiqueta será colocada em cache e enviada de volta no cabeçalho If-None-Match enquanto pede o feed.
Última modificação
Os conteúdos enviados com um cabeçalho Última Modificação serão colocados em cache, com o pedido subsequente a receber um cabeçalho If-Modified-Since . Os servidores de feed responderão com um código de estado 304 se não tiverem sido feitas alterações desde a data da última modificação.
Autenticação de feed
A autenticação do feed não é necessária. Os editores podem ingerir conteúdo sem nada mais do que um URL de origem de feed, se assim o desejarem, mas o MSN também suporta a autenticação Básica e o OAuth 2.0. Clique aqui para ver um gráfico que detalha o processo de ingestão de feeds.
Autenticação básica
O MSN suporta a autenticação básica, conforme especificado em RFC 7517. Para adicionar autenticação básica ao seu feed, forneça:
-
Nome de Utilizador
-
Palavra-passe
-
URL de Feed Seguro
OAuth 2.0
Para adicionar a autenticação OAuth 2.0 ao seu feed, forneça:
-
URL do Servidor de Tokens de Segurança
-
Client_ID
-
Grant_Type
-
Âmbito (opcional, utilizado para indicar o nível de acesso. Este valor será enviado tal como está.)
-
URL de Feed Seguro
Codificação de documentos
O MSN utiliza a codificação UTF-8 por predefinição. Pode substituir esta opção ao alterar o atributo de codificação do nó prolog para um valor de codificação válido.
Formatos de feed suportados
O MSN suporta RSS, ATOM e alguns subconjunto do Media RSS, Dublin Core e outros espaços de nomes detalhados no Media RSS.
Feeds grandes
O MSN recomenda manter sempre um tamanho de feed inferior a 30 itens frescos, mas pode utilizar a funcionalidade de paginação feed da ATOM para ativar a ingestão deslizante de janelas do seu feed.
Limites e processamento de erros
O tamanho máximo do feed é de 10 MB e o tamanho máximo da imagem é de 14 MB. O MSN aciona automaticamente um escalamento se o conteúdo ingerido tiver mais de três dias. Se tiver requisitos de idade de conteúdo diferentes, contacte-nos em PartnerHubSupport@microsoft.com. O MSN tenta novamente feeds com erros, mas se os erros persistirem, será notificado para investigar. O MSN desativa automaticamente a ingestão de conteúdos de feeds que permanecem num estado de erro durante um período de tempo prolongado.
Expandir feeds com espaços de nomes
Pode expandir o vocabulário e os termos do feed em feeds baseados em XML, juntamente com o prefixo recomendado. O MSN só reconhece elementos e atributos explicitamente especificados nos exemplos de código listados. Qualquer espaço de nomes não suportado será ignorado.
|
Nome da Extensão |
Prefix |
Espaço de nomes |
|---|---|---|
|
RSS multimédia |
multimédia |
http://search.yahoo.com/mrss/ |
|
Metadados Principais de Dublin |
dc |
http://purl.org/dc/elements/1.1/ |
|
Termos Principais de Dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Serviços de Ingestão da Microsoft proprietários |
mi |
http://schemas.ingestion.microsoft.com/common/ |
