Snapchat Ads#
アプリの認証情報を使う OAuth と広告アカウント ID で Snapchat Ads を接続します。このソースは titan.snapchat_ads に 5 個の固定テーブルを書き込みます。
select
id,
ad_account_id,
name
from titan.snapchat_ads.campaigns
limit 10Snapchat Adsを接続する#
アプリを開き、アプリを接続を選択してから、Snapchat Adsを選択します。
アプリの認証情報を使って OAuth 認証を行い、広告アカウント ID を入力します。
テーブルを確認してからソースを保存します。
初回の実行が完了するまで同期履歴を確認します。
認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。
同期の動作#
キャンペーン、広告セット、広告のエンティティを、それぞれのパフォーマンステーブルとともに同期します。
新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトのスケジュールでは、組織のタイムゾーンで平日の 5:00、10:00、15:00、20:00 と日曜日の 20:00 に同期し、各ソースはその時刻から 30 分以内に開始します。実行が中断しても、完了した進捗を保持して安全に再試行します。
すべてのレイクのテーブルにはシステム列 _synced_at と _deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。
テーブルリファレンス#
campaigns#
titan.snapchat_ads.campaigns には 9 個のソース列があります。
ソースのフィールド id。
ソースのフィールド adAccountId。
ソースのフィールド name。
ソースのフィールド status。
ソースのフィールド objective。
ソースのフィールド startTime。
ソースのフィールド endTime。
ソースのフィールド createdAt。
ソースのフィールド updatedAt。
ad_squads#
titan.snapchat_ads.ad_squads には 10 個のソース列があります。
ソースのフィールド id。
ソースのフィールド campaignId。
ソースのフィールド name。
ソースのフィールド status。
ソースのフィールド type。
ソースのフィールド bidMicro。
ソースのフィールド dailyBudgetMicro。
ソースのフィールド optimizationGoal。
ソースのフィールド createdAt。
ソースのフィールド updatedAt。
ads#
titan.snapchat_ads.ads には 7 個のソース列があります。
ソースのフィールド id。
ソースのフィールド adSquadId。
ソースのフィールド name。
ソースのフィールド status。
ソースのフィールド type。
ソースのフィールド createdAt。
ソースのフィールド updatedAt。
campaign_stats#
titan.snapchat_ads.campaign_stats には 6 個のソース列があります。
ソースのフィールド campaignId。
ソースのフィールド startTime。
ソースのフィールド impressions。
ソースのフィールド swipes。
ソースのフィールド spend。
ソースのフィールド videoViews。
ad_squad_stats#
titan.snapchat_ads.ad_squad_stats には 6 個のソース列があります。
ソースのフィールド adSquadId。
ソースのフィールド startTime。
ソースのフィールド impressions。
ソースのフィールド swipes。
ソースのフィールド spend。
ソースのフィールド videoViews。
削除と履歴#
行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。