Reporting Service Model
Reporting サービスには、レポート要求を送信し、その状態をポーリングするために使用する操作が含まれています。 レポートには、Microsoft Advertising アカウント、キャンペーン、広告グループに関する詳細な統計情報が表示されます。 この情報は、財務の追跡、広告のパフォーマンスの測定、予算やキャンペーンの最適化のための設定の調整に役立ちます。 たとえば、キーワード パフォーマンス レポートを使用して、どのキーワードが適切に機能しているか、そうでないキーワードを確認できます。
Reporting Service の概要
レポート要求を送信するときは、[ レポート属性] と [パフォーマンス統計 ] を選択して、レポートの内容を決定します。 たとえば、インプレッション数、クリック数、クリック率を含めることができます。 レポートでは、列名が列ヘッダーとして使用されます。 レポートには、レポート要求の Columns 要素に含めるのと同じ順序で 列 が含まれます。 列がデータ出力にどのように影響するかについては、以下の「データ をグループ化する列 」を参照してください。 同じレポート要求での列の組み合わせに対する制限については、以下の 「列の制限 」を参照してください。
また、返されるデータ セットを制限または制限するレポート パラメーターも指定します。 たとえば、集計レベルを設定して、日または月別にデータをグループ化できます。特定の日付または定義済みの日付範囲 (今日や過去 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 日、2020 年 7 月 7 日)。 |
| タイム ゾーン | 要求されたレポート時刻の最終日の終了を決定するために使用されたタイム ゾーンを示します。 タイム ゾーンがレポートの可用性にどのように影響するかについては、以下の「 レポートのタイム ゾーン 」を参照してください。 |
| 最終完了利用可能日 | Microsoft Advertising がこのレポートの種類のデータの処理を完了した最新の日付と時刻。 時刻は常に UTC に対して報告されるため、レポートに書き込まれる (GMT) サフィックスは無視してください。 |
| 最後に完了した利用可能時間 | Microsoft Advertising がこのレポートの種類のデータの処理を完了した最新の日付と時刻。 時刻は常に UTC に対して報告されるため、レポートに書き込まれる (GMT) サフィックスは無視してください。 |
| レポートの集計 | レポート要求で設定された集計の種類を反映します。 詳細については、以下の 「集計と時刻 」を参照してください。 |
| レポート フィルター | 将来使用するために予約されています。 |
| 潜在的な不完全なデータ | true に設定すると、要求されたレポート時刻の最後の日にレポート データが完全に処理されない可能性があります。 ReturnOnlyCompleteData 要求要素は、サービスがすべてのデータが確実に処理され、使用可能であることを確認する必要があるかどうかを判断します。 タイム ゾーンがレポートの可用性にどのように影響するかについては、以下の「 レポートのタイム ゾーン 」を参照してください。 |
| 行 | 空白行ヘッダー、列名、フッター メタデータを除くレポート レコード データの数。 このメタデータは Xml レポートでは使用できません。 |
レポートの列名 ( "AccountId"、"CampaignId"、"Keyword"、"KeywordId"、"DeviceType"、"Clicks" など) は既定で含まれます。 レポート列で ExcludeColumnHeaders を true に設定しない場合。
レポート フッターのメタデータ ( @2020 Microsoft Corporation など)。すべての権限が予約されています。 は既定で含まれています。 フッター メタデータが 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" に更新されました。 この形式は、レポートの集計が [時間単位] に設定されている場合にのみ、TimePeriod 列に適用されます。 | TimePeriod | "2020 年 3 月 15 日 12:00:00 AM|7" | "2020-03-15|7" |
データをグループ化する列
レポートに含める属性列は、統計列内の値と数値または行に影響します。 たとえば、 AccountId、 CampaignId、 Keyword、 KeywordId、 Clicks のみを含むサマリー レポートを要求した場合、clicks 列には、デバイス、一致の種類、ネットワークなどの除外された属性に関係なく、キーワードのクリック数が含まれます。
"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. "
DeviceType 列を含める場合、レポートにはキーワードとデバイスの種類の値の一意の組み合わせごとに行が含まれており、各行のクリック列の値はそれに応じて分割されます。
"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 属性が必要であるため、レポート要求の Aggregation 要素で 月単位など、より詳細な集計期間を指定すると、クリック データが月単位でさらに分割されることを考慮する必要があります。 たとえば、レポートには、キーワード、デバイス、月の一意の組み合わせごとに行が含まれます。 行は、クリックを含む月にのみ含まれます。
列の制限
インプレッション シェアのパフォーマンス統計列を含むレポートの場合、同じレポート要求に制約付き属性を含めることはできません。 インプレッション シェアのパフォーマンス統計列のいずれかを含める場合は、以下のすべての属性列を除外する必要があります。 同様に、以下のいずれかの属性列を含める場合は、インプレッション共有のパフォーマンス統計列をすべて除外する必要があります。
AccountPerformanceReportRequest と AdGroupPerformanceReportRequest を送信する場合、次の属性とインプレッション シェアのパフォーマンス統計列は相互に排他的です。
注:
さらに、AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent、AudienceImpressionSharePercent、または RelativeCtr 列のいずれかを含める場合は、CustomerId、CustomerName、および DeliveredMatchType 属性列を除外する必要があります。その逆も同様です。
| 属性 | インプレッション シェアのパフォーマンス統計 |
|---|---|
| BidMatchType DeviceOS 目標 GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent [SharePercent] をクリックします 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 [SharePercent] をクリックします ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
HotelDimensionPerformanceReportRequest を送信する場合、次の属性は制限されます。
| 属性 |
|---|
| AdId |
HotelGroupPerformanceReportRequest を送信する場合、次の属性は制限されます。
| 属性 |
|---|
| AdId |
ProductDimensionPerformanceReportRequest を送信する場合、次の属性とインプレッションシェアのパフォーマンス統計列は相互に排他的です。
| 属性 | インプレッション シェアのパフォーマンス統計 |
|---|---|
| AdDistribution AdId AdStatus ClickType ClickTypeId 目標 GoalType 言語 LocalStoreCode ネットワーク TopVsOther |
AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr [SharePercent] をクリックします ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
ProductPartitionPerformanceReportRequest を送信するときに、次の属性とインプレッション共有のパフォーマンス統計列は相互に排他的です。
| 属性 | インプレッション シェアのパフォーマンス統計 |
|---|---|
| AdDistribution AdId AdStatus BidMatchType ClickType ClickTypeId DeliveredMatchType 目標 GoalType 言語 LocalStoreCode ネットワーク TopVsOther |
AbsoluteTopImpressionSharePercent BenchmarkBid BenchmarkCtr [SharePercent] をクリックします ImpressionLostToBudgetPercent ImpressionLostToRankPercent ImpressionSharePercent |
期間列
TimePeriod 列を含める場合、ダウンロードしたレポートの値の形式は、レポート要求で指定したレポート集計レベルによって異なります。 たとえば、集計レベルが日単位の場合、TimePeriod 列の各フィールドには 、yyyy-mm-dd として書式設定された日が含まれます。
注:
週単位、月単位、および年単位の期間列の部分的なデータ集計はサポートされていません。 選択した日付が完全な週/月/年ではなく、対応する週/月/年の期間列が要求された場合、選択した日付は完全な週/月/年に変換されます。
| 集計 | 説明 |
|---|---|
| 毎日 | レポートの各行は、トランザクションが発生した月、日、年を識別します。 レポート データは、毎日集計されます。 期間は yyyy-mm-dd として書式設定されます。 |
| DayOfWeek | レポートの各行は、トランザクションが発生した曜日を識別します。 レポート データは、1 週間の 7 日間ごとに集計されます。 使用可能なデータ値は 1 - 7 で 、 1 は日曜日を表し、 7 は土曜日を表します。 レポートの時間が複数の週にまたがる場合、特定の曜日のすべての週のパフォーマンス データが 1 行に集計されます。 たとえば、 キャンペーン A のレポート時間範囲に含まれる 3 週間ごとに毎週月曜日 (2 日目) に 5 回のインプレッションがある場合、レポートには TimePeriod 列に 2 、その行のインプレッションの合計が 15 の 1 行が含まれます。 |
| 毎時 | レポートの各行は、トランザクションが発生した時間を識別します。 レポート データは、1 日の 1 時間ごとに集計されます。 既定では、期間は、1 つのパイプで区切られた日付と時間 (int 値) で書式設定されます。つまり、"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|hour" として書式設定されます。 たとえば、クリックが 2020 年 3 月 15 日 07:00 から 08:00 の間に発生した場合、ダウンロードされたレポートのフィールドは "2020-03-15|7" になります。 時間コンポーネントに使用できる値は 0 - 23 です。 レポートの時間が複数の日にまたがる場合、特定の時間のパフォーマンス データは複数の行にわたって個別に提供されます。つまり、レポートには、一意の日と時間ごとに 1 行が含まれます。 たとえば、レポートの時間範囲に含まれる 3 日間の時間 7 の間にキャンペーン A に 5 回のインプレッションがある場合、レポートには 3 つの行が含まれ、それぞれ 5 時間 7 分のインプレッションが含まれます。 |
| HourOfDay | レポートの各行は、トランザクションが発生した 1 日の時間を識別します。 レポート データは、すべての日の 24 時間ごとに集計されます。 使用可能な値は 0 - 23 です。 レポートの時間が複数日にわたる場合、特定の時間のすべての日のパフォーマンス データが 1 行に集計されます。 たとえば、 キャンペーン A にレポート時間範囲に含まれる 3 日間の 7 時間に 5 回のインプレッションがある場合、レポートには HourOfDay の合計 15 のインプレッションを含む 1 行が含まれます。 |
| 毎月 | レポートの各行は、トランザクションが発生した月を識別します。 レポート データは毎月集計されます。 月の最初の日を含む期間は 、yyyy-mm-dd として書式設定されます。 |
| Weekly (週単位) | レポートの各行は、トランザクションが発生した週を識別します。 レポート データは毎週集計されます。 各週の日曜日の日付を含む期間は 、yyyy-mm-dd として書式設定されます。 |
| 年に 1 回 | レポートの各行は、トランザクションが発生した年を識別します。 レポート データは、毎年集計されます。 年を含む期間は 、yyyy として書式設定されます。 |
集計と時刻
ほとんどのレポート要求では、 集計 要素と 時間 要素を設定する必要があります。 集計値ごとに指定できる期間を次に示します。
| 集計値 | 期間 |
|---|---|
| 毎日 | Today 昨日 LastSevenDays ThisMonth 先月 カスタム日付範囲 |
| DayOfWeek | Today 昨日 LastSevenDays ThisMonth 先月 LastThreeMonths LastSixMonths |
| 毎時 | Today 昨日 カスタム日付範囲 |
| HourOfDay | Today 昨日 LastSevenDays ThisMonth 先月 LastThreeMonths LastSixMonths |
| 毎月 | ThisMonth 先月 LastThreeMonths LastSixMonths ThisYear LastYear カスタム日付範囲 |
| 概要 | Today 昨日 LastSevenDays ThisMonth 先月 カスタム日付範囲 |
| Weekly (週単位) | ThisWeek 先週 LastFourWeeks ThisMonth 先月 ThisYear LastYear カスタム日付範囲 |
| 年に 1 回 | ThisYear LastYear カスタム日付範囲 |
ゼロ インプレッション数
レポート データには、要求された期間の前にインプレッションが発生した場合にインプレッションが 0 の行を含め、その後のアクション (クリック、コンバージョン、通話など) が要求された期間中に発生する場合があります。 同様に、先週のパフォーマンスの日次レポートをダウンロードした場合、要求された期間内でも、すべてのインプレッションが日曜日に発生し、クリックやその他のパフォーマンス (月曜日や火曜日など) が発生した可能性があります。 月曜日または火曜日のレポート データには、クリック数が 0 のインプレッションが含まれる場合があります。 一括サービスまたはキャンペーン管理サービスを使用すると、関連するパフォーマンス データがあるかどうかに関係なく、アカウント内のすべてのエンティティを取得できます。
レポートのタイム ゾーン
ダウンロードされたレポート データは、常に UTC 時刻に対して相対的です。 たとえば、1 時間あたりのレポートでは、5 クリックから時間 7 の属性を設定できます。 その場合、5 クリックは 07:00 から 08:00 UTC の間に発生しました。
ReportTimeZone 要求要素は、今日の日付を確立するために使用されるタイム ゾーンを決定します。 レポート要求を送信すると、今日の日付はタイム ゾーンに応じて世界中で異なる場合があります。 [昨日] など、選択したレポートの期間は、今日の日付に対して相対的です。 タイム ゾーンを選択しない場合、レポート サービスでは既定で PacificTimeUSCanadaTijuana が使用されます。 たとえば、2020 年 2 月 2 日の午前 2 時に "昨日" にタイム ゾーンを指定せずに要求されたレポートは、2020 年 1 月 31 日の要求として解釈されます。 タイム ゾーンが EasternTimeUSCanada に設定された "昨日" に対して同時に要求されたレポートは、2020 年 2 月 1 日の要求として解釈されます。
ReturnOnlyCompleteData 要求要素は、サービスがすべてのデータが確実に処理され、使用可能であることを確認する必要があるかどうかを判断します。 true に設定され、要求された集計、スコープ、時刻に基づいてすべてのデータの処理が完了していない場合、サービスはエラー コード NoCompleteDataAvaliable (2004) を返します。 それ以外の場合、既定では要求が成功する可能性があるため、データが完了しているかどうかは示されません。レポートには、要求時にシステムが処理を完了したデータのみが含まれます。 現在も進行中ですが、完了したデータを要求しないことで、最新のデータを取得できます。 次に、その日の書籍が閉じると、このフラグを true に設定し、現在の "昨日" を振り返り、最終的なレポート データを取得できます。
注:
タイム ゾーンが異なるキャンペーンのレポートを要求した場合、データは 1 日が終了し、クリック データがすべてのキャンペーン タイム ゾーンで処理された後にのみ完了と見なされます。 たとえば、キャンペーン A (PST タイム ゾーンを指定) とキャンペーン B (EST タイム ゾーンを指定) を含むレポートを要求すると、キャンペーン A のすべてのクリック データが指定された期間に処理されるまでデータは完了しません。
ユーザーが広告をクリックすると、クリックが処理されるまでに最大 2 時間かかる場合があります (コンバージョンの場合は 3 時間)。 データは通常、3 時間後に書籍が閉じられた状態で完了すると見なされます。 無効なトラフィックが原因の例外ケースによっては、解決に 1 週間以上かかる予期しない調整が発生する可能性があります。 たとえば、広告主の苦情によって、自動化されたフィルターシステムから逃れた無効なクリック アクティビティが特定された場合、Traffic Quality and support Teams は広告主のアカウントへのクレジットを処理し、内部チームと提携して、将来の検出を改善するために自動システムを更新できるかどうかを判断します。 詳細については、「 Traffic Quality Center」を参照してください。
MRC 認定メトリック
検索広告のクリック指標は、メディアレーティング協議会(MRC)によって認定されています。この認定は、他のメトリックには適用されません。 詳細については、 手法のクリック測定の説明 を参照してください。
関連項目
レポート属性とパフォーマンス統計
レポートの種類
レポートの要求とダウンロード
Bing Ads API Web サービス アドレス