El archivo XML Promotions se sirve desde un servidor a su sitio Web y es actualizado por un cliente del servicio de mensajería a intervalos configurables. El archivo debe estar formado por cadenas cifradas con UTF-8 (el texto ASCII sencillo se convierte automáticamente al cifrado UTF-8) y se permiten marcas de orden de bytes (BOM, Byte Order Mark). Para que los clientes del servicio de mensajería puedan ver el contenido correctamente, el formato especificado en el código XML debe seguirse estrictamente. Microsoft no se responsabiliza de códigos XML incorrectos ni de sus efectos. Consulte Contenido promocional del cliente del servicio de mensajería personalizado para obtener información general acerca de cómo incluir material de promoción en el cliente del servicio de mensajería personalizado.
Tabla de referencia de etiquetas
| Etiqueta | Descripción | Principal |
|---|---|---|
| msn-data | Requerido. Contenedor de nivel superior del material de promociones. | (ninguna) |
| RefreshLogin | Requerido. Valor booleano que determina cuándo se descargará contenido nuevo. Si se establece a True, se descarga un nuevo archivo XML desde el servidor siempre que un usuario inicia una sesión y se restablece el temporizador de actualización a cero. Si se establece a False, el contenido no se actualiza automáticamente en cada inicio de sesión (sólo se actualiza al alcanzar el intervalo establecido) y el temporizador del intervalo de actualización se restablece entre inicios de sesión. Se recomienda RefreshLogin=True. Es aconsejable establecer RefreshLogin a False si le preocupa que el servidor XML reciba un exceso de solicitudes después de cortes del suministro eléctrico o en momentos de mucha actividad. | msn-data |
| RefreshInterval | Requerido. Número de minutos que debe transcurrir entre las actualizaciones de todo el archivo XML en el cliente. Si el usuario ha cerrado la sesión y RefreshLogin se establece a False, el valor del temporizador se restablece entre inicios de sesión. El valor mínimo es 5 y el máximo es 10080 (una semana). | msn-data |
| article-group | Contenedor para conjuntos de artículos. Cada parámetro article-group (grupo de artículos) determina el contenido que se mostrará dentro del área Promociones; si se incluye más de uno, se rotan secuencialmente. Debe especificarse al menos un grupo de artículos; en el archivo XML Promotions se permite un máximo de cinco. Cada grupo no debe incluir más de tres vínculos y una imagen. | msn-data |
| article | Contenedor de cada artículo individual. Puede estar formado por un vínculo (predeterminado) o una imagen, en cuyo caso debe especificarse <article type="image">. | article-group |
| image-url | Especifica la dirección URL de la imagen, que sólo se utilizará si el artículo es type="image". En el área Promociones sólo se pueden utilizar imágenes .GIF; los archivos JPEG no se mostrarán. El tamaño de imagen recomendado es de 60 píxeles de ancho por 60 píxeles de alto si muestra una imagen con varios vínculos. Si muestra una imagen sin vínculos (un título publicitario, por ejemplo) el tamaño máximo es de 234 píxeles de ancho por 60 píxeles de alto. Se admiten imágenes .GIF animadas. | article type="image" |
| url | Especifica la dirección URL que se carga en una nueva ventana del explorador cuando el usuario hace clic en un vínculo o una imagen. | article |
| title | Especifica el texto que se mostrará al usuario como un vínculo. Sólo debe utilizarse si el artículo no es type="image". | article |
Ejemplo
<?xml version="1.0"?>
<msn-data>
<RefreshLogin>True</RefreshLogin>
<RefreshInterval>360</RefreshInterval>
<article-group>
<article type="image">
<image-url>http://msdn.microsoft.com/workshop/graphics/icons/xml.gif</image-url>
<url>http://msdn.microsoft.com/xml/index.asp</url>
</article>
<article>
<title>Aprenda acerca de XML en MSDN</title>
<url>http://msdn.microsoft.com/xml/index.asp</url>
</article>
<article>
<title>Guía de XML para programadores de MSDN</title>
<url>http://msdn.microsoft.com/xml/xmlguide/default.asp</url>
</article>
<article>
<title>Charla acerca de XML</title>
<url>http://msdn.microsoft.com/chats/xml.asp</url>
</article>
</article-group>
<article-group>
<article>
<title> P+F acerca de MSN Messenger Service</title>
<url>http://messenger.msn.com/support/knownissues.asp</url>
</article>
<article>
<title> Descargas de MSN Messenger Service</title>
<url>http://messenger.msn.com/download/download.asp</url>
</article>
<article>
<title>MSN Messenger Service es internacional</title>
<url>http://messenger.msn.com/support/intl_map.asp</url>
</article>
</article-group>
</msn-data>