Reporting Service-Modell
Der Berichterstellungsdienst enthält die Vorgänge, die Sie verwenden, um Berichtsanforderungen zu übermitteln und deren status abzufragen. Die Berichte enthalten detaillierte Statistiken zu Microsoft Advertising-Konten, -Kampagnen und -Anzeigengruppen. Die Informationen können Ihnen helfen, Finanzen nachzuverfolgen, die Anzeigenleistung zu messen und Einstellungen anzupassen, um Ihr Budget oder Ihre Kampagne zu optimieren. Sie können z. B. den Schlüsselwort (keyword) Leistungsbericht verwenden, um zu sehen, welche Schlüsselwörter gut funktionieren und welche nicht.
Übersicht über Reporting Service
Wenn Sie eine Berichtsanforderung übermitteln, wählen Sie die Berichtsattribute und Leistungsstatistiken aus, um den Inhalt des Berichts zu bestimmen. Sie können z. B. Aufrufe, Klicks und Die Durchklickrate einschließen. Der Bericht verwendet die Spaltennamen als Spaltenüberschriften. Der Bericht enthält die Spalten in derselben Reihenfolge, in der Sie sie in das Columns-Element der Berichtsanforderung einschließen. Informationen dazu, wie sich Spalten auf die Datenausgabe auswirken, finden Sie unter Spalten, die die Daten gruppieren . Informationen zu Einschränkungen für Spaltenkombinationen in derselben Berichtsanforderung finden Sie weiter unten unter Spalteneinschränkungen .
Außerdem geben Sie die Berichtsparameter an, die das zurückgegebene Dataset einschränken oder einschränken. Beispielsweise können Sie die Aggregationsebene festlegen, um die Daten nach Tag oder Monat zu gruppieren. geben Sie den Zeitraum der Daten an, die in den Bericht aufgenommen werden sollen, indem Sie bestimmte Datumswerte oder vordefinierte Datumsbereiche verwenden, z. B. heute oder die letzten sieben Tage; geben Sie den Umfang der Daten an, indem Sie die Konten, Kampagnen und Anzeigengruppen identifizieren, die in den Bericht aufgenommen werden sollen; und legen Filterkriterien fest, um die Berichtsdaten zu filtern. Informationen zu Zeiträumen, die Sie für jeden Aggregationswert angeben können, finden Sie weiter unten unter Aggregation und Zeit .
Eine Liste der Berichte, die Sie anfordern können, finden Sie unter Berichtstypen. Eine vollständige Liste der Berichtsparameter, die Sie festlegen können, finden Sie unter jedem Berichtsanforderungsobjekt und dem ReportRequest-Basisobjekt .
Informationen zum Anfordern und Herunterladen eines Berichts finden Sie unter Anfordern und Herunterladen eines BerichtsWenn der Bericht erfolgreich abgeschlossen wurde, können Sie den Bericht von der URL herunterladen, die der Dienst zurückgibt. Die Berichtsdatei ist komprimiert, sodass Sie die Datei entzippen müssen, um den Bericht zu lesen. Die Anzahl der Berichte, die das System speichern kann, ist nicht begrenzt. Die Dauer, in der die Berichte gespeichert werden, ist jedoch nicht definiert. Der Dienst überprüft nicht auf doppelte Berichtsanforderungen.
Informationen dazu, wie sich die Zeitzone auf die Verfügbarkeit von Berichten auswirkt, finden Sie unten unter Zeitzonen in der Berichterstellung .
Berichtsdateischema
Sie können CSV-, TSV- oder XML-Berichtsdaten anfordern. Wenn Sie kein anderes Format auswählen, sind die heruntergeladenen Daten standardmäßig kommagetrennt (CSV).
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 10:15:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 10:15:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 5"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"@2020 Microsoft Corporation. All rights reserved. "
Die folgenden Berichtsheadermetadaten sind standardmäßig enthalten. Wenn Sie die Headermetadaten nicht möchten, legen Sie ExcludeReportHeader auf true fest.
| Headermetadaten | Beschreibung |
|---|---|
| Berichtname | Der ReportName , den Sie beim Übermitteln des Berichts ausgewählt haben. |
| Berichtszeit | Die Berichtszeit, die Sie beim Übermitteln des Berichts ausgewählt haben. Wenn mehrere Tage angefordert wurden, werden das Start- und Enddatum durch ein Komma getrennt, z. B. "Berichtszeit: 01.02.2020, 07.02.2020". |
| Zeitzone | Gibt an, welche Zeitzone verwendet wurde, um das Ende des letzten Tages der angeforderten Berichtszeit zu bestimmen. Informationen dazu, wie sich die Zeitzone auf die Verfügbarkeit von Berichten auswirkt, finden Sie unten unter Zeitzonen in der Berichterstellung . |
| Letzter abgeschlossener verfügbarer Tag | Das letzte Datum und die letzte Uhrzeit, zu der Microsoft Advertising die Verarbeitung von Daten für diesen Berichtstyp abgeschlossen hat. Die Uhrzeit wird immer relativ zur UTC gemeldet. Ignorieren Sie daher das Suffix (GMT), das im Bericht geschrieben ist. |
| Letzte abgeschlossene verfügbare Stunde | Das letzte Datum und die letzte Uhrzeit, zu der Microsoft Advertising die Verarbeitung von Daten für diesen Berichtstyp abgeschlossen hat. Die Uhrzeit wird immer relativ zur UTC gemeldet. Ignorieren Sie daher das Suffix (GMT), das im Bericht geschrieben ist. |
| Berichtsaggregation | Gibt den Aggregationstyp an, der in der Berichtsanforderung festgelegt wurde. Weitere Informationen finden Sie weiter unten unter Aggregation und Zeit . |
| Berichtsfilter | Reserviert für zukünftige Verwendung. |
| Potenziell unvollständige Daten | Wenn diese Einstellung auf true festgelegt ist, werden die Berichtsdaten möglicherweise nicht vollständig für den letzten Tag der angeforderten Berichtszeit verarbeitet. Das Anforderungselement ReturnOnlyCompleteData bestimmt, ob der Dienst sicherstellen muss, dass alle Daten verarbeitet wurden und verfügbar sind. Informationen dazu, wie sich die Zeitzone auf die Verfügbarkeit von Berichten auswirkt, finden Sie unten unter Zeitzonen in der Berichterstellung . |
| Zeilen | Die Anzahl der Berichtsdatensatzdaten ohne Leerzeilenheader, Spaltennamen und Fußzeilenmetadaten. Diese Metadaten sind in XML-Berichten nicht verfügbar. |
Die Berichtsspaltennamen, z. B. "AccountId", "CampaignId", "Keyword", "KeywordId", "DeviceType", "Clicks" sind standardmäßig enthalten. Wenn Sie die Berichtsspalten nicht möchten, legen Sie ExcludeColumnHeaders auf true fest.
Die Metadaten der Berichtsfußzeile, z. B. @2020 Microsoft Corporation. Alle Rechte vorbehalten. ist standardmäßig enthalten. Wenn Sie die Fußzeilenmetadaten nicht möchten, legen Sie ExcludeReportFooter auf true fest.
Version des Berichtsformats
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 das optionale FormatVersion-Anforderungsfeld festlegen. In der folgenden Tabelle wird der Unterschied zwischen Formatversion 1.0 und 2.0 zusammengefasst.
| Beschreibung | Berichtsspalten | FormatVersion 1.0-Beispiel | FormatVersion 2.0-Beispiel |
|---|---|---|---|
| Das Tausendergruppentrennzeichen (Komma) wird entfernt. | AllRevenue Unterstützt ExtendedCost Einnahmen |
1,000.00 | 1000.00 |
| Die Genauigkeit wird von 4 Auf 2 Ziffern aktualisiert. | LowQualityClicksPercent LowQualityImpressionsPercent Ptr |
12.3400 | 12.34 |
| Die Genauigkeit wird von 0 auf 2 Ziffern aktualisiert. | AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent |
12 | 12.34 |
| Das Stündliche Berichtsformat wurde von "mm/tt/jjjj 12:00:00 Uhr|Stunde" auf "yyyy-mm-tt|hour" aktualisiert. Dieses Format gilt nur für die Spalte TimePeriod , wenn die Berichtsaggregation auf Stündlich festgelegt ist. | Zeitfenster | "15.03.2020 12:00:00|7" | "2020-03-15|7" |
Spalten, die die Daten gruppieren
Die Attributspalten, die Sie in einen Bericht einschließen, wirken sich auf die Werte in den Statistikspalten sowie auf die Anzahl oder die Zeilen aus. Wenn Sie beispielsweise einen Zusammenfassungsbericht anfordern, der nur AccountId, CampaignId, Keyword, KeywordId und Clicks enthält, enthält die Spalte clicks die Anzahl der Klicks für die Schlüsselwort (keyword) unabhängig von ausgeschlossenen Attributen wie Gerät, Übereinstimmungstyp und Netzwerk.
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 3"
"AccountId","CampaignId","Keyword","KeywordId","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","95"
"YourAccountId","YourCampaignId","shoes delivered","234","1"
"YourAccountId","YourCampaignId","shoe sale","345","98"
"@2020 Microsoft Corporation. All rights reserved. "
Wenn Sie dann die Spalte DeviceType einschließen, enthält der Bericht eine Zeile für jede eindeutige Kombination aus werten Schlüsselwort (keyword) und Gerätetyp, und der Wert in der Spalte "Klicks" für jede Zeile wird entsprechend aufgeschlüsselt.
"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 7"
"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","red shoes","123","Tablet","10"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"YourAccountId","YourCampaignId","shoe sale","345","Tablet","13"
"@2020 Microsoft Corporation. All rights reserved. "
Weitere Informationen zu den einzelnen verfügbaren Spaltentypen finden Sie unter Berichtsattribute und Leistungsstatistiken.
Das TimePeriod-Attribut ist für die meisten Berichte erforderlich. Daher sollten Sie auch berücksichtigen, dass die Angabe eines präziseren Aggregationszeitraums, z. B. monatlich im Aggregation-Element der Berichtsanforderung, die Klickdaten nach Monat weiter aufschlüsselt. Der Bericht würde dann beispielsweise eine Zeile für jede eindeutige Kombination aus Schlüsselwort (keyword), Gerät und Monat enthalten. Die Zeile ist nur für Monate enthalten, die Klicks enthalten.
Spalteneinschränkungen
Für Berichte, die Leistungsstatistikspalten für impression share enthalten, können Sie keine eingeschränkten Attribute in dieselbe Berichtsanforderung einschließen. Wenn Sie eine der Leistungsstatistikspalten für impression share einschließen, müssen Sie alle folgenden Attributspalten ausschließen. Ebenso müssen Sie, wenn Sie eine der folgenden Attributspalten einschließen, alle Leistungsstatistikspalten der Impression Share ausschließen.
Die folgenden Attribut- und Impression Share-Leistungsstatistikenspalten schließen sich beim Übermitteln von AccountPerformanceReportRequest und AdGroupPerformanceReportRequest gegenseitig aus.
Hinweis
Wenn Sie außerdem eine der Spalten AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent oder RelativeCtr einschließen, müssen Sie die Attributspalten CustomerId, CustomerName und DeliveredMatchType ausschließen und umgekehrt.
| Attribute | Impression Share Performance Statistics |
|---|---|
| BidMatchType DeviceOS Ziel GoalType TopVsWeitere |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr |
Die folgenden Attribut- und Impression Share-Leistungsstatistikenspalten schließen sich beim Übermitteln von CampaignPerformanceReportRequest gegenseitig aus.
Hinweis
Wenn Sie außerdem eine der Spalten AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent oder RelativeCtr einschließen, müssen Sie die Attributspalten CustomerId, CustomerName und DeliveredMatchType ausschließen und umgekehrt.
| Attribute | Impression Share Performance Statistics |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS Ziel GoalType TopVsWeitere |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
Die folgenden Attribute sind beim Übermitteln von HotelDimensionPerformanceReportRequest eingeschränkt.
| Attribute |
|---|
| AdId |
Die folgenden Attribute sind beim Übermitteln von HotelGroupPerformanceReportRequest eingeschränkt.
| Attribute |
|---|
| AdId |
Die folgenden Leistungsstatistiken für Attribute und Impression Share schließen sich beim Übermitteln von ProductDimensionPerformanceReportRequest gegenseitig aus.
| Attribute | Impression Share Performance Statistics |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId Ziel GoalType Sprache LocalStoreCode Netzwerk TopVsWeitere |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
Die folgenden Attribut- und Impression Share-Leistungsstatistikenspalten schließen sich beim Übermitteln von ProductPartitionPerformanceReportRequest gegenseitig aus.
| Attribute | Impression Share Performance Statistics |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType Ziel GoalType Sprache LocalStoreCode Netzwerk TopVsWeitere |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
Spalte "Zeitraum"
Wenn Sie die Spalte TimePeriod einschließen, variiert das Format der Werte im heruntergeladenen Bericht je nach der Berichtsaggregationsstufe , die Sie in der Berichtsanforderung angeben. Wenn die Aggregationsebene beispielsweise Täglich ist, enthält jedes Feld in der Spalte TimePeriod den Tag, der als jjjj-mm-tt formatiert ist.
Hinweis
Die partielle Datenaggregation für wöchentliche, monatliche und jährliche Zeitraumspalten wird nicht unterstützt. Wenn es sich bei den ausgewählten Datumsangaben nicht um vollständige Wochen/Monate/Jahre handelt und die entsprechende Spalte für wöchentliche/monatliche/jährliche Zeiträume angefordert wird, werden die ausgewählten Datumsangaben in vollständige Wochen/Monate/Jahre konvertiert.
| Aggregation | Beschreibung |
|---|---|
| Täglich | Jede Zeile des Berichts identifiziert den Monat, den Tag und das Jahr, in dem die Transaktion stattgefunden hat. Die Berichtsdaten werden täglich aggregiert. Der Zeitraum wird als jjjj-mm-tt formatiert. |
| DayOfWeek | Jede Zeile des Berichts gibt den Wochentag an, an dem die Transaktion stattgefunden hat. Die Berichtsdaten werden an jedem der sieben Tage in einer Woche aggregiert. Die möglichen Datenwerte sind 1 - 7 , wobei 1 den Sonntag und 7 den Samstag darstellt. Wenn der Bericht mehrere Wochen umfasst, werden die Leistungsdaten über alle Wochen für einen bestimmten Wochentag in einer Zeile aggregiert. Wenn Kampagne A beispielsweise jeden Montag (Tag 2) während jeder der drei im Berichtszeitbereich enthaltenen Wochen 5 Aufrufe aufweist, enthält der Bericht eine Zeile mit einer 2 in der Spalte TimePeriod und die Aufrufe in dieser Zeile insgesamt 15. |
| Stündlich | Jede Zeile des Berichts gibt die Stunde an, zu der die Transaktion stattgefunden hat. Die Berichtsdaten werden nach jeder Stunde des Tages aggregiert. Standardmäßig wird der Zeitraum mit dem Datum und der Stunde (int-Wert) formatiert, die durch eine einzelne Pipe getrennt sind, d. h. "mm/tt/jjjj 12:00:00 AM|hour", wobei 12:00:00 AM ignoriert werden kann. Wenn der Klick beispielsweise am 15. März 2020 zwischen 07:00 und 08:00 Uhr erfolgt ist, lautet das Feld im heruntergeladenen Bericht "15.03.2020 12:00:00 Uhr|7". Wenn Sie den Bericht FormatVersion auf "2.0" festlegen, wird der Zeitraum als "yyyy-mm-tt|hour" formatiert. Wenn der Klick beispielsweise am 15. März 2020 zwischen 07:00 und 08:00 Uhr erfolgt ist, lautet das Feld im heruntergeladenen Bericht "2020-03-15|7". Die möglichen Werte für die Stundenkomponente sind 0 - 23. Wenn der Bericht mehrere Tage umfasst, werden die Leistungsdaten für eine bestimmte Stunde separat über mehrere Zeilen hinweg bereitgestellt, d. h. der Bericht enthält eine Zeile für jeden eindeutigen Tag und jede stunde. Wenn Kampagne A z. B. während Stunde 7 an jedem der 3 Tage, die im Berichtszeitbereich enthalten sind, 5 Aufrufe aufweist, enthält der Bericht drei Zeilen mit jeweils 5 Aufrufen für Stunde 7. |
| Hourofday | Jede Zeile des Berichts gibt die Stunde des Tages an, an der die Transaktion stattgefunden hat. Die Berichtsdaten werden für jeden der 24 Stunden über alle Tage hinweg aggregiert. Die möglichen Werte sind 0 - 23. Wenn der Bericht mehrere Tage umfasst, werden die Leistungsdaten über alle Tage für eine bestimmte Stunde in einer Zeile aggregiert. Wenn Kampagne A beispielsweise während stunde 7 an jedem der drei Tage, die im Berichtszeitbereich enthalten sind, 5 Aufrufe aufweist, enthält der Bericht eine Zeile mit Impressionen für HourOfDay von insgesamt 15. |
| Monatlich | Jede Zeile des Berichts gibt den Monat an, in dem die Transaktion stattgefunden hat. Die Berichtsdaten werden nach jedem Monat aggregiert. Der Zeitraum, der den ersten Tag des Monats enthält, wird als jjjj-mm-tt formatiert. |
| Wöchentlich | Jede Zeile des Berichts gibt die Woche an, in der die Transaktion stattgefunden hat. Die Berichtsdaten werden pro Woche aggregiert. Der Zeitraum, der das Datum des Sonntags für jede Woche enthält, wird als jjjj-mm-tt formatiert. |
| Jährlich | Jede Zeile des Berichts gibt das Jahr an, in dem die Transaktion stattgefunden hat. Die Berichtsdaten werden nach jedem Jahr aggregiert. Der Zeitraum, der das Jahr enthält, wird als jjjj formatiert. |
Aggregation und Zeit
Für die meisten Berichtsanforderungen müssen Sie die Elemente Aggregation und Time festlegen. Im Folgenden finden Sie die Zeiträume, die Sie für jeden Aggregationswert angeben können.
| Aggregationswert | Zeiträume |
|---|---|
| Täglich | Heute Gestern LastSevenDays ThisMonth LastMonth Benutzerdefinierter Datumsbereich |
| DayOfWeek | Heute Gestern LastSevenDays ThisMonth LastMonth LastThreeMonths LastSixMonths |
| Stündlich | Heute Gestern Benutzerdefinierter Datumsbereich |
| Hourofday | Heute Gestern LastSevenDays ThisMonth LastMonth LastThreeMonths LastSixMonths |
| Monatlich | ThisMonth LastMonth LastThreeMonths LastSixMonths ThisYear Letztes Jahr Benutzerdefinierter Datumsbereich |
| Zusammenfassung | Heute Gestern LastSevenDays ThisMonth LastMonth Benutzerdefinierter Datumsbereich |
| Wöchentlich | ThisWeek Letzte Woche LastFourWeeks ThisMonth LastMonth ThisYear Letztes Jahr Benutzerdefinierter Datumsbereich |
| Jährlich | ThisYear Letztes Jahr Benutzerdefinierter Datumsbereich |
Null Impressionen
Die Berichtsdaten können Zeilen mit null Impressionen enthalten, wenn der Eindruck vor dem angeforderten Zeitraum aufgetreten ist und dann eine nachfolgende Aktion wie Klick, Konvertierung oder Telefonanruf während des angeforderten Zeitraums erfolgt. Ebenso ist es auch innerhalb des angeforderten Zeitraums möglich, wenn Sie in der letzten Woche einen täglichen Leistungsbericht herunterladen, dass alle Aufrufe am Sonntag aufgetreten sind und dann Klicks oder andere Leistungen wie Montag oder Dienstag aufgetreten sind. Die Berichtsdaten für Montag oder Dienstag können Klicks mit null Aufrufen aufweisen. Sie können den Massendienst oder den Kampagnenverwaltungsdienst verwenden, um alle Entitäten in Ihrem Konto abzurufen, unabhängig davon, ob ihnen Leistungsdaten zugeordnet sind oder nicht.
Zeitzonen in der Berichterstellung
Die heruntergeladenen Berichtsdaten sind immer relativ zur UTC-Zeit. Beispielsweise kann ein stündliche Bericht 5 Klicks der Stunde 7 zuordnen. In diesem Fall erfolgten die fünf Klicks zwischen 07:00 und 08:00 UHR UTC.
Das Anforderungselement ReportTimeZone bestimmt die Zeitzone, die zum Festlegen des heutigen Datums verwendet wird. Wenn Sie die Berichtsanforderung übermitteln, kann das heutige Datum je nach Zeitzone weltweit variieren. Der berichtsbezogene Zeitraum, den Sie z. B. "Gestern" auswählen, ist dann relativ zum heutigen Datum. Wenn Sie keine Zeitzone auswählen, verwendet der Berichtsdienst standardmäßig PacificTimeUSCanadaTijuana. Beispielsweise wird ein Bericht, der ohne eine Zeitzone angefordert wurde, die am 2.02.2020 um 2:00 Uhr EasternTimeUSCanada für "Yesterday" angegeben ist, als Anforderung für den 31.01.2020 interpretiert. Ein gleichzeitig für "Yesterday" angeforderter Bericht mit der Zeitzone EasternTimeUSCanada wird als Anforderung für den 01.02.2020 interpretiert.
Das Anforderungselement ReturnOnlyCompleteData bestimmt, ob der Dienst sicherstellen muss, dass alle Daten verarbeitet wurden und verfügbar sind. Bei Festlegung auf true und wenn das System die Verarbeitung aller Daten basierend auf der angeforderten Aggregation, dem Umfang 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. Während der heutigen Zeit können Sie die aktuellsten Daten abrufen, indem Sie keine vollständigen Daten anfordern. Nachdem die Bücher für den Tag geschlossen wurden, können Sie dieses Flag auf "true" festlegen und auf das zurückblicken, was jetzt "Gestern" ist, und die endgültigen Berichtsdaten abrufen.
Hinweis
Wenn Sie einen Bericht für Kampagnen mit unterschiedlichen Zeitzonen anfordern, gelten die Daten erst als vollständig, nachdem der Tag abgelaufen ist und die Klickdaten in allen Kampagnenzeitzonen verarbeitet wurden. Angenommen, Sie fordern einen Bericht an, der Kampagne A (die die PST-Zeitzone angibt) und Kampagne B (die die EST-Zeitzone angibt) enthält, sind die Daten erst vollständig, wenn alle Klickdaten für Kampagne A für den angegebenen Zeitraum verarbeitet wurden.
Wenn ein Benutzer auf eine Anzeige klickt, kann es bis zu zwei Stunden dauern, bis das System den Klick verarbeitet (3 Stunden für Konvertierungen) und für die Berichterstellung zur Verfügung stellt. Daten gelten im Allgemeinen als vollständig, wenn Bücher nach 3 Stunden geschlossen werden. In einigen Ausnahmefällen aufgrund von ungültigem Datenverkehr kann es zu unerwarteten Anpassungen kommen, die mindestens eine Woche dauern können. Wenn beispielsweise eine Inserentenbeschwerde ungültige Klickaktivitäten identifiziert, die dem automatisierten Filtersystem entgangen sind, verarbeiten die Traffic Quality- und Supportteams eine Gutschrift auf das Konto des Inserenten und arbeiten mit internen Teams zusammen, um zu ermitteln, ob sie automatisierte Systeme aktualisieren können, um die Erkennung in Zukunft zu verbessern. Weitere Informationen finden Sie unter Traffic Quality Center.
MRC-akkreditierte Metriken
Die Metrik "Search Ads Clicks" ist vom Media Rating Council (MRC) akkreditiert; diese Akkreditierung gilt nicht für andere Metriken. Weitere Informationen finden Sie in der Click-Messbeschreibung der Methodik .
Siehe auch
Berichtsattribute und Leistungsstatistiken
Berichtstypen
Anfordern und Herunterladen eines Berichts
Adressen des Bing Ads-API-Webdiensts