MMMPerformanceReportRequest Datenobjekt – Berichterstellung

Definiert eine MMM-Anforderung (Marketing Mix Modeling) für einen Performance-Bericht. Verwenden Sie diesen Bericht, um aggregierte Microsoft Advertising-Leistungsdaten für Marketing-Mix-Modelle (MMMs) abzurufen. Dies sind statistische Modelle, die messen, wie viel jeder Marketingkanal zum Gesamtumsatz oder zur Konversion beiträgt. Diese Daten helfen Ihnen oder Ihrem MMM-Anbieter, die inkrementelle Wirkung von Microsoft Advertising zusammen mit anderen Marketingkanälen zu quantifizieren und fundiertere Entscheidungen zur Budgetzuweisung zu treffen.

Hinweis

Derzeit ist diese Funktion nicht allgemein verfügbar. Wenn Sie nicht über dieses Feature verfügen, keine Sorge. Es wird bald verfügbar sein!

Sie können Ausgaben, Impressionen, Klicks und qualifizierte Abschlüsse für jede Anzeigengruppe anfordern. Der Bericht enthält Spalten für den Zeitraum, das Konto, die Kampagne, die Anzeigengruppe und den geografischen Standort (Land, Bundesland und Großraum), wo die Anzeigen geschaltet wurden. Die Daten werden auf Anzeigengruppenebene für jeden Zeitraum aggregiert, sodass die für die MMM-Analyse erforderlichen konsistenten Verlaufsdaten bereitgestellt werden.

Um einen Bericht dieses Typs anzufordern, übergeben Sie dieses Objekt an den SubmitGenerateReport-Vorgang .

Syntax

<xs:complexType name="MMMPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfMMMPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:MMMPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das MMMPerformanceReportRequest-Objekt verfügt über die folgenden Elemente: Aggregation, Spalten, Filter, Bereich, Zeit.

Element Beschreibung Datentyp
Aggregation Der Aggregationstyp, der zum Aggregieren der Berichtsdaten verwendet werden soll. Beispielsweise können Sie die Berichtsdaten nach Tag oder Woche aggregieren oder einen zusammenfassenden Bericht anfordern.

Die Standardaggregation ist Summary. Beachten Sie, dass die ausgewählte Aggregation ignoriert wird, wenn Sie TimePeriod nicht in die Liste der Spalten aufnehmen, und die Zusammenfassungsaggregation wird unabhängig davon verwendet.		 ReportAggregation
Spalten Die Liste der Attribute und Leistungsstatistiken, die in den Bericht aufgenommen werden sollen. Der Bericht enthält die Spalten in der Reihenfolge, in der Sie sie angeben. MMMPerformanceReportColumn-Array
Filter Die Filterinformationen, die zum Filtern der Berichtsdaten verwendet werden sollen. MMMPerformanceReportFilter
Umfang Der Entitätsbereich des Berichts.

Verwenden Sie dieses Element, um die Berichtsdaten auf bestimmte Konten zu beschränken.		 AccountThroughAdGroupReportScope
Zeit Der Zeitraum, der für den Bericht verwendet werden soll. Sie können einen benutzerdefinierten Datumsbereich angeben oder einen vordefinierten Datumsbereich auswählen, z. B. "Heute" oder "DieseWoche".

Eine Liste der Zeiträume, die Sie für jeden Aggregationstyp angeben können, finden Sie unter Aggregation und Zeit.

Sie können die Zeitzone innerhalb des ReportTime-Objekts festlegen, wodurch Sie den genauen Umfang der Daten für den angeforderten Zeitraum festlegen können.

Wenn Sie keine Zeitzone auswählen, verwendet der Berichtsdienst standardmäßig PacificTimeUSCanadaTijuana.		 ReportTime

Das MMMPerformanceReportRequest-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von ReportRequest

Das MMMPerformanceReportRequest-Objekt wird vom ReportRequest-Objekt abgeleitet und erbt die folgenden Elemente: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. Die folgenden Beschreibungen sind spezifisch für MMMPerformanceReportRequest und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom ReportRequest-Objekt erben.

Element Beschreibung Datentyp
ExcludeColumnHeaders Bestimmt, ob der heruntergeladene Bericht Kopfzeilenbeschreibungen für jede Spalte enthalten soll. Die Spaltenüberschrift des Berichts stimmt mit dem angeforderten Spaltennamen überein, z. B. Impressionen und Klicks.

Legen Sie diese Eigenschaft als wahr fest, wenn Sie möchten, dass die Spaltenüberschriften des Berichts aus dem heruntergeladenen Bericht ausgeschlossen werden. Der Standardwert ist false.		 boolean
ExcludeReportFooter Bestimmt, ob der heruntergeladene Bericht Fußzeilenmetadaten wie Microsoft Copyright (@2020 Microsoft Corporation. Alle Rechte vorbehalten.).

Legen Sie diese Eigenschaft als wahr fest, wenn Sie möchten, dass die Metadaten der Berichtsfußzeile aus dem heruntergeladenen Bericht ausgeschlossen werden. Der Standardwert ist false.		 boolean
ExcludeReportHeader Bestimmt, ob der heruntergeladene Bericht Headermetadaten wie Berichtsname, Datumsbereich und Aggregation enthalten soll.

Legen Sie diese Eigenschaft als wahr fest, wenn die Berichtskopfmetadaten aus dem heruntergeladenen Bericht ausgeschlossen werden sollen. Der Standardwert ist false.		 boolean
Format Das Format der Berichtsdaten. Sie können die Daten beispielsweise im CSV-Format (durch Trennzeichen getrennte Werte) oder im TSV-Format (durch Tabstopp getrennte Werte) anfordern.

Der Standardwert ist CSV.

Alle heruntergeladenen Dateien werden mit ZIP komprimiert.		 ReportFormat
FormatVersion Bestimmt das Format für bestimmte Felder in der heruntergeladenen Berichtsdatei.

Das Datenformat für bestimmte Felder kann innerhalb der aktuellen API-Version aktualisiert werden, ohne vorhandene Clientanwendungen zu unterbrechen. Sie können das neueste Datenformat abrufen, indem Sie dieses optionale Anforderungsfeld auf 2.0 festlegen. Wenn Sie dieses Feld nicht festlegen, ist die Standardversion 1.0 des Diensts.

Ausführliche Informationen zu Änderungen zwischen Formatversionen finden Sie unter Berichtsformatversion.		 Zeichenfolge
ReportName Der Name des Berichts. Der Name ist im Berichtsheader enthalten. Wenn Sie keinen Berichtsnamen angeben, generiert das System einen Namen im Formular ReportType-ReportDateTime.

Die maximale Länge des Berichtsnamens beträgt 200.		 Zeichenfolge
ReturnOnlyCompleteData Bestimmt, ob der Dienst sicherstellen muss, dass alle Daten verarbeitet wurden und verfügbar sind.

Wenn diese Option auf true festgelegt ist und das System nicht alle Daten basierend auf der angeforderten Aggregation, dem Bereich und der Zeit verarbeitet hat, gibt der Dienst den Fehlercode NoCompleteDataAvacapable (2004) zurück. Andernfalls kann die Anforderung standardmäßig erfolgreich sein, es gibt keinen Hinweis darauf, ob die Daten vollständig sind, und der Bericht enthält nur die Daten, die das System zum Zeitpunkt der Anforderung verarbeitet hat.

Beachten Sie bitte, dass Sie dieses Element nicht auf "true" festlegen können, da der heutige Tag noch ausgeführt wird und die Daten nicht vollständig sind, wenn der Zeitraum (ob benutzerdefiniertes oder vordefiniertes Datum) das heutige Datum enthält. Weitere Informationen finden Sie unter Zeitzonen in der Berichterstellung.		 boolean

Anforderungen

Dienst: ReportingService.svc v13
Namensraum: https://bingads.microsoft.com/Reporting/v13

  • Zuletzt aktualisiert um