Google 広告コネクタの制限
備考
ベータ版
この機能はベータ版です。
LakeFlow Connectでマネージド Google Ads コネクタを使用する際の既知の制限について説明します。
一般的な制限
- スケジュールされたパイプラインを実行しても、アラートはすぐにはトリガーされません。代わりに、次の更新が実行されたときにトリガーされます。
- ソーステーブルを削除しても、宛先テーブルは自動的に削除されません。宛先テーブルを手動で削除する必要があります。この動作は、Lakeflow の Spark宣言型パイプラインの動作と一致しません。
- ソースメンテナンス期間中、Databricks はデータにアクセスできない可能性があります。
- ソース テーブル名が既存の宛先テーブル名と競合する場合、パイプラインの更新は失敗します。
- 複数の宛先パイプラインのサポートは API のみです。
- オプションで、取り込むテーブルの名前を変更できます。パイプライン内のテーブルの名前を変更すると、そのパイプラインは API 専用となり、UI でパイプラインを編集できなくなります。
- パイプラインが既に開始された後に列を選択した場合、コネクタは新しい列のデータを自動的にバックフィルしません。履歴データを取り込むには、テーブルで完全な更新を手動で実行します。
- Databricks は、異なるソース スキーマからのものである場合でも、同じパイプラインに同じ名前を持つ 2 つ以上のテーブルを取り込むことはできません。
- ソース システムは、カーソル列が単調に増加すると想定します。
- コネクタは、変換なしで生データを取り込みます。変換のためにLakeFlow PipelinesでダウンストリームのSpark宣言型パイプラインを使用します。
サポートされているテーブル
コネクタは、Google Adsコネクタ リファレンスに記載されている事前定義済みテーブルをサポートしています。また、Google Ads リソース フィールド、セグメント、およびメトリクスを使用して定義するカスタム レポート テーブルもサポートしています。
増分取り込みの制限
- リソース テーブル (
customer、campaign、ad_group、adなど) は、パイプラインの更新ごとに完全に更新されます。増分取り込みをサポートするのはレポート テーブルのみです。 - どのテーブルでも履歴追跡 (SCDタイプ2) はサポートされていません。現在の状態のみが保存されます。
sync_start_dateとlookback_window_daysのオプションは、 レポートテーブルにのみ適用されます。リソースまたはイベントテーブルにそれらを設定するパイプラインは、 保存時に拒否されます。- レポートの日付は Google Ads アカウントのタイムゾーンに基づいており、各更新によって、そのタイムゾーンの現在の日付までのデータが読み取られます。
segments.weekまたはsegments.monthでセグメント化されたカスタムレポートの場合、sync_start_dateとルックバックウィンドウは週(月曜日)または月の開始時に切り捨てられるため、各更新で期間全体が再読み込みされます。- レポートテーブルの更新が途中で失敗した場合、次の更新は、完全にインジェストされた最後の期間から遡及期間を差し引いた時点から起動されます。日付はスキップされません。
- イベントテーブル(
call_view、lead_form_submission、local_services_lead、local_services_lead_conversation)は、パイプラインの更新ごとに完全に更新され、Google Ads が返す行のみが含まれます。たとえば、Google Ads APIが返すリードフォームの送信データは過去60日分のみのため、次回の更新時に、それより古い送信データは宛先テーブルから削除されます。詳しくは、Google Ads ヘルプセンターのリードフォームアセットについてをご覧ください。
遅延データ変更と削除済み行の制限
- 各パイプラインの更新では、レポートデータのルックバックウィンドウのみが再読み込みされます。ルックバックウィンドウより前のデータに対して Google 広告が行う変更はキャプチャされません。それらをキャプチャするには、テーブルの完全更新をランします。
- Google Ads APIは、選択したメトリクスがすべてゼロのレポート行を省略します。レポートテーブルには、アクティビティのない期間の行は含まれません。詳細については、Google Ads APIドキュメントのゼロメトリクスを参照してください。
- コネクターはレポートテーブルから行を削除しません。Google Ads が後で取り込まれた行のメトリクスをすべて 0 に再設定した場合、API はその行を返さなくなり、宛先テーブルは以前の値を保持します。これらの行を削除するには、テーブルの完全更新をランします。
データ保持の制限
- Google Adsは、時間単位、日単位、週単位でセグメント化されたパフォーマンスデータを37か月間保持します。コネクタは Google Ads が提供しなくなったデータを取り込めないため、完全更新を実行すると、宛先テーブルに保持されている過去の履歴が削除されます。
segments.dateまたはsegments.weekでセグメント化されたカスタムレポートは、そのsync_start_dateが37か月以上前の場合は拒否されます。詳細については、Google Adsのデータ保持ポリシーに関する発表をご覧ください。古いデータが必要なカスタムレポートの場合は、segments.monthを使用してください。 click_reportテーブルが取り込めるのは過去88日間のクリックのみです。Google Ads がクリックデータを提供するのが過去90日間のみであるためです。初期同期または完全更新は、sync_start_dateがそれより前であっても、最大でも88日前までしか起動されません。パイプラインが88日間以上正常にランされない場合、最後の成功した更新から88日前までのクリックは取り込まれません。Google Ads がこれらを提供しなくなるためです。
テーブル設定の制限
- カスタムレポートの
resource、resource_fields、segments、およびmetrics、ならびにレポートテーブルのsync_start_dateは、既存のテーブルでは変更できません。これらをいずれか変更すると、テーブルの次の更新は失敗し、完全な更新を求められます。また、テーブルは、完全な更新をランするまで既存のデータを保持します。完全な更新により、新しい構成でテーブルが再取り込みされます。フィールドの順序変更は変更とはみなされません。オプションを削除すると変更とみなされます。また、テーブルがそのスキーマから、あるいはパイプライン仕様で Google Ads コネクタオプションを設定する最初のテーブルまたはスキーマから継承するsync_start_dateの変更も変更とみなされます。 - 行フィルターはレポートテーブルではサポートされていません。ルックバックウィンドウは行を再読み取りしてメトリクスを更新しますが、メトリクスカラムの行フィルターによって更新された行の取り込みが停止され、その以前の値がテーブルに残ることがあります。
sequence_byのオーバーライドはどのテーブルでもサポートされておらず、primary_keysのオーバーライドはレポートテーブルまたはリソーステーブルではサポートされていません。コネクターのdefaultのキーとシーケンスにより、ルックバックの再読み込みで既存の行を更新でき、各リソースを独自のIDでキーとして保持できます。custom_report_optionscustom_reportテーブルにのみ適用されます。- パイプライン仕様のスキーマまたはカタログは
row_filter、primary_keys、sequence_by、custom_report_optionsを設定できません。これらの設定は、それに含まれるレポート テーブルに適用されるためです。カタログはlookback_window_daysまたはsync_start_dateも設定できません。これらはスキーマまたは個々のレポート テーブルに設定してください。 - これらのサポートされていない設定のいずれかを行うパイプラインを作成または編集すると拒否され、削除する必要がある設定を持つ各オブジェクトがエラーに一覧表示されます。独自の
table_configurationを設定しないテーブル、スキーマ、またはカタログは、パイプラインレベルのtable_configurationを継承するため、row_filter、primary_keys、およびsequence_byもそこから取得できます。コネクタオプションには、パイプラインレベルの設定はありません。lookback_window_daysまたはsync_start_dateを独自に設定しておらず、そのスキーマも設定していないレポートテーブルは、Google Adsコネクタオプションを設定するパイプライン仕様内の最初のテーブルまたはスキーマの値を使用します。各テーブルの値を予測可能な状態に保つには、すべてのレポートテーブルまたはスキーマに設定します。custom_report_optionsは常にテーブル自体から取得されます。 - 列の選択では、テーブルの主キーまたはカーソル列を削除できません。既存のテーブルの
include_columnsに列を追加する場合は、テーブルの完全更新が必要です。