レポート サービスには、レポート要求の送信とその状態のポーリングに使用する操作が含まれています。 レポートには、Microsoft 広告アカウント、キャンペーン、広告グループに関する詳細な統計情報が表示されます。 情報は、財務の追跡、広告のパフォーマンスの測定、予算やキャンペーンの最適化のための設定の調整に役立ちます。 たとえば、キーワード (keyword) パフォーマンス レポートを使用して、パフォーマンスが良好で、パフォーマンスが良くないキーワードを確認できます。
Reporting Service の概要
レポート要求を送信するときに、[ レポート属性] と [パフォーマンス統計] を選択してレポートの内容を確認します。 たとえば、インプレッション、クリック、クリック率を含めることが良いかもしれません。 このレポートでは、列名が列ヘッダーとして使用されます。 このレポートには、レポート要求の [列 ] 要素に含めるのと同じ順序で列が含まれます。 列がデータ出力に与える影響については、以下の 「データをグループ化する列 」を参照してください。 同じレポート要求内の列の組み合わせに関する制限については、以下の 「列の制限 」を参照してください。
また、返されるデータ・セットを制限または制限するレポート・パラメーターも指定します。 たとえば、集計レベルを設定して、データを日または月ごとにグループ化できます。特定の日付や定義済みの日付範囲 (今日、過去 7 日間など) を使用して、レポートに含めるデータの期間を指定します。レポートに含めるアカウント、キャンペーン、広告グループを識別して、データの範囲を指定します。フィルター条件を設定して、レポート データをフィルター処理します。 各集計値に指定できる期間については、下の「 集計と時刻 」を参照してください。
リクエストできるレポートのリストについては、 レポート・タイプを参照してください。 設定できるレポート パラメーターの完全な一覧については、各レポート要求オブジェクトと ReportRequest ベース オブジェクトを参照してください。
レポートの要求とダウンロードの方法の詳細については、「 レポートの要求とダウンロード」を参照してください レポートが正常に完了すると、サービスから返される URL からレポートをダウンロードできます。 レポート ファイルは圧縮されているので、レポートを読み取るには、ファイルを解凍する必要があります。 システムが保存できるレポートの数に制限はありません。ただし、レポートが格納される期間は未定義です。 このサービスは、重複するレポート要求をチェックしません。
タイム ゾーンがレポートの可用性にどのように影響するかについては、以下の 「レポートのタイム ゾーン 」を参照してください。
レポート ファイル スキーマ
Csv、Tsv、または Xml レポート データを要求できます。 デフォルトでは、別の フォーマット を選択しない場合、ダウンロードされたデータはカンマ区切り (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. "
次のレポート ヘッダー メタデータは既定で含まれます。 ヘッダー メタデータを使用しない場合は、 ExcludeReportHeader を true に設定します。
| ヘッダー メタデータ | 説明 |
|---|---|
| レポート名 | レポートの送信時に選択した ReportName 。 |
| レポート時刻 | レポートの送信時に選択したレポート時刻。 複数の日が要求された場合、開始日と終了日はコンマで区切られます (例: レポート時刻: 2020/2/1、2/7/2020)。 |
| タイム ゾーン | 要求されたレポート時刻の最終日の終了を判断するために使用されたタイム ゾーンを示します。 タイム ゾーンがレポートの可用性にどのように影響するかについては、以下の 「レポートのタイム ゾーン 」を参照してください。 |
| 最後に完了した利用可能日 | Microsoft 広告がこのレポート タイプのデータの処理を完了した最新の日時。 時刻は常に UTC を基準にして報告されるため、レポートに記載されている (GMT) サフィックスは無視してください。 |
| 最終完了の利用可能時間 | Microsoft 広告がこのレポート タイプのデータの処理を完了した最新の日時。 時刻は常に UTC を基準にして報告されるため、レポートに記載されている (GMT) サフィックスは無視してください。 |
| レポートの集計 | レポート要求で設定された集計の種類を反映します。 詳細については、以下の「 集計と時刻 」を参照してください。 |
| レポート フィルター | 将来使用するために予約されています。 |
| 不完全なデータの可能性がある |
true に設定すると、要求されたレポート時間の最終日のレポート データが完全に処理されない可能性があります。 ReturnOnlyCompleteData 要求要素は、サービスがすべてのデータが処理され、使用可能であることを確認する必要があるかどうかを決定します。 タイム ゾーンがレポートの可用性にどのように影響するかについては、以下の 「レポートのタイム ゾーン 」を参照してください。 |
| 行 | 空白行、ヘッダー、列名、フッター メタデータを除くレポート レコード データの数。 このメタデータは、XML レポートでは使用できません。 |
レポート列名 ("AccountId"、"CampaignId"、"Keyword"、"KeywordId"、"DeviceType"、"Clicks" など) は既定で含まれます。 レポート列を使用しない場合は、 ExcludeColumnHeaders を true に設定します。
レポート フッターのメタデータ ( @2020 Microsoft Corporation など)All rights reserved. は既定で含まれています。 フッター メタデータを使用しない場合は、 ExcludeReportFooter を true に設定します。
レポート形式 バージョン
特定のフィールドのデータ形式は、既存のクライアント アプリケーションを中断することなく、現在の API バージョン内で更新できます。 省略可能な FormatVersion 要求フィールドを設定することにより、最新のデータ形式を取得できます。 次の表は、フォーマット バージョン 1.0 と 2.0 の違いをまとめたものです。
| 説明 | レポートの列 | FormatVersion 1.0 例 | FormatVersion 2.0 の例 |
|---|---|---|---|
| 桁区切り記号 (コンマ) は削除されました。 | AllRevenue アシスト ExtendedCost 収益 |
1,000.00 | 1000.00 |
| 精度は 4 桁から 2 桁に更新されます。 | LowQualityClicksPercent LowQualityImpressionsPercent ptr |
12.3400 | 12.34 |
| 精度は 0 桁から 2 桁に更新されます。 | AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent |
12 | 12.34 |
| 時間ごとのレポート形式が "mm/dd/yyyy 12:00:00 AM|hour" から "yyyy-mm-dd|hour" に更新されました。 この形式は、レポートの集計が 1 時間単位に設定されている場合にのみ、[期間] 列に適用されます。 | 期間 | "3/15/2020 12:00:00 AM|7" | "2020-03-15|7" |
データをグループ化する列
レポートに含める属性列は、統計列内の値だけでなく、数値や行にも影響します。 たとえば、アカウント ID、キャンペーン ID、キーワード、キーワード ID、クリック数のみを含む概要レポートを要求する場合、デバイス、マッチ タイプ、ネットワークなどの除外される属性に関係なく、クリック数列にはキーワード (keyword)のクリック数が含まれます。
"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. "
その後、デバイス タイプ列を含めると、レポートにはキーワード (keyword)とデバイス タイプの値の一意の組み合わせそれぞれの行が含まれ、各行のクリック数列の値がそれに従って分割されます。
"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. "
使用可能な列の各タイプの詳細については、「 レポート属性とパフォーマンス統計」を参照してください。
TimePeriod 属性はほとんどのレポートに必要なので、レポート要求の集計要素でより詳細な集計期間 (月次など) を指定すると、クリック データが月別にさらに分割されることも考慮する必要があります。 たとえば、レポートには、キーワード (keyword)、デバイス、月の一意の組み合わせごとに行が含まれます。 行は、クリックが含まれている月にのみ含まれます。
列の制限
インプレッション シェアのパフォーマンス統計列を含むレポートの場合、同じレポート要求に制約付き属性を含めることはできません。 インプレッション シェアのパフォーマンスの統計列のいずれかを含める場合は、以下の属性列をすべて除外する必要があります。 同様に、以下の属性列のいずれかを含める場合は、インプレッション シェア パフォーマンスの統計列をすべて除外する必要があります。
次の属性とインプレッション シェアのパフォーマンス統計列は、 AccountPerformanceReportRequest と AdGroupPerformanceReportRequest を送信する場合、相互に排他的です。
注:
さらに、AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent、または RelativeCtr 列のいずれかを含める場合は、CustomerId、CustomerName、DeliveredMatchType 属性列を除外する必要があります。その逆も同様です。
| 属性 | インプレッション シェア パフォーマンスの統計 |
|---|---|
| BidMatchType DeviceOS 目標 GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr |
次の属性とインプレッション シェアのパフォーマンス統計列は、 CampaignPerformanceReportRequest を送信する場合には相互に排他的です。
注:
さらに、AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent、または RelativeCtr 列のいずれかを含める場合は、CustomerId、CustomerName、DeliveredMatchType 属性列を除外する必要があります。その逆も同様です。
| 属性 | インプレッション シェア パフォーマンスの統計 |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS 目標 GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent ClickSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
HotelDimensionPerformanceReportRequest を送信する際には、次の属性が制限されます。
| 属性 |
|---|
| AdId |
HotelGroupPerformanceReportRequest を送信するときは、次の属性が制限されます。
| 属性 |
|---|
| AdId |
ProductDimensionPerformanceReportRequest を送信する場合、次の属性とインプレッション シェアのパフォーマンス統計列は相互に排他的です。
| 属性 | インプレッション シェア パフォーマンスの統計 |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId 目標 GoalType 言語 LocalStoreCode Network TopVsOther |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
次の属性とインプレッション シェアのパフォーマンス統計列は、 ProductPartitionPerformanceReportRequest を送信するときには相互に排他的です。
| 属性 | インプレッション シェア パフォーマンスの統計 |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType 目標 GoalType 言語 LocalStoreCode Network TopVsOther |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr ClickSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
期間列
期間 列を含め た場合、ダウンロードしたレポートの値の形式は、レポート要求で指定した レポート集計 レベルによって異なります。 たとえば、集計レベルが [毎日] の場合、[期間] 列の各フィールドには yyyy-mm-dd として書式設定された日が含まれます。
注:
週次、月次、年次の期間の列の部分的なデータ集計はサポートされていません。 選択した日付が週/月/年ではなく、対応する週/月/年の期間列が要求された場合、選択した日付は週/月/年に変換されます。
| 集計 | 説明 |
|---|---|
| 毎日 | レポートの各行には、トランザクションが発生した月、日、年が示されます。 レポート データは日単位で集計されます。 期間は yyyy-mm-dd として書式設定されます。 |
| DayOfWeek | レポートの各行には、トランザクションが発生した曜日が示されます。 レポート データは、1 週間の 7 日間ごとに集計されます。 使用できるデータは 1 - 7 です。 ここで、1 は日曜日、 7 は土曜日を表します。 レポートの時間が複数週にまたがる場合、特定の曜日のすべての週のパフォーマンス データが 1 つの行に集計されます。 たとえば、 キャンペーン A のインプレッションが、レポートの時間範囲に含まれる 3 週間のそれぞれを通して毎週月曜日 (2 日目) に 5 回の場合、レポートには、[期間] 列が 2 の 1 つの行と、その行の合計 15 のインプレッションが含まれます。 |
| 毎時 | レポートの各行には、トランザクションが発生した時刻が示されます。 レポート データは、1 日の各時間に集計されます。 既定では、期間は日付と時刻 (int 値) を 1 つのパイプで区切って書式設定されます (例: "mm/dd/yyyy 12:00:00 AM|hour")、12:00:00 AM は無視できます。 たとえば、クリックが 2020 年 3 月 15 日の 07:00 から 08:00 の間に発生した場合、ダウンロードしたレポートのフィールドは "3/15/2020 12:00:00 AM|7" になります。 レポートの FormatVersion を "2.0" に設定すると、期間は "yyyy-mm-dd|時間" として書式設定されます。 たとえば、クリックが 2020 年 3 月 15 日の 07:00 から 08:00 の間に発生した場合、ダウンロードしたレポートのフィールドは "2020-03-15|7" になります。 時間コンポーネントの有効な値は 0 - 23 です。 レポートの期間が複数日にまたがる場合、特定の時間のパフォーマンス データが複数の行に個別に提供されます。つまり、レポートには個別の曜日と時間ごとに 1 行が含まれます。 たとえば、 キャンペーン A のレポートの時間範囲に含まれる 3 日間のそれぞれについて、7 時間 目の間に 5 回のインプレッションがあった場合、レポートには 7 時間 に対して 5 回のインプレッションを含む 3 つの行が含まれます。 |
| HourOfDay | レポートの各行には、トランザクションが発生した時刻が示されます。 レポート データは、すべての日に対して 24 時間ごとに集計されます。 有効な値は 0 - 23 です。 レポートの時間が複数日にまたがる場合、特定の時間のすべての日のパフォーマンス データが 1 つの行に集計されます。 たとえば、レポートの時間範囲に含まれる 3 日間のそれぞれの 7 時間目の間にキャンペーン A のインプレッションが 5 回あった場合、レポートには HourOfDay のインプレッションの合計が 15 の行が 1 つ含まれます。 |
| 毎月 | レポートの各行には、トランザクションが発生した月が示されます。 レポート データは月ごとに集計されます。 月の最初の日を含む期間は、 yyyy-mm-dd として書式設定されます。 |
| Weekly (週単位) | レポートの各行には、トランザクションが発生した週が示されます。 レポート データは週ごとに集計されます。 各週の日曜日の日付を含む期間は、 yyyy-mm-dd として書式設定されます。 |
| 年に 1 回 | レポートの各行には、トランザクションが発生した年が示されます。 レポート データは年ごとに集計されます。 年を含む期間は yyyy として書式設定されます。 |
集計と時刻
ほとんどのレポート要求では、 集計 要素と 時刻 要素を設定する必要があります。 各集計値に指定できる期間を次に示します。
| 集計値 | 期間 |
|---|---|
| 毎日 | Today 昨日 LastSevenDays 今月 LastMonth ユーザー設定の日付範囲 |
| DayOfWeek | Today 昨日 LastSevenDays 今月 LastMonth LastThreeMonths LastSixMonths |
| 毎時 | Today 昨日 ユーザー設定の日付範囲 |
| HourOfDay | Today 昨日 LastSevenDays 今月 LastMonth LastThreeMonths LastSixMonths |
| 毎月 | 今月 LastMonth LastThreeMonths LastSixMonths ThisYear LastYear ユーザー設定の日付範囲 |
| 概要 | Today 昨日 LastSevenDays 今月 LastMonth ユーザー設定の日付範囲 |
| Weekly (週単位) | 今週 LastWeek LastFourWeeks 今月 LastMonth ThisYear LastYear ユーザー設定の日付範囲 |
| 年に 1 回 | ThisYear LastYear ユーザー設定の日付範囲 |
インプレッション 0
インプレッションが要求された期間より前に発生し、その後のアクション (クリック、コンバージョン、電話など) が要求された期間内に発生した場合、レポート データにはインプレッション数が 0 の行を含めることができます。 同様に、要求された期間内であっても、先週のパフォーマンスの日次レポートをダウンロードした場合、すべてのインプレッションが日曜日に発生し、その後クリックまたはその他のパフォーマンスが発生した可能性があります (月曜日または火曜日など)。 月曜日または火曜日のレポート データには、インプレッション数が 0 のクリックがある可能性があります。 一括サービスまたはキャンペーン管理サービスを使用すると、関連するパフォーマンス データがあるかどうかに関係なく、アカウント内のすべてのエンティティを取得できます。
レポートのタイム ゾーン
ダウンロードされるレポート データは常に UTC 時刻に関連しています。 たとえば、時間ごとのレポートでは、5 回のクリックが 7 時間に当てはまります。 この場合、5 回のクリックは 07:00 から 08:00 UTC の間に発生しました。
ReportTimeZone 要求要素は、今日の日付を確立するために使用されるタイム ゾーンを決定します。 通報要求を送信する際、今日の日付はタイム ゾーンによって世界各地で異なる場合があります。 レポートで選択した期間 (例: '昨日') は、今日の日付を基準にした期間になります。 タイム ゾーンを選択しない場合、レポート サービスでは既定で PacificTimeUSCanadaTijuana が使用されます。 たとえば、2020 年 2 月 2 日午前 2 時(米国東部時間)にタイム ゾーンを指定せずに要求されたレポートの '昨日' は、2020 年 1 月 31 日の要求として解釈されます。 タイム ゾーンが EasternTimeUSCanada に設定された 'Yesterday' の同時期のレポートは、2020 年 2 月 1 日の要求として解釈されます。
ReturnOnlyCompleteData 要求要素は、サービスがすべてのデータが処理され、使用可能であることを確認する必要があるかどうかを決定します。 true に設定されている場合、システムが要求された集計、スコープ、および時間に基づくすべてのデータの処理を完了していない場合、サービスはエラー コード NoCompleteDataAvaliable (2004) を返します。 それ以外の場合、既定では要求が成功する可能性があり、データが完了したかどうかは表示されず、レポートには要求時にシステムが処理を完了したデータのみが含まれます。 現在の作業はまだ進行中ですが、完了したデータを要求しないことで最新のデータを取得できます。 次に、その日の帳簿が決まった後に、このフラグを true に設定し、現在の '昨日' の状態を振り返って、最終的なレポート データを取得することができます。
注:
タイム ゾーンが異なるキャンペーンのレポートをリクエストした場合、その日が終了し、すべてのキャンペーンのタイム ゾーンでクリック データが処理された後にのみ、データが完了したと見なされます。 たとえば、キャンペーン A (PST タイム ゾーンを指定) とキャンペーン B (EST タイム ゾーンを指定) を含むレポートを要求するとします。キャンペーン A のすべてのクリック データが指定された期間に処理されるまで、データは完了しません。
ユーザーが広告をクリックすると、システムがそのクリックを処理してレポートできるようになるまでに、最長で 2 時間かかります (コンバージョンの場合は 3 時間)。 データは一般に完了したと見なされ、帳簿は 3 時間後に閉じます。 無効なトラフィックによる例外ケースでは、解決に 1 週間以上かかる予期しない調整が発生する可能性があります。 たとえば、広告主の苦情で、自動化されたフィルタリング システムから逃れた無効なクリック アクティビティが特定された場合、トラフィック クオリティ チームとサポート チームは広告主のアカウントに対するクレジットを処理し、将来の検出を改善できるように、内部チームと提携して自動化システムを更新できるかどうかを判断します。 詳細については、 トラフィック クオリティ センターをご覧ください。
MRC 認定メトリック
検索広告クリック数メトリックは、メディア レーティング カウンシル (MRC) の認定を受けています。この認定は、他の指標には適用されません。 詳細については、 手法のクリック測定の説明 をご覧ください。
関連項目
レポート属性とパフォーマンス統計
レポートの種類
レポートの要求とダウンロード
Bing 広告 API Web サービス アドレス