Especificação do Relatório para CRM
Descrição Geral
O relatório contém informações sobre campanhas publicitárias na plataforma M-SQ, incluindo o status dos anúncios e métricas de visualização. O relatório é apresentado no formato XML.Atributos
- generation-date: Data e hora de geração do relatório no formato ISO 8601.
Estrutura XML
Elemento Raiz
- offers: Elemento raiz que contém o atributo
generation-datee um ou mais elementosoffer.
Elementos dentro de <offers>
- offer: Elemento que contém informações sobre um anúncio específico. Pode incluir os seguintes subelementos:
- id: Número único do anúncio no M-SQ. Pode estar ausente. - url: Link para o anúncio no M-SQ. Pode estar ausente. - externalid: Número CRM único de um sistema externo (feed). - status: Status do anúncio. Valores possíveis:
- `error`: Erro.
- `finish`: Concluído.
- `published`: Publicado. - message: Descrição do erro ou notificação. Pode estar ausente.
- view: Número de visualizações (valor total ao longo do histórico de colocação). Pode estar ausente.
- viewtel: Número de contatos (valor total ao longo do histórico de colocação). Pode estar ausente.Exemplo de Relatório 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>A localização do objeto não pôde ser determinada; Você deve indicar sua localidade no anúncio;</message>
</offer>
</offers>Observações
- Os elementos
url,id,message,vieweview_telpodem estar ausentes dependendo do status do anúncio e da disponibilidade dos dados correspondentes. - O status
errorpode ser acompanhado pelo elementomessagepara descrever o erro. - O elemento
messagecontém erros listados separados por;, principalmente em inglês, a menos que o idioma não seja definido.