このページでは、CData Cloud でのMicrosoft Ads への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。

Microsoft Ads への接続

接続の確立 は、CData Cloud にデータベースを作成するためのMicrosoft Ads への認証方法と必要な接続プロパティの設定方法について示します。

CData Cloud サービスからデータにアクセス

利用可能な標準サービスを経由してMicrosoft Ads からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。

Database タブで対応するアイコンを選択して、Microsoft Ads に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。

Microsoft Ads への接続

Microsoft Ads API に接続するには、Microsoft Ads アカウントを登録し、開発者トークンを取得し、OAuth を使って認証する必要があります。

Bing Ads アカウントの登録

Microsoft Ads アカウントにサインアップし、CustomerId およびAccountId（オプション）を取得するには、次の手順を実行してください。

1. 次のURL からMicrosoft Ads アカウントにサインアップするか、 Bing Ads Web application あるいは、Sandbox Site からサンドボックスアカウントにサインアップします。
2. ［Settings］->［Accounts and Billing］を選択し、1つのアカウントを選択します。AccountId とCustomerId (cid) がアカウントページおよびページのURL に表示されます。

開発者トークンの取得

Microsoft Ads API を使用するには、CustomerId に加えてDeveloperToken が必要です。 開発者トークンを作成するには、Microsoft Ads のスーパー管理者ロールが必要ですが、トークンを使用するための特別な権利は必要ありません。

1. Microsoft Ads スーパー管理者ロールを持つMicrosoft アカウントユーザーとしてBing Ads Developer Portalにログインします。
2. ［Request Token］をクリックして開発者トークンを書き留めます。これをDeveloperToken 接続プロパティに設定します。

Microsoft Ads への認証

OAuth

AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。

SSL 設定のカスタマイズ

デフォルトでは、Cloud はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

• ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
• ProxyPort：プロキシサーバーが起動しているTCP ポート。
• ProxyAuthScheme：プロキシサーバーに対して認証する際にCloud が使用する認証方法。
• ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
• ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

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

次のセクションでは、使用可能なAPI オブジェクトへのSQL の実行について説明します。Cloud は、Microsoft Ads にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。Cloud はMicrosoft Ads API を使用してサポートされているフィルタを処理します。Cloud は、他のフィルタを Cloud 内でクライアント側で処理します。

ビュー

レポートを含む、ビュー としてのCloud 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

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

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

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

ストアドプロシージャ

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

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

CData Cloud - Microsoft Ads ビュー

Use this report to observe long-term account performance and trends.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Accounts in Bing Ads.

Table Specific Information

Select

SELECT * FROM Accounts

Columns

Query the available Assets linked to Ads in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AdAssets
SELECT * FROM AdAssets WHERE AdGroupId = '2562405'
SELECT * FROM AdAssets WHERE AdGroupId IN ('1562405', '2562405', '3562405')
SELECT * FROM AdAssets WHERE AdType = 'ResponsiveAd'
SELECT * FROM AdAssets WHERE AdType IN ('ResponsiveAd', 'ResponsiveSearch')
SELECT * FROM AdAssets WHERE AccountId = '2562405'
SELECT * FROM AdAssets WHERE AccountId IN ('1562405', '2562405', '3562405')

Columns

Use this report to identify which dynamic text strings are performing well and which strings you should consider changing.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Assets linked to Ad Extensions in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AdExtensionAssets
SELECT * FROM AdExtensionAssets WHERE AdExtensionId = '2562405'
SELECT * FROM AdExtensionAssets WHERE AdExtensionId IN ('1562405', '2562405', '3562405')
SELECT * FROM AdExtensionAssets WHERE AdExtensionType = 'ImageAdExtension'
SELECT * FROM AdExtensionAssets WHERE AccountId = '2562405'
SELECT * FROM AdExtensionAssets WHERE AccountId IN ('1562405', '2562405', '3562405')

Columns

Use this report to compare how well different versions of your ad extensions are performing with each ad.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Use this report to compare how well different versions of your ad extensions are performing for each keyword.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Use this report to discover the effectiveness of individual ad extension items, for example, each link of a sitelink extension.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Ad Extensions in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AdExtensions
SELECT * FROM AdExtensions WHERE Id = '2562405'
SELECT * FROM AdExtensions WHERE Id IN ('1562405', '2562405', '3562405')
SELECT * FROM AdExtensions WHERE Type = 'ActionAdExtension'
SELECT * FROM AdExtensions WHERE Type IN ('ActionAdExtension', 'AppAdExtension')
SELECT * FROM AdExtensions WHERE AccountId = '2562405'
SELECT * FROM AdExtensions WHERE AccountId IN ('1562405', '2562405', '3562405')

Columns

Use this report to more broadly compare delivery performance statistics by ad group, campaign, or account attributes rather than at the keyword level.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available AdGroups in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AdGroups
SELECT * FROM AdGroups WHERE CampaignId = '234505536'

Columns

Use this report to help you determine which ads lead to clicks and conversions, and which are not performing. Having underperforming ads in your account can pull down the quality of your campaigns.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Ads in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM Ads
SELECT * FROM Ads WHERE AdGroupId = '5179946006'
SELECT * FROM Ads WHERE Type = 'Text'
SELECT * FROM Ads WHERE Type IN ('ExpandedText','Text')
SELECT * FROM Ads WHERE AdGroupId = '5179946006' AND Type = 'Text'
SELECT * FROM Ads WHERE AdGroupId IN ('5179946006',''5179946007'') AND Type = 'Text'
SELECT * FROM Ads WHERE AdGroupId IN ('5179946006',''5179946007'') AND Type IN ('ExpandedText','Text')
SELECT * FROM Ads WHERE AdGroupId = '1297424037031698' AND Type = 'DynamicSearch' AND AccountId = '135093022'
SELECT * FROM Ads WHERE AccountId IN ('2562405', '141163457', '180394748')

Columns

Use this report to discover how your campaigns and ad groups are resonating with audiences of diverse age and gender.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Assets linked to Asset Groups in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AssetGroupAssets
SELECT * FROM AssetGroupAssets WHERE CampaignId = '2562405'
SELECT * FROM AssetGroupAssets WHERE CampaignId IN ('1562405', '2562405', '3562405')
SELECT * FROM AssetGroupAssets WHERE AccountId = '2562405'
SELECT * FROM AssetGroupAssets WHERE AccountId IN ('1562405', '2562405', '3562405')

Columns

Query the available Asset Groups in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM AssetGroups
SELECT * FROM AssetGroups WHERE CampaignId = '2562405'
SELECT * FROM AssetGroups WHERE CampaignId IN ('1562405', '2562405', '3562405')
SELECT * FROM AssetGroups WHERE AccountId = '2562405'
SELECT * FROM AssetGroups WHERE AccountId IN ('1562405', '2562405', '3562405')

Columns

Use this report to compare delivery performance statistics by audience, ad group, campaign, or account attributes.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available Audiences in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM Audiences
SELECT * FROM Audiences WHERE Type = 'RemarketingList'
SELECT * FROM Audiences WHERE AccountId = '65098547' AND Type = 'RemarketingList'

Columns

Query the available Bid Opportunities in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM BidOpportunities
SELECT * FROM BidOpportunities WHERE OpportunityType = 'FirstPage'

Columns

Query the available Budget Opportunities in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM BudgetOpportunities
SELECT * FROM BudgetOpportunities WHERE CampaignId = '234505536'

Columns

Query the available Budgets in Bing Ads.

Table Specific Information

Select

The following queries are processed server-side:

SELECT * FROM Budgets
SELECT * FROM Budgets WHERE CampaignId = '431046229' AND AccountId = '65098547'

Columns

Use this report to discover how your campaign's budget is performing for the month. For example, the report shows your monthly budget, how much you have spent to date, and whether you are on target to spend your monthly budget.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Use this report to view high-level performance statistics and quality attributes for each campaign or account. This is also a quick way to flag any major campaign or account problems.

Columns