As especificações de conteúdo do feed no MsN Partner Hub foram projetadas para garantir que o conteúdo dos parceiros seja ingerido, validado e publicado com eficiência e precisão. Essas especificações abrangem vários aspectos do gerenciamento de conteúdo, incluindo tipos de conteúdo com suporte, formatos, regras de metadados e diretrizes para manter a integridade e a confiabilidade do feed.
O MSN dá suporte a:
-
Artigos, Galerias e Vídeo
-
Fontes de feed HTTPS. O uso de TLS/SSL é altamente recomendado.
O MSN não dá suporte a:
-
Links que contêm nomes de usuário ou senhas no recurso ou parâmetros
-
Whitelisting de IP
-
IPs estáticos
Neste artigo
Artigos
Os artigos são postagens que consistem em texto, imagens e vídeos. Artigos não são necessários para ter imagens, mas somente artigos que incluem imagens podem ser publicados automaticamente.
Galerias
Galerias são apresentações de slides que consistem em imagens e legendas. As galerias devem ter imagens inseridas para serem publicadas.
Vídeo
Os vídeos podem ser postados por conta própria ou incluídos em artigos. Uma postagem de vídeo ingerida do feed será reenhosted no MSN, enquanto um vídeo hospedado em um site de terceiros, como YouTube ou DailyMotion, será inserido por meio da hospedagem desse site.
Os vídeos hospedados no MSN gerarão várias taxas de bits para transcodificação de vários dispositivos e streaming adaptável.
Formatos de contêiner de vídeo com suporte
AVI, MPEG, MP4, WMV, M4V
Codecs de vídeo compatíveis
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Formatos de áudio com suporte
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Protocolos com suporte
HTTP, FTP
Extensões de arquivo com suporte
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Tamanho do vídeo
É recomendável que os vídeos sejam pelo menos 720p, 3Mbps. O tamanho máximo do arquivo de vídeo é de 2GB. Arquivos grandes, como vídeos 4K e vídeos mais longos, podem falhar na ingestão.
Observação: Não há suporte para upscaling, portanto, é recomendável alta qualidade de arquivo de vídeo.
Imagens
As imagens não podem ser postagens por conta própria. Eles devem ser inseridos em um artigo ou galeria ou anexados a uma postagem de vídeo como uma miniatura.
Formatos de imagem com suporte
WebP, PNG, JPG, GIF
Observação: Os GIFs não podem ser usados como imagens de miniatura. Seu uso no conteúdo main não é recomendado devido à qualidade limitada.
Tamanho da imagem
Imagens em conteúdo
É recomendável que as imagens sejam pelo menos 720px em altura ou largura. O tamanho máximo do arquivo de imagem é de 15MB. As imagens podem ser qualquer proporção, mas podem não ser exibidas corretamente se a taxa for menor que .5 ou maior que 1,89.
Imagens de miniatura
A imagem da miniatura é a imagem main que acompanha a manchete do conteúdo.
-
O tamanho da imagem recomendado é 1200x624px, com uma DPI mínima de 72.
-
A proporção de imagem desejada é 1.91:1
-
O tamanho máximo do arquivo deve ser de 2MB
Redes Sociais
O MSN dá suporte a inserções de:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Florescer
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
O MSN recomenda usar o código de inserção padrão fornecido pelo site de origem. Clique aquipara ver exemplos de código de inserção para sites comuns de mídia social.
Regras de metadados de feed
-
O publicador deve ter direitos de distribuição para todo o conteúdo no feed. Se o editor não tiver direitos de sindicalizar algumas imagens, ele deverá definir "HasSyndicationRights" como false.
-
Todos os feeds devem estar frescos e atualizados regularmente antes de entrar em operação.
-
Não há suporte para mapeamento personalizado, todos os campos devem ser especificados de acordo com os exemplos determinados.
-
Os pontos de extremidade do parceiro devem ser estáticos/inalterados onde não há necessidade de criar valores dinâmicos, como segmentos de rota, valores de cadeia de caracteres de consulta e valores de cabeçalho de solicitação HTTP.
-
Todos os itens no feed devem estar no mesmo idioma único configurado para o feed.
-
A codificação é UTF-8 por padrão, a menos que seja especificado na marca xml. Os feeds com mistura ou codificação não serão ingeridos.
-
Os feeds não devem conter caracteres ilegais não escapados, como "&", "<", ">", aspas duplas e aspas únicas. Itens com caracteres de controle não serão ingeridos.
-
A Microsoft pode remover todos os links de uma natureza principalmente promocional.
-
Os emails de pessoas de contato do editor devem ser armazenados quando a marca do editor é abordada para usar para notificar o editor de conteúdo de problemas de site ao vivo, como feeds obsoletos.
Detecção de alterações de feed
O MSN salva recursos durante a ingestão processando apenas feeds com conteúdo novo ou atualizado. As alterações podem ser sinalizadas de duas maneiras:
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 status 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 usuário
-
Senha
-
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 |
Prefixo |
Namespace |
|---|---|---|
|
RSS multimédia |
mí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/ |
