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-dateet un ou plusieurs élémentsoffer.
É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.
- viewtel: 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,viewetview_telpeuvent être absents selon l'état de l'annonce et la disponibilité des données correspondantes. - Le statut
errorpeut être accompagné de l'élémentmessagepour décrire l'erreur. - L'élément
messagecontient des erreurs listées séparées par;, principalement en anglais à moins que la langue ne soit pas définie.