Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Berichtsdienst enthält die Vorgänge, mit denen Sie Berichtsanforderungen übermitteln und deren Status abfragen. Die Berichte enthalten detaillierte Statistiken zu Microsoft Advertising-Konten, -Kampagnen und -Anzeigengruppen. Die Informationen können Ihnen helfen, Ihre Finanzen zu verfolgen, die Anzeigen-Performance zu messen und Einstellungen anzupassen, um Ihr Budget oder Ihre Kampagne zu optimieren. Sie können beispielsweise den Bericht zur Schlüsselwort-Leistung (Keyword) verwenden, um zu sehen, welche Keywords eine gute Performance aufweisen und welche nicht.
Reporting Service – Übersicht
Wenn Sie eine Berichtsanforderung übermitteln, wählen Sie die Berichtsattribute und Leistungsstatistiken aus, um den Inhalt des Berichts zu bestimmen. Beispielsweise können Sie Impressionen, Klicks und die Klickrate einbeziehen. Der Bericht verwendet die Spaltennamen als Spaltenüberschriften. Der Bericht enthält die Spalten in derselben Reihenfolge, in der Sie sie in das Spaltenelement der Berichtsanforderung aufnehmen. Informationen dazu, wie sich Spalten auf die Datenausgabe auswirken, finden Sie unter Spalten, die die Daten unten gruppieren . Informationen zu Einschränkungen für Spaltenkombinationen in derselben Berichtsanforderung finden Sie unten unter Spalteneinschränkungen .
Sie geben auch die Berichtsparameter an, die den zurückgegebenen Datensatz einschränken oder begrenzen. Sie können die Aggregationsebene beispielsweise 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 Datumsangaben 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 Sie Filterkriterien zum Filtern der Berichtsdaten fest. Informationen zu Zeiträumen, die Sie für jeden Aggregationswert angeben können, finden Sie 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 in den einzelnen Berichtsanforderungsobjekten und im 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. Da die Berichtsdatei komprimiert ist, müssen Sie die Datei entpacken, um den Bericht zu lesen. Die Anzahl der Berichte, die das System speichern kann, ist unbegrenzt. Die Zeitspanne, 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 weiter unten unter Zeitzonen in der Berichterstellung .
Schema der Berichtsdatei
Sie können CSV-, TSV- oder XML-Berichtsdaten anfordern. Wenn Sie kein anderes Format auswählen, werden die heruntergeladenen Daten standardmäßig durch Kommas getrennt (CSV) heruntergeladen.
"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 Berichtskopfmetadaten sind standardmäßig enthalten. Wenn Sie die Headermetadaten nicht möchten, legen Sie ExcludeReportHeader auf true fest.
| Headermetadaten | Beschreibung |
|---|---|
| Berichtname | Der ReportName , den Sie bei der Übermittlung des Berichts ausgewählt haben. |
| Berichtszeit | Die Berichtszeit, die Sie bei der Übermittlung des Berichts ausgewählt haben. Wenn mehrere Tage angefordert wurden, werden 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 weiter unten unter Zeitzonen in der Berichterstellung . |
| Letzter abgeschlossener verfügbarer Tag | Das letzte Datum und die Uhrzeit, zu dem Microsoft Advertising die Verarbeitung der Daten für diesen Berichtstyp abgeschlossen hat. Die Zeit wird immer relativ zur UTC gemeldet, daher ignorieren Sie bitte das ( GMT)- Suffix, das im Bericht steht. |
| Zuletzt abgeschlossene verfügbare Stunde | Das letzte Datum und die Uhrzeit, zu dem Microsoft Advertising die Verarbeitung der Daten für diesen Berichtstyp abgeschlossen hat. Die Zeit wird immer relativ zur UTC gemeldet, daher ignorieren Sie bitte das ( GMT)- Suffix, das im Bericht steht. |
| Berichtsaggregation | Spiegelt den Aggregationstyp wider, der in der Berichtsanforderung festgelegt wurde. Weitere Informationen finden Sie unten unter Aggregation und Zeit . |
| Berichtsfilter | Reserviert für zukünftige Verwendung. |
| Potenziell unvollständige Daten | Wenn festgelegt auf true , werden die Berichtsdaten für den letzten Tag der angeforderten Berichtszeit möglicherweise nicht vollständig verarbeitet. Das ReturnOnlyCompleteData-Anforderungselement 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 weiter unten unter Zeitzonen in der Berichterstellung . |
| Zeilen | Die Anzahl der Berichtsdatensatzdaten ohne leere Zeilen Kopf-, Spaltennamen und Fußzeilenmetadaten. Diese Metadaten sind in XML-Berichten nicht verfügbar. |
Die Namen der Berichtsspalten, z. B. "Konto-ID", "Kampagnen-ID", "Schlüsselwort", "Schlüsselwort", "Schlüsselwort-ID", "Gerätetyp", "Klicks", sind standardmäßig enthalten. Wenn Sie die Berichtsspalten nicht verwenden 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 aktuelle Datenformat abrufen, indem Sie das optionale FormatVersion-Anforderungsfeld festlegen. In der folgenden Tabelle sind die Unterschiede zwischen den Formatversionen 1.0 und 2.0 zusammengefasst.
| Beschreibung | Berichtsspalten | Beispiel für FormatVersion 1.0 | FormatVersion 2.0 (Beispiel) |
|---|---|---|---|
| Das Gruppentrennzeichen (Komma) für Tausender wird entfernt. | AllRevenue Assists ExtendedCost Umsatz |
1,000.00 | 1000.00 |
| Die Genauigkeit wird von 4 Ziffern auf 2 Ziffern aktualisiert. | LowQualityClicksPercent LowQualityImpressionsPercent PTR |
12.3400 | 12.34 |
| Die Genauigkeit wird von 0 Ziffern auf 2 Ziffern aktualisiert. | AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent |
12 | 12.34 |
| Das stündliche Berichtsformat wurde von "tt/mm/jjjj 12:00:00 Uhr|Stunde" auf "jjjj-mm-tt|Stunde" aktualisiert. Dieses Format gilt nur für die Spalte "TimePeriod", wenn die Berichtsaggregation auf "Stündlich" festgelegt ist. | TimePeriod | "3/15/2020 12:00:00 AM|7" | "2020-03-15|7" |
Spalten, in denen die Daten gruppiert werden
Die Attributspalten, die Sie in einen Bericht aufnehmen, wirken sich sowohl auf die Werte in den Statistikspalten als auch auf die Anzahl oder Zeilen aus. Wenn Sie beispielsweise einen Zusammenfassungsbericht anfordern, der nur Konto-ID, Kampagnen-ID, Schlüsselwort, Schlüsselwort-ID und Klicks enthält, enthält die Spalte "Klicks" die Anzahl der Klicks für das Schlüsselwort (Keyword) unabhängig von ausgeschlossenen Attributen wie Gerät, Match-Option 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 "Gerätetyp" einschließen, enthält der Bericht eine Zeile für jede eindeutige Kombination von Schlüsselwort (Schlüsselwort (Keyword)- und Gerätetypwerten, 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 Aggregationselement der Berichtsanforderung, die Klickdaten weiter nach Monaten aufschlüsseln würde. Der Bericht enthält dann beispielsweise eine Zeile für jede eindeutige Kombination aus Schlüsselwort (Keyword), Gerät und Monat. Die Zeile ist nur für Monate enthalten, die Klicks enthalten.
Einschränkungen für Spalten
Bei Berichten, die Spalten mit Statistiken zum Anteil der Impressionen enthalten, können Sie eingeschränkte Attribute nicht in dieselbe Berichtsanforderung aufnehmen. Wenn Sie eine der Spalten mit der Performance-Statistik für den Anteil der Impressionen einschließen, müssen Sie alle nachfolgend aufgeführten Attributspalten ausschließen. Wenn Sie eine der unten aufgeführten Attributspalten einschließen, müssen Sie auch alle Spalten mit der Performance-Statistik für den Anteil der Impressionen ausschließen.
Die folgenden Spalten für die Attribut- und Impressionsanteil-Performancestatistiken 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 | Performance-Statistiken zum Anteil der Aufrufe |
|---|---|
| BidMatchType GeräteBetriebssystem Ziel GoalType TopVsSonstiges |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr |
Die folgenden Spalten für die Attribut- und Impressions-Share-Performance-Statistiken schließen sich beim Senden der 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 | Performance-Statistiken zum Anteil der Aufrufe |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus GeräteBetriebssystem Ziel GoalType TopVsSonstiges |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
Die folgenden Attribute sind beim Senden der HotelDimensionPerformanceReportRequest eingeschränkt.
| Attribute |
|---|
| AdId |
Die folgenden Attribute sind beim Senden der HotelGroupPerformanceReportRequest eingeschränkt.
| Attribute |
|---|
| AdId |
Die folgenden Spalten für die Attribut- und Impressions-Share-Performance-Statistiken schließen sich beim Senden der ProductDimensionPerformanceReportRequest gegenseitig aus.
| Attribute | Performance-Statistiken zum Anteil der Aufrufe |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId Ziel GoalType Sprache LocalStoreCode Netzwerk TopVsSonstiges |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
Die folgenden Spalten für die Performance-Statistiken zu Attributen und Impressionen schließen sich beim Senden der ProductPartitionPerformanceReportRequest gegenseitig aus.
| Attribute | Performance-Statistiken zum Anteil der Aufrufe |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType Ziel GoalType Sprache LocalStoreCode Netzwerk TopVsSonstiges |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
Zeitraumspalte
Wenn Sie die TimePeriod-Spalte einschließen, variiert das Format der Werte im heruntergeladenen Bericht je nach Berichtsaggregationsebene , die Sie in der Berichtsanforderung angeben. Wenn die Aggregationsebene beispielsweise "Täglich" ist, enthält jedes Feld in der Spalte "Zeitperiode" den Tag im Format "JJJJ-MM-TT".
Hinweis
Wir unterstützen keine partielle Datenaggregation für wöchentliche, monatliche und jährliche Zeiträumespalten. Wenn die ausgewählten Datumsangaben nicht ganze Wochen/Monate/Jahre sind und die entsprechende Spalte für wöchentliche/monatliche/jährliche Zeiträume angefordert wird, werden die ausgewählten Datumsangaben in volle 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 für jeden Tag 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 für jeden der sieben Tage in einer Woche aggregiert. Die möglichen Datenwerte sind 1 - 7 , wobei 1 für Sonntag und 7 für Samstag steht. Wenn sich der Berichtszeitraum über mehrere Wochen erstreckt, werden die Leistungsdaten für alle Wochen für einen bestimmten Wochentag in einer Zeile aggregiert. Wenn z. B. Kampagne A jeden Montag (Tag 2) in jeder der 3 Wochen im Berichtszeitraum 5 Aufrufe verzeichnet, enthält der Bericht eine Zeile mit einer 2 in der Spalte "TimePeriod" und insgesamt 15 Impressionen in dieser Zeile. |
| Stündlich | Jede Zeile des Berichts gibt die Stunde an, in der die Transaktion stattgefunden hat. Die Berichtsdaten werden zu jeder Stunde des Tages aggregiert. Standardmäßig wird der Zeitraum so formatiert, dass Datum und Stunde (int-Wert) durch einen einzelnen senkrechten Strich getrennt sind, d. h. "mm/tt/jjjj 12:00:00 Uhr|Stunde", wobei 12:00:00 Uhr ignoriert werden kann. Wenn der Klick beispielsweise am 15. März 2020 zwischen 07:00 und 08:00 Uhr erfolgte, lautet das Feld im heruntergeladenen Bericht "15.03.2020 12:00:00 Uhr|7". Wenn Sie die FormatVersion des Berichts auf "2.0" festlegen, wird der Zeitraum als "jjjj-mm-tt|Stunde" formatiert. Wenn der Klick beispielsweise am 15. März 2020 zwischen 07:00 und 08:00 Uhr erfolgte, lautet das Feld im heruntergeladenen Bericht "2020-03-15|7". Die möglichen Werte für die Stundenkomponente sind 0 - bis 23. Wenn sich der Berichtszeitraum über mehrere Tage erstreckt, werden die Leistungsdaten für eine bestimmte Stunde separat über mehrere Zeilen bereitgestellt, d. h. der Bericht enthält eine Zeile für jeden eindeutigen Tag und jede Stunde. Wenn z. B. Kampagne A an jedem der 3 Tage, die im Berichtszeitraum enthalten sind, fünf Aufrufe während der 7. Stunde hat, enthält der Bericht drei Zeilen mit jeweils 5 Impressionen für die 7. Stunde . |
| HourOfDay | Jede Zeile des Berichts gibt die Stunde des Tages an, zu der die Transaktion stattgefunden hat. Die Berichtsdaten werden nach jeder der 24 Stunden an allen Tagen aggregiert. Die möglichen Werte sind 0 - 23. Wenn sich der Berichtszeitraum über mehrere Tage erstreckt, werden die Leistungsdaten für alle Tage für eine bestimmte Stunde in einer Zeile aggregiert. Wenn beispielsweise Kampagne A an jedem der 3 Tage, die im Berichtszeitraum enthalten sind, fünf Impressionen während Stunde 7 hat, enthält der Bericht eine Zeile mit insgesamt 15 Impressionen für die StundeDes Tages . |
| Monatlich | Jede Zeile des Berichts identifiziert den Monat, in dem die Transaktion stattgefunden hat. Die Berichtsdaten werden nach Monat aggregiert. Der Zeitraum, der den ersten Tag des Monats umfasst, wird als jjjj-mm-tt formatiert. |
| Wöchentlich | Jede Zeile des Berichts identifiziert die Woche, in der die Transaktion stattgefunden hat. Die Berichtsdaten werden wöchentlich 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 identifiziert das Jahr, in dem die Transaktion stattgefunden hat. Die Berichtsdaten werden nach jedem Jahr aggregiert. Der Zeitraum, der das Jahr enthält, wird als yyyy formatiert. |
Aggregation und Zeit
Für die meisten Berichtsanforderungen müssen Sie die Elemente Aggregation und Zeit setzen. Die folgenden Zeiträume können Sie für jeden Aggregationswert angeben.
| Aggregationswert | Zeitabschnitte |
|---|---|
| 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 LastYear Benutzerdefinierter Datumsbereich |
| Zusammenfassung | Heute Gestern LastSevenDays ThisMonth LastMonth Benutzerdefinierter Datumsbereich |
| Wöchentlich | Diese Woche LastWeek LastFourWeeks ThisMonth LastMonth ThisYear LastYear Benutzerdefinierter Datumsbereich |
| Jährlich | ThisYear LastYear Benutzerdefinierter Datumsbereich |
Null Aufrufe
Die Berichtsdaten können Zeilen mit null Impressionen enthalten, wenn die Impression vor dem angeforderten Zeitraum erfolgt ist und eine nachfolgende Aktion wie Klicks, Abschlüsse oder Telefonanrufe während des angeforderten Zeitraums erfolgt. Ebenso ist es möglich, dass selbst innerhalb des angeforderten Zeitraums, wenn Sie einen täglichen Bericht für die Performance der letzten Woche herunterladen, alle Impressionen am Sonntag aufgetreten sind und dann Klicks oder andere Performance-Leistungen aufgetreten sind, z. B. Montag oder Dienstag. Die Berichtsdaten für Montag oder Dienstag enthalten möglicherweise Klicks ohne Aufrufe. 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 Berichten
Die heruntergeladenen Berichtsdaten beziehen sich immer auf die UTC-Zeit. Beispielsweise kann ein stündlicher Bericht 5 Klicks zu Stunde 7 zuordnen. In diesem Fall erfolgten die 5 Klicks zwischen 07:00 und 08:00 UTC.
Das ReportTimeZone-Anforderungselement 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 Berichtszeitraum, den Sie auswählen, z. B. "Gestern", ist dann relativ zum heutigen Datum. Wenn Sie keine Zeitzone auswählen, verwendet der Berichtsdienst standardmäßig PacificTimeUSCanadaTijuana. Beispielsweise wird ein Bericht, der ohne Zeitzone am 2.2.2.2020 für "Gestern" angefordert wurde, als Anforderung für den 31.01.2020 interpretiert. Ein zur gleichen Zeit für "gestern" angeforderte Bericht mit einer Zeitzone, die als EasternTimeUSCanada festgelegt ist, wird als Anforderung für den 01.02.2020 interpretiert.
Das ReturnOnlyCompleteData-Anforderungselement 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 die Verarbeitung aller Daten basierend auf der angeforderten Aggregation, dem Bereich und der Zeit abgeschlossen hat, gibt der Dienst den Fehlercode NoCompleteDataAvaliability (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. Der heutige Tag ist zwar noch in Bearbeitung, Sie können aber die aktuellsten Daten abrufen, indem Sie keine abgeschlossenen Daten anfordern. Wenn die Bücher für den Tag geschlossen sind, möchten Sie diese Flagge vielleicht auf "true" setzen und auf das zurückblicken, was jetzt "gestern" ist, und die Daten des Abschlussberichts abrufen.
Hinweis
Wenn Sie einen Bericht für Kampagnen mit unterschiedlichen Zeitzonen anfordern, werden die Daten erst dann als vollständig betrachtet, wenn der Tag abgelaufen ist und die Klickdaten in allen Zeitzonen der Kampagne verarbeitet wurden. Angenommen, Sie fordern einen Bericht an, der Kampagne A (die die PST-Zeitzone angibt) und Kampagne B (die die EST-Zeitzone enthält). Dann sind die Daten erst vollständig, wenn alle Klickdaten für Kampagne A im 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 Abschlüsse) und für Berichte verfügbar macht. Daten gelten im Allgemeinen als vollständig, wenn die Bücher nach 3 Stunden geschlossen werden. In einigen Ausnahmefällen kann es aufgrund von ungültigem Datenverkehr zu unerwarteten Anpassungen kommen, deren Lösung eine Woche oder länger dauern kann. Wenn beispielsweise eine Beschwerde eines Werbetreibenden ungültige Klickaktivitäten identifiziert, die das automatisierte Filtersystem verlassen haben, verarbeiten die Teams für Datenverkehrsqualität und Support eine Gutschrift für das Konto des Werbetreibenden und arbeiten mit internen Teams zusammen, um zu bestimmen, ob sie automatisierte Systeme aktualisieren können, um die Erkennung in Zukunft zu verbessern. Weitere Informationen finden Sie unter Center für Datenverkehrsqualität.
MRC-akkreditierte Metriken
Die Metrik für Suchanzeigenklicks ist vom Media Rating Council (MRC) akkreditiert. Diese Akkreditierung gilt nicht für andere Kennzahlen. Weitere Informationen finden Sie in der Beschreibung der Methodik zur Klickmessung .
Siehe auch
Berichtsattribute und Leistungsstatistiken
Berichtstypen
Bericht anfordern und herunterladen
Bing Ads API-Webdienstadressen