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

Ligações relacionadas

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 cartão 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 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.

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

Ligações relacionadas

As publicações de todos os tipos podem ter ligações relacionadas na parte inferior do conteúdo. As ligações relacionadas têm de ter uma localização de ligação, texto a apresentar e miniatura para aparecerem.

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 aqui para 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, tais 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.