データモデル

CData Excel Add-In for Bing Ads は、Microsoft Ads API のエンティティをデータベースのビューおよびストアドプロシージャにモデル化します。これらは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

次のセクションでは、使用可能なAPI オブジェクトへのSQL の実行について説明します。本製品は、Microsoft Ads にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。API の制限事項および要件については、このセクションで説明します。

ビュー

レポートを含む、ビューとしての本製品 Microsoft Ads オブジェクト。

集計および期間に基づいてReports をクエリできます。デフォルトの期間は今年です。期間を変更するには、以下のTime Filter セクションを参照してください。

一部のレポートカラムのみを取得する場合、'Select Requirement' としてマークされたすべてのカラム、および'Metric' としてマークされているカラムのうち少なくとも1つを、有効なレポート要求を発行するために選択します。一方、すべてのカラムを取得する場合、ドライバーはデフォルトで必要最小限のカラムを要求に含めます。

Time Filter の指定

日付範囲

WHERE 句では、"Date" フィールドで演算子（=、<、>）を使用して日付範囲を指定できます。

次の定義済み日付フィールドをサポートしています。

Today
Yesterday
LastSevenDays
ThisWeek
LastWeek
LastFourWeeks
ThisMonth
LastMonth
LastThreeMonths
LastSixMonths
ThisYear
LastYear

DatePreset のデフォルト値は"ThisYear" です。

定義済みの日付範囲を検索するには、WHERE 句のDatePreset 疑似カラムを定義済みの日付フィールドのいずれかの値に設定します。

SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM [ AccountPerformanceReport ] WHERE DatePreset = 'LastYear'

カスタム日付範囲を指定するには、WHERE 句にStartDate およびEndDate 疑似カラムを指定します。

SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM [ AccountPerformanceReport ] WHERE StartDate = '2014-01-01' AND EndDate = '2017-09-19'

集計

Aggregation はデータを縮小してまとめる作業です。次の集計カラムのいずれかを選択して、レポートデータを集計できます。

Daily：レポートの各行は、トランザクションが発生した月、日、および年を示します。レポートデータは毎日集計されます。レポートには、Daily という名前のカラムが含まれ、このカラムにはyyyy-mm-dd 形式の日付が含まれます。
```
SELECT Daily, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
DayOfWeek：レポートの各行は、トランザクションが発生した曜日を示します。レポートデータは週7日ごとに集計されます。レポートにはDayOfWeek というカラムが含まれます。利用可能な値は1 - 7で、1が日曜日、7が土曜日を表します。
レポートの期間が数週間に及ぶ場合、すべての週の特定の曜日のパフォーマンスデータが、1つの行に集計されます。例えば、レポート期間の3週間にわたってキャンペーンA のインプレッションが毎週月曜日（day 2）に5回発生した場合、レポートにはDayOfWeek が2に設定された行と、その行に合計15のインプレッションが含まれます。
```
SELECT DayOfWeek, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
Hourly：レポートの各行は、トランザクションが発生した時間を示します。レポートデータは1時間ごとに集計されます。レポートにはHourly というカラムが含まれます。利用可能な値は0 - 23です。
```
SELECT Hourly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
HourOfDay：レポートの各行は、トランザクションが発生した時刻を示します。レポートデータはすべての日にわたって24時間ごとに集計されます。レポートにはHourOfDay というカラムが含まれます。利用可能な値は0 - 23です。
レポートの期間が数日に及ぶ場合、すべての日の特定の時間のパフォーマンスデータが、1つの行に集計されます。例えば、レポート期間の3日間にわたってキャンペーンA のインプレッションが7時に5回発生した場合、レポートにはHourOfDay に合計15のインプレッションが含まれます。
```
SELECT HourOfDay, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
Monthly：レポートの各行は、トランザクションが発生した月を示します。レポートデータは毎月集計されます。レポートには、Monthly という名前のカラムが含まれ、このカラムには月の初日がyyyy-mm-dd 形式で含まれます。
```
SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
Weekly：レポートの各行は、トランザクションが発生した週を示します。レポートデータは毎週集計されます。レポートには、Weekly という名前のカラムが含まれ、このカラムには各週の日曜日の日付がyyyy-mm-dd 形式で含まれます。
```
SELECT Weekly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```
Yearly：レポートの各行は、トランザクションが発生した年を示します。レポートデータは1年ごとに集計されます。レポートには、Yearly という名前のカラムが含まれ、このカラムにはyyyy 形式の年が含まれます。
```
SELECT Yearly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate FROM AccountPerformanceReport
```

ストアドプロシージャ

ストアドプロシージャは、データソースのファンクションライクなインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。