Berichtsspezifikation für CRM
Allgemeine Beschreibung
Der Bericht enthält Informationen über Werbekampagnen auf der Plattform M-SQ, einschließlich des Status der Anzeigen und der Betrachtungsmetriken. Der Bericht wird im XML-Format präsentiert.Attribute
- generation-date: Datum und Uhrzeit der Berichterstellung im ISO 8601 Format.
XML-Struktur
Wurzelelement
- offers: Wurzelelement, das das Attribut
generation-dateund ein oder mehrere Elementeofferenthält.
Elemente innerhalb von <offers>
- offer: Element, das Informationen zu einer spezifischen Anzeige enthält. Es kann die folgenden Unterlemente enthalten:
- id: Eindeutige Anzeigennummer auf M-SQ. Kann fehlen. - url: Link zur Anzeige auf M-SQ. Kann fehlen. - externalid: Eindeutige CRM-Nummer aus einem externen System (Feed). - status: Anzeigenstatus. Mögliche Werte:
- `error`: Fehler.
- `finish`: Abgeschlossen.
- `published`: Veröffentlicht. - message: Beschreibung des Fehlers oder Hinweises. Kann fehlen.
- view: Anzahl der Ansichten (Gesamtwert über die Platzierungsgeschichte). Kann fehlen.
- viewtel: Anzahl der Kontakte (Gesamtwert über die Platzierungsgeschichte). Kann fehlen.Beispiel XML-Bericht
<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>Die Position des Objekts konnte nicht bestimmt werden; Sie müssen Ihren Standort in der Anzeige angeben;</message>
</offer>
</offers>Anmerkungen
- Die Elemente
url,id,message,viewundview_telkönnen je nach Anzeigenstatus und Verfügbarkeit der entsprechenden Daten fehlen. - Der Status
errorkann durch das Elementmessagebegleitet werden, um den Fehler zu beschreiben. - Das Element
messageenthält Fehler, die durch;getrennt aufgeführt sind, hauptsächlich in englischer Sprache, falls die Sprache nicht definiert ist.