Especificação do Relatório para CRM

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-date e um ou mais elementos offer.

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. - view
tel
: 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, view e view_tel podem estar ausentes dependendo do status do anúncio e da disponibilidade dos dados correspondentes.
  • O status error pode ser acompanhado pelo elemento message para descrever o erro.
  • O elemento message contém erros listados separados por ;, principalmente em inglês, a menos que o idioma não seja definido.
    Usamos cookies para melhorar a sua experiência e para marketing. Leia a nossa política de cookies ou gerencie cookies.