Especificações de conteúdo do feed no Hub de Parceiros do MSN

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

Galerias

Vídeo

Imagens

Links relacionados

Redes Sociais

Regras de metadados do feed

Autenticação de feed

Codificação de documentos

Formatos de feed suportados

Feeds grandes

Limites e processamento de erros

Expandir feeds com espaços de nomes

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.

Diretrizes de título

1. Comprimento: As manchetes com mais de 150 carateres serão rejeitadas, a menos que também seja fornecido um título curto. Para evitar a truncagem em cartões promocionais MSN, mantenha as manchetes com menos de 75 carateres.

   1. Para a Copilot Discover, os cartões de conteúdo promocionais requerem um título curto de 54 carateres ou menos.
   2. Para enviar títulos curtos, utilize este formato:
      <mi:shortTitle>Short Title</mi:shortTitle>
   3. Se não for fornecido um título curto, o MSN poderá gerar uma versão condensada com IA. Esta versão será apresentada no card promocional, enquanto o título original permanece na página do artigo.

2. URL: Não inclua URLs ou URLs abreviados.

3. Gramática: Os cabeçalhos têm de estar gramaticalmente corretos. As convenções comuns são aceitáveis. Mantenha o tempo consistente. São permitidas perguntas ou instruções indiretas. As aspas são aceitáveis mesmo que não estejam gramaticalmente corretas.

4. Uso de maiúsculas/minúsculas:

   1. Os acrónimos têm de estar em ALL CAPS.

   2. As palavras podem estar em ALL CAPS para dar ênfase.

   3. Utilize um dos seguintes estilos:

      1. Caso do Título
      2. Todas as Palavras
      3. Maiúsculas/minúsculas

5. Ortografia: Tem de estar livre de erros ortográficos. As variações regionais são aceitáveis. Os nomes menos conhecidos devem ser sempre aceites.

6. Pontuação: Utilize pontuação mínima, mas necessária. Os períodos e vírgulas podem ser utilizados alternadamente. Evite pontuação não convencional, a menos que faça parte de uma imagem corporativa específica. As manchetes não precisam de terminar com um ponto final.

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 compatíveis

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.

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

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. 

• Os formatos de ficheiro aceites são JPG, GIF ou PNG
• O tamanho de imagem recomendado é 1280x720px, com um tamanho mínimo de 640x360px
• A proporção da imagem pretendida é 16:9
• O tamanho máximo do ficheiro deve ser de 2 MB

Links relacionados

Postagens de todos os tipos podem ter links relacionados na parte inferior do conteúdo. Os links relacionados devem ter um local de link, um texto de exibição e uma miniatura a serem exibidos.

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 aqui para 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 individuais. 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 uma solicitação com um cabeçalho ETag, que age como uma soma de verificação para o conteúdo do feed. A marca será armazenada em cache e enviada de volta no cabeçalho If-None-Match durante a solicitação do feed.

Última modificação

O conteúdo enviado com um cabeçalho último modificado será armazenado em cache, com a solicitação subsequente recebendo um cabeçalho If-Modified-Since . Os servidores de feed responderão com um código 304 status se nenhuma alteração tiver sido feita desde a última data modificada.

Autenticação de feed

A autenticação de feed não é necessária. Os editores podem ingerir conteúdo com nada mais do que uma URL de origem de feed, se assim desejarem, mas o MSN também dá suporte à autenticação básica e ao OAuth 2.0. Clique aqui para ver um gráfico detalhando o processo de ingestão de feed.

Autenticação básica

O MSN dá suporte à autenticação básica conforme especificado no RFC 7517. Para adicionar autenticação básica ao feed, forneça:

• Nome de usuário
• Senha
• URL do feed protegido

OAuth 2.0

Para adicionar a autenticação OAuth 2.0 ao feed, forneça:

• URL do Servidor de Token de Segurança
• Client_id
• Grant_Type
• Escopo (opcional, usado para indicar o nível de acesso. Esse valor será enviado como está.)
• URL do feed protegido

Codificação de documentos

O MSN usa a codificação UTF-8 por padrão. Você pode substituir isso alterando o atributo de codificação do nó de prolog para um valor de codificação válido.

Formatos de feed com suporte

O MSN dá suporte a RSS, ATOM e alguns subconjuntos de Media RSS, Dublin Core e outros namespaces detalhados no Media RSS.

Feeds grandes

A MSN recomenda manter um tamanho de feed de menos de 30 itens frescos o tempo todo, mas você pode usar o recurso de paginação do Feed da ATOM para habilitar a ingestão deslizante da janela do feed.

Limites e tratamento de erros

O tamanho máximo do feed é de 10MB e o tamanho máximo da imagem é de 14MB. O MSN dispara automaticamente uma escalonamento se o conteúdo ingerido tiver mais de três dias. Se você tiver diferentes requisitos de idade de conteúdo, entre em contato conosco em PartnerHubSupport@microsoft.com. O MSN tenta novamente feeds com erros, mas se os erros persistirem, você será notificado para investigar. O MSN desativa automaticamente a ingestão de conteúdo de feeds que permanecem em um estado de erro por um período prolongado de tempo.

Estendendo feeds com namespaces

Você pode estender o vocabulário do feed e os termos em feeds baseados em XML, juntamente com o prefixo recomendado. O MSN reconhece apenas elementos e atributos especificados explicitamente nos exemplos de código listados. Qualquer namespace sem suporte será ignorado.