# Google Adwords インテグレーションの移行 Google Adwords データコネクタから新しい Google Ads V2 コネクタに移行するには、以下の手順を実施してください。従来のコネクタは Google Adwords API を使用してデータをインポートしていましたが、新しいバージョンでは Google Ads API を使用してデータを取り込みます。 # 取り込まれるデータの特性 データを別の場所やバージョンから移行する際は、そのデータがどのように変換される可能性があるかを認識しておく必要があります。以下のセクションでは、認識しておくべき重要な特性について説明します。 ## Ad Performance Report 以下の指標は非推奨となっています: - ClickAssistedConversions - ClickAssistedConversionsOverLastClickConversions - ClickAssistedConversionValue - AverageFrequencyImpressionAssistedConversions - ImpressionAssistedConversionsOverLastClickConversions - ImpressionAssistedConversionValue ## Adgroup Performance Report 以下の事前定義された指標はサポートされていません: - ``` AbsoluteTopImpressionPercentage (metrics.absolute_top_impression_percentage) ``` - ``` TopImpressionPercentage (metrics.top_impression_percentage) ``` 以下の指標は非推奨となっています: - ClickAssistedConversions - ClickAssistedConversionsOverLastClickConversions - ClickAssistedConversionValue - ImpressionAssistedConversions - ImpressionAssistedConversionsOverLastClickConversions - ImpressionAssistedConversionValue ## Campaign Performance Report 以下の指標は非推奨となっています: - AverageFrequency - ClickAssistedConversions - ClickAssistedConversionsOverLastClickConversions - ClickAssistedConversionValue - ImpressionReach - ImpressionAssistedConversions - ImpressionAssistedConversionsOverLastClickConversions - ImpressionAssistedConversionValue ## Keywords Performance Report 以下の指標は非推奨となっています: - ClickAssistedConversions - ClickAssistedConversionsOverLastClickConversions - ClickAssistedConversionValue - ImpressionAssistedConversions - ImpressionAssistedConversionsOverLastClickConversions - ImpressionAssistedConversionValue ## Audience Performance Report (サポート対象外) ``` The AUDIENCE_PERFORMANCE_REPORT returned data for both campaign-level and ad group-level audience criteria, while the Google Ads API provides this information in two separate resources: campaign_audience_view and ad_group_audience_view. ``` ``` ## Date Range: - `LAST_WEEK` オプションはサポートされていません。 - Date range に `ALL_TIME` 以外を指定する場合は `segments.date` が必須です。 # 新しい Google Ads V2 Connector を作成する Treasure Data Catalog に移動し、Google Ads v2 を検索して選択します。 ![](/images/int/migrating-google-adwords-integrations/Screen-Shot-2022-03-24-at-15.03.08.png) ダイアログボックスで、既存の Google Ads コネクタに入力した値を入力します。 OAuth を使用してコネクタを認証します。 ![](/images/int/migrating-google-adwords-integrations/Screen_Shot_2022-03-27_at_15_45_43.png) # 設定を保存して、レガシー Google Adwords Data Connector を最後に1回実行する TD Console または CLI から、レガシー設定を保存できます。 - [Ad Performance Report](migrating-google-adwords-integrations.md#ad-performance-report1) - [Adgroup Performance Report](migrating-google-adwords-integrations.md#adgroup-performance-report) - [Campaign Performance Report](migrating-google-adwords-integrations.md#campaign-performance-report) - [Keywords Performance Report](migrating-google-adwords-integrations.md#keywords-performance-report) - [Audience Performance Report (Not support)](migrating-google-adwords-integrations.md#audience-performance-report-not-support) - [Date Range:](migrating-google-adwords-integrations.md#date-range) - [Using TD Console](migrating-google-adwords-integrations.md#using-td-console) - [Using CLI and Workflow](migrating-google-adwords-integrations.md#using-cli-and-workflow) - [Migration Guide](migrating-google-adwords-integrations.md#migration-guide) - [Query Migration Tool](migrating-google-adwords-integrations.md#query-migration-tool) - [Query Validator](migrating-google-adwords-integrations.md#query-validator) - [Query Builder](migrating-google-adwords-integrations.md#query-builder) ## TD Console を使用する ### スケジュール設定されたレガシー Google Adwords Connector の設定を保存して最終インポートを実行する Integration Hub > Sources に移動します。スケジュール設定された Google Adwords ソースを検索し、ソースを選択して **Edit** を選択します。 ![](/images/int/migrating-google-adwords-integrations/Screen_Shot_2022-03-27_at_15_50_27.png) ダイアログボックスで、後で使用するために設定をコピーします。 ![](/images/int/migrating-google-adwords-integrations/Screen_Shot_2022-03-29_at_16_08_23.png) 詳細設定もコピーします。 ![](/images/int/migrating-google-adwords-integrations/Screen-Shot-2022-03-27-at-15.55.24.png) 次に、レガシーデータコネクタで最後に1回実行するように設定します。これにより、config-diff を実行できる一時テーブルが作成されます。この diff を使用して、Treasure Data にインポートされた最新データを特定して確認します。 ![](/images/int/migrating-google-adwords-integrations/image-20190920-223452.png) レガシーコネクタで最終インポートを実行する前に、スケジュールを1回のみの実行に変更してください。 ![](/images/int/migrating-google-adwords-integrations/image-20190920-223521.png) ジョブが完了したら、ジョブクエリ情報の **config\_diff** を確認し、後で使用するためにどこかにコピーします。 ![](/images/int/migrating-google-adwords-integrations/image-20190920-223541.png) ### **新しい Google Adwords V2 Source を作成する** Integration Hub > Authentication に移動します。作成した新しい Google Ads V2 接続を検索します。 ![](/images/int/migrating-google-adwords-integrations/Screen_Shot_2022-03-27_at_15_57_58.png) 新しいソースを選択します。前の手順でコピーしたすべての基本設定と詳細設定を入力します。 ![](/images/int/migrating-google-adwords-integrations/Screen_Shot_2022-03-27_at_16_04_01.png) 設定が完了したら、データを投入するデータベースとテーブルジョブを選択し、ジョブのスケジュールを設定して、新しいデータコネクタの名前を指定します。**Save** を選択してから、新しいデータコネクタを実行します。 ## CLIとWorkflowの使用 update in: google\_adwords から google\_adwords\_v2 にyml設定を変更します。 たとえば、既存のワークフロー設定は次のようになっている場合があります: ``` in: type: google_adwords client_id: ${client_id} client_secret: ${client_secret} refresh_token: ${refresh_token} client_customer_id: ${client_customer_id} target: KEYWORDS_PERFORMANCE_REPORT include_predefined_metrics: true developer_token: ${developer_token} date_range: "TODAY" out: {} exec: {} filters: [] ``` 新しいワークフロー設定は次のようになります: ``` in: type: google_adwords_v2 client_id: ${client_id} client_secret: ${client_secret} refresh_token: ${refresh_token} client_customer_id: ${client_customer_id} target: KEYWORDS_PERFORMANCE_REPORT include_predefined_metrics: true developer_token: ${developer_token} enable_multiple_page: false date_range: "TODAY" out: {} exec: {} filters: [] ``` # 付録 ## マイグレーションガイド ## クエリマイグレーションツール ## クエリバリデーター ## クエリビルダー ```