Openflow Connector for Google Ads¶
注釈
コネクタには、 コネクタ利用規約 が適用されます。
このトピックでは、Openflow Connector for Google Adsの基本概念、設定手順、および制限事項について説明します。
Google Adsは、広告主が自社の製品やサービスを宣伝するための広告を作成、掲載できるオンライン広告プラットフォームです。Google Adsを利用することで、人々が提供される製品やサービスに興味を持ったタイミングでオンライン広告を作成できます。
Openflow Connector for Google Ads:
Google Adsのデータを自動的にSnowflakeアカウントに取り込みます。
Google Ads API を使用してデータをダウンロードします。
このコネクタは、以下を実行する場合に使用します。
パフォーマンス追跡や最適化のため、Google Adsからメトリックをインポートする
ユースケース¶
異なる取り込みモードでコネクタを実行する¶
データの取り込みには、増分とスナップショットの2つの方法があります。スナップショットモードはデフォルトで、 segment.date セグメントが選択されていない限りオンになります。提供された宛先スキーマにテーブルを作成し、各スケジュールにGoogle Adsからの最新データを追加します。
増分取り込みを構成するには、Report Segmentsパラメーターに segments.date というセグメントを入力する必要があります。他のセグメントは引き続きプリセットできます。その場合、データは以前にフェッチしたものと現在の実行の日付範囲の間で重複します。重複はコンバージョンウィンドウが原因です。これは、コンバージョンウィンドウと同じ日数の履歴データを求める必要があるからです。例えば、コンバージョンウィンドウが14日に設定され、取り込みが毎日行われる場合、13日間の重複が発生します。
現在実行中のコネクタを再構成する¶
レポート構成は、プロセッサーの実行中に変更できます。これを行うには、 GetGoogleAdsReportContext に移動して、希望するパラメーターを変更します。Report Attributes、MetricsまたはSegmentsパラメーターのみを変更すると、現在の宛先テーブルは削除され、スキーマが更新された新しいテーブルが作成されます。そのため、更新を行う前に、ダウンロード済みのデータは削除されることに注意してください。
リソース名またはアカウントクライアント ID が変更されると、新しいテーブルが作成されます。古い宛先テーブルはドロップされません。
スケジュールとコンバージョンウィンドウを変更しても、宛先テーブルに既に取り込まれたデータには一切影響しません。
開始日が変更されると、コネクタはその日付から現在の日付まで1回の取り込みを実行し、その後は通常どおり増分モードで進みます。新しい開始日から現在の日付までの期間にダウンロードされたデータがある場合は、変更後に置き換えられます。新しい開始日以前のデータは影響を受けません。
レート制限の制限事項¶
Google Ads API の制限 により、特定の時間枠内に行うことができるリクエスト数が管理されます。フローが許容クォータを超えると、同期が遅くなるか、エラーで失敗する可能性があります。これは主に、アクセストークンがソースが通常許可するよりも多くのリクエストを行う場合に発生します。このような場合は、より高いアクセスクォータ（該当する場合）を適用するか、同期頻度を下げることをお勧めします。
制限事項¶
フィルターはサポートされていません。代わりに、データを取り込んだ後にフィルターできます。
カスタム列の取り込みはサポートされていません。
レポートをセグメント化する際、選択したメトリックがすべてゼロの場合は常に除外されます。
属性リソースの取り込みはサポートされていません。代わりに、複数のレポートを取り込んだ後に結合することができます。
選択したリソース名とクライアントIDのペアに対して、レポートは1つしか作成できません。
プロセッサーの実行中にレポート定義を変更すると、データの不整合が発生する可能性があります。一貫性を確保するため、構成を更新する前にプロセッサーを停止し、キューをクリアしてください。