Especificación del Informe para CRM
Descripción General
El informe contiene información sobre campañas publicitarias en la plataforma M-SQ, incluyendo el estado de los anuncios y métricas de visualización. El informe se presenta en formato XML.Atributos
- generation-date: Fecha y hora de generación del informe en formato ISO 8601.
Estructura XML
Elemento Raíz
- offers: Elemento raíz que contiene el atributo
generation-datey uno o más elementosoffer.
Elementos dentro de <offers>
- offer: Elemento que contiene información sobre un anuncio específico. Puede incluir los siguientes subelementos:
- id: Número único del anuncio en M-SQ. Puede estar ausente. - url: Enlace al anuncio en M-SQ. Puede estar ausente. - externalid: Número único CRM de un sistema externo (feed). - status: Estado del anuncio. Valores posibles:
- `error`: Error.
- `finish`: Finalizado.
- `published`: Publicado. - message: Descripción del error o notificación. Puede estar ausente.
- view: Número de visualizaciones (valor total a lo largo del historial de colocación). Puede estar ausente.
- viewtel: Número de contactos (valor total a lo largo del historial de colocación). Puede estar ausente.Ejemplo de Informe XML
<offers generation-date="2024-06-20T06:00:08+00:00">
<offer>
<url>https://m-sq.eu/offer/1</url>
<id>1</id>
<external_id>R474</external_id>
<status>published</status>
<view>123</view>
<view_tel>7</view_tel>
</offer>
<offer>
<external_id>277</external_id>
<status>error</status>
<message>No se pudo determinar la ubicación del objeto; Debe indicar su localidad en el anuncio;</message>
</offer>
</offers>Notas
- Los elementos
url,id,message,viewyview_telpueden estar ausentes dependiendo del estado del anuncio y la disponibilidad de los datos correspondientes. - El estado
errorpuede ir acompañado del elementomessagepara describir el error. - El elemento
messagecontiene errores listados separados por;, principalmente en inglés a menos que el idioma no esté definido.