Specifica del Report per CRM
Descrizione Generale
Il report contiene informazioni sulle campagne pubblicitarie sulla piattaforma M-SQ, inclusi lo stato degli annunci e le metriche di visualizzazione. Il report è presentato in formato XML.Attributi
- generation-date: Data e ora di generazione del report nel formato ISO 8601.
Struttura XML
Elemento Radice
- offers: Elemento radice che contiene l'attributo
generation-datee uno o più elementioffer.
Elementi all'interno di <offers>
- offer: Elemento che contiene informazioni su un annuncio specifico. Può includere i seguenti sottoelementi:
- id: Numero univoco dell'annuncio su M-SQ. Può essere assente. - url: Link all'annuncio su M-SQ. Può essere assente. - externalid: Numero CRM univoco da un sistema esterno (feed). - status: Stato dell'annuncio. Valori possibili:
- `error`: Errore.
- `finish`: Concluso.
- `published`: Pubblicato. - message: Descrizione dell'errore o notifica. Può essere assente.
- view: Numero di visualizzazioni (valore totale lungo la storia di inserimento). Può essere assente.
- viewtel: Numero di contatti (valore totale lungo la storia di inserimento). Può essere assente.Esempio di Report 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>Non è stato possibile determinare la posizione dell'oggetto; È necessario indicare la propria località nell'annuncio;</message>
</offer>
</offers>Note
- Gli elementi
url,id,message,vieweview_telpossono essere assenti a seconda dello stato dell'annuncio e della disponibilità dei dati corrispondenti. - Lo stato
errorpuò essere accompagnato dall'elementomessageper descrivere l'errore. - L'elemento
messagecontiene errori elencati separati da;, principalmente in inglese a meno che non sia definito il linguaggio.