--- title: Microsoft Ads description: Microsoft Adsを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。 species: reference --- # Microsoft Ads OAuth、アプリの認証情報、開発者トークン、アカウント ID を使って Microsoft Ads を接続します。このソースは `titan.microsoft_ads` に 6 個の固定テーブルを書き込みます。 ```sql select id, account_id, name from titan.microsoft_ads.campaigns limit 10 ``` ## Microsoft Adsを接続する 1. **アプリ**を開き、**アプリを接続**を選択してから、**Microsoft Ads**を選択します。 2. OAuth、アプリの認証情報、開発者トークン、アカウント ID を入力します。 3. テーブルを確認してからソースを保存します。 4. 初回の実行が完了するまで**同期履歴**を確認します。 認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。 ## 同期の動作 エンティティテーブルとパフォーマンスレポートには、設定時に選択したアカウントを使います。 新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。 すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。 ## テーブルリファレンス ### `campaigns` `titan.microsoft_ads.campaigns` には 8 個のソース列があります。 ```columns table=microsoft_ads.campaigns id string pk ソースのフィールド `id`。 account_id string ソースのフィールド `accountId`。 name string ソースのフィールド `name`。 status string ソースのフィールド `status`。 budget_type string ソースのフィールド `budgetType`。 daily_budget float ソースのフィールド `dailyBudget`。 start_date string ソースのフィールド `startDate`。 end_date string ソースのフィールド `endDate`。 ``` ### `ad_groups` `titan.microsoft_ads.ad_groups` には 7 個のソース列があります。 ```columns table=microsoft_ads.ad_groups id string pk ソースのフィールド `id`。 campaign_id string ソースのフィールド `campaignId`。 name string ソースのフィールド `name`。 status string ソースのフィールド `status`。 cpc_bid float ソースのフィールド `cpcBid`。 start_date string ソースのフィールド `startDate`。 end_date string ソースのフィールド `endDate`。 ``` ### `ads` `titan.microsoft_ads.ads` には 7 個のソース列があります。 ```columns table=microsoft_ads.ads id string pk ソースのフィールド `id`。 ad_group_id string ソースのフィールド `adGroupId`。 type string ソースのフィールド `type`。 title string ソースのフィールド `title`。 description string ソースのフィールド `description`。 status string ソースのフィールド `status`。 final_urls json ソースのフィールド `finalUrls`。 ``` ### `campaign_performance` `titan.microsoft_ads.campaign_performance` には 8 個のソース列があります。 ```columns table=microsoft_ads.campaign_performance campaign_id string pk ソースのフィールド `campaignId`。 time_period date pk ソースのフィールド `timePeriod`。 impressions integer ソースのフィールド `impressions`。 clicks integer ソースのフィールド `clicks`。 spend float ソースのフィールド `spend`。 average_cpc float ソースのフィールド `averageCpc`。 ctr float ソースのフィールド `ctr`。 conversions integer ソースのフィールド `conversions`。 ``` ### `ad_group_performance` `titan.microsoft_ads.ad_group_performance` には 8 個のソース列があります。 ```columns table=microsoft_ads.ad_group_performance ad_group_id string pk ソースのフィールド `adGroupId`。 time_period date pk ソースのフィールド `timePeriod`。 impressions integer ソースのフィールド `impressions`。 clicks integer ソースのフィールド `clicks`。 spend float ソースのフィールド `spend`。 average_cpc float ソースのフィールド `averageCpc`。 ctr float ソースのフィールド `ctr`。 conversions integer ソースのフィールド `conversions`。 ``` ### `keyword_performance` `titan.microsoft_ads.keyword_performance` には 9 個のソース列があります。 ```columns table=microsoft_ads.keyword_performance keyword_id string pk ソースのフィールド `keywordId`。 time_period date pk ソースのフィールド `timePeriod`。 keyword_text string ソースのフィールド `keywordText`。 ad_group_id string ソースのフィールド `adGroupId`。 impressions integer ソースのフィールド `impressions`。 clicks integer ソースのフィールド `clicks`。 spend float ソースのフィールド `spend`。 average_cpc float ソースのフィールド `averageCpc`。 quality_score integer ソースのフィールド `qualityScore`。 ``` ## 削除と履歴 行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して `_deleted` を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには `where not _deleted` で絞り込んでください。