Spécification du rapport pour CRM

Spécification du rapport pour CRM

Description générale

Le rapport contient des informations sur les campagnes publicitaires sur la plateforme M-SQ, y compris l'état des annonces et les métriques de visualisation. Le rapport est présenté au format XML.

Attributs

  • generation-date: Date et heure de génération du rapport au format ISO 8601.

Structure XML

Élément racine

  • offers: Élément racine contenant l'attribut generation-date et un ou plusieurs éléments offer.

Éléments à l'intérieur de <offers>

  • offer: Élément contenant des informations sur une annonce spécifique. Peut contenir les sous-éléments suivants :

- id: Numéro unique de l'annonce sur M-SQ. Peut être absent. - url: Lien vers l'annonce sur M-SQ. Peut être absent. - externalid: Numéro CRM unique d'un système externe (flux). - status: État de l'annonce. Valeurs possibles :
- `error`: Erreur.
- `finish`: Terminé.
- `published`: Publié.
-
message: Description de l'erreur ou notification. Peut être absent. - view: Nombre de vues (valeur totale sur l'histoire de placement). Peut être absent. - view
tel
: Nombre de contacts (valeur totale sur l'histoire de placement). Peut être absent.

Exemple de rapport 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>La localisation de l'objet n'a pas pu être déterminée; Vous devez indiquer votre localité dans l'annonce;</message>
  </offer>
</offers>

Remarques

  • Les éléments url, id, message, view et view_tel peuvent être absents selon l'état de l'annonce et la disponibilité des données correspondantes.
  • Le statut error peut être accompagné de l'élément message pour décrire l'erreur.
  • L'élément message contient des erreurs listées séparées par ;, principalement en anglais à moins que la langue ne soit pas définie.
    Nous utilisons des cookies pour améliorer votre expérience et à des fins de marketing. Lisez notre politique en matière de cookies ou gérez les cookies.