DSASearchQueryPerformanceReportRequest-Datenobjekt – Berichterstellung

Artikel
12/21/2023

Definiert eine Leistungsberichtsanforderung für DSA-Suchabfragen. Verwenden Sie diesen Bericht, um zu sehen, wie Ihre Anzeigen für Suchbegriffe funktionieren. Die Daten können Ihnen helfen, negative Schlüsselwörter zu finden (damit Sie kein Geld für den falschen Kunden ausgeben) sowie die richtigen Schlüsselwörter, die Konvertierungen erzeugen.

Sie können Aufrufe, Klicks, Klickrate und durchschnittliche Position für Suchbegriffe anfordern, die Ihre Anzeigen ausgelöst haben.

Der Bericht enthält nur Suchbegriffe, die in den letzten 30 Tagen zu einer erheblichen Anzahl von Klicks geführt haben.

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

Syntax

<xs:complexType name="DSASearchQueryPerformanceReportRequest" 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:ArrayOfDSASearchQueryPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:DSASearchQueryPerformanceReportFilter" />
        <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 DSASearchQueryPerformanceReportRequest-Objekt verfügt über die folgenden Elemente: Aggregation, Columns, Filter, Scope, Time.

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 Zusammenfassungsbericht anfordern. Die Standardaggregation ist Zusammenfassung. Beachten Sie folgendes: Wenn Sie TimePeriod nicht in die Liste der Spalten aufnehmen, wird die ausgewählte Aggregation ignoriert, 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.	DSASearchQueryPerformanceReportColumn-Array
Filter	Die Filterinformationen, die zum Filtern der Berichtsdaten verwendet werden sollen.	DSASearchQueryPerformanceReportFilter
Bereich	Der Entitätsbereich des Berichts. Verwenden Sie dieses Element, um die Berichtsdaten auf bestimmte Konten, Anzeigengruppen oder Kampagnen 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 ThisWeek. 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, sodass Sie Daten für den angeforderten Zeitraum genau festlegen können. Wenn Sie keine Zeitzone auswählen, verwendet der Berichtsdienst standardmäßig PacificTimeUSCanadaTijuana.	ReportTime

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

Geerbte Elemente

Geerbte Elemente von ReportRequest

Das DSASearchQueryPerformanceReportRequest-Objekt wird vom ReportRequest-Objekt abgeleitet und erbt die folgenden Elemente: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. Die folgenden Beschreibungen gelten spezifisch für DSASearchQueryPerformanceReportRequest 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 Headerbeschreibungen für jede Spalte enthalten soll. Die Berichtsspaltenüberschrift entspricht dem angeforderten Spaltennamen, z. B. Impressionen und Klicks. Legen Sie diese Eigenschaft auf true fest, wenn die Berichtsspaltenüberschriften aus dem heruntergeladenen Bericht ausgeschlossen werden sollen. Der Standardwert ist false.	boolean
ExcludeReportFooter	Bestimmt, ob der heruntergeladene Bericht Fußzeilenmetadaten wie Microsoft Copyright (@2020 Microsoft Corporation) enthalten soll. Alle Rechte vorbehalten.). Legen Sie diese Eigenschaft auf true fest, wenn die Metadaten der Berichtsfußzeile aus dem heruntergeladenen Bericht ausgeschlossen werden sollen. Der Standardwert ist false.	boolean
ExcludeReportHeader	Bestimmt, ob der heruntergeladene Bericht Headermetadaten wie Berichtsname, Datumsbereich und Aggregation enthalten soll. Legen Sie diese Eigenschaft auf true fest, wenn die Berichtsheadermetadaten 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 (Tsv) anfordern. Der Standardwert ist CSV. Alle heruntergeladenen Dateien sind 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, wird für den Dienst standardmäßig Version 1.0 verwendet. Ausführliche Informationen zu Änderungen zwischen Formatversionen finden Sie unter Version des Berichtsformats.	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 true festgelegt ist und das System die Verarbeitung aller Daten basierend auf der angeforderten Aggregation, dem Bereich und der Angeforderten Zeit noch nicht abgeschlossen hat, gibt der Dienst den Fehlercode NoCompleteDataAvaliable (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, dass Sie dieses Element nicht auf "true" festlegen können, wenn der Zeitraum (ob benutzerdefiniertes oder vordefiniertes Datum) das heutige Datum enthält, da heute noch ausgeführt wird und die Daten nicht vollständig sind. Weitere Informationen finden Sie unter Zeitzonen in der Berichterstellung.	boolean

Anforderungen

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

Freigeben über