Microsoft Ads#

OAuth、アプリの認証情報、開発者トークン、アカウント ID を使って Microsoft Ads を接続します。このソースは titan.microsoft_ads に 6 個の固定テーブルを書き込みます。

select
  id,
  account_id,
  name
from titan.microsoft_ads.campaigns
limit 10

Microsoft Adsを接続する#

1. アプリを開き、アプリを接続を選択してから、Microsoft Adsを選択します。

2. OAuth、アプリの認証情報、開発者トークン、アカウント ID を入力します。

3. テーブルを確認してからソースを保存します。

4. 初回の実行が完了するまで同期履歴を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

同期の動作#

エンティティテーブルとパフォーマンスレポートには、設定時に選択したアカウントを使います。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _synced_at と _deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。

テーブルリファレンス#

campaigns#

titan.microsoft_ads.campaigns には 8 個のソース列があります。

ad_groups#

titan.microsoft_ads.ad_groups には 7 個のソース列があります。

ads#

titan.microsoft_ads.ads には 7 個のソース列があります。

campaign_performance#

titan.microsoft_ads.campaign_performance には 8 個のソース列があります。

ad_group_performance#

titan.microsoft_ads.ad_group_performance には 8 個のソース列があります。

keyword_performance#

titan.microsoft_ads.keyword_performance には 9 個のソース列があります。

削除と履歴#

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。