Google Ads via Google BigQuery Serviceコネクター

重要： DomoコネクターでOAuth認証を使用する機能にGoogleによって変更が加えられたことにより、新しいデータ接続を作成する際に、すべてのユーザーがサービスアカウントキー認証を使用しなければならなくなりました。Google BigQuery DataSet経由の新しいGoogle AdWordsを作成するには、このコネクターを使用します。既存のAdWords via BigQuery DataSetはすべてこれまでどおり正常に実行されます。

はじめに

Google Ads（旧Google AdWords）はオンライン広告サービスです。DomoのGoogle Ads via Google BigQuery Serviceコネクターを使用すると、特定のプロジェクトのデータをDomoに転送、取得することができます。このコネクターを正しく構成するには、最初にGoogle Adsアカウント内でGoogle BigQueryスクリプトを構成する必要があります。構成する手順は、この記事の後半で説明します。

Google Ads APIの詳細については、https://developers.google.com/adword...s/guides/startを参照してください。

このトピックでは、Google Ads via Google BigQuery Serviceコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「データコネクターを使用してDataSetを追加する」を参照してください。

必要条件

BigQueryサービスアカウントに接続するには、Google BigQueryサービスアカウントのJSONキーが必要です。キーを生成するには、次の手順を実行します。

GCP Consoleで、［IAMと管理］ページを開きます。
左側のナビゲーションペインで［サービスアカウント］をクリックします。
プロジェクトを選択して［開く］をクリックします。
［サービスアカウントを作成］をクリックします。
サービスアカウントの名前と説明を入力します。
［作成］をクリックします。

注記：サービスアカウントの許可ダイアログで「BigQuery Admin」権限が必要になる場合があります。詳細についてはGoogle管理者にお問い合わせください。
［プロジェクト所有者］を選択します。
［次に進む］をクリックします。
［キーを作成］ をクリックします。
キーのタイプに［JSON］を選択します。
［作成］をクリックします。

シークレットキーがコンピューターに保存されます。

Google BigQuery経由でGoogle Adsに接続する

このセクションでは、Google Ads via Google BigQuery Serviceコネクターページの［認証情報］ペインと［詳細］ペインのオプションについて説明します。このページのほかのペインの項目にある［スケジュール設定］や［DataSetの名前を付け、説明を入力］に関しては、コネクタータイプのほとんどで共通です。詳細については「データコネクターを使用してDataSetを追加する」を参照してください。

認証情報ペイン

このペインには、BigQuery経由でGoogle Adsにアクセスするための認証情報を入力するフィールドがあります。下表は、各フィールドに必要な内容を説明しています。

フィールド	説明
サービスアカウントキーのJSON	BigQueryサービスアカウントキーのJSONをコピーして貼り付けます。キーを作成する方法については、上述の「必要条件」を参照してください。

有効なキーを入力した後は、新しいBigQuery Service経由でGoogle Ads DataSetを作成する際に常に同じアカウントを使用できるようになります。コネクターのアカウントはData Centerの［アカウント］タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。

詳細ペイン

このペインには、レポートの設定に使用できるいくつかのフィールドとメニューがあります。

メニュー

説明

プロジェクトID

DataSetを追加する特定のプロジェクトの名前を入力します。これは、Google Cloud Consoleのプロジェクト情報にあります。

DataSet ID

DataSetの名前を入力します。任意の名前を使用できます。

レポート

実行するAdWordsレポートタイプを選択します。以下のレポートが利用できます。

アカウントパフォーマンス	アカウントレベルでデフォルトによって集計したすべての統計情報を返します。
広告カスタマイザーフィードアイテム	広告カスタマイザーで使用されるフィードアイテムの統計情報を提供します。統計情報はフィードアイテムレベルで集計されます。
広告パフォーマンス	広告レベルで集計したすべての統計情報を返します。
広告グループのパフォーマンス	広告グループレベルでデフォルトによって集計したすべての統計情報を返します。
年齢層パフォーマンス	年齢層別に集計したすべてのディスプレイネットワークとYouTubeネットワークの統計情報を返します。
オーディエンスパフォーマンス	オーディエンスレベルで集計した、ディスプレイネットワーク広告とYouTubeネットワーク広告の興味とリマーケティングのリスト、検索広告のリマーケティングのリスト（RLSA）のパフォーマンスデータを返します。
自動プレースメントパフォーマンス	プレースメントレベルで集計したすべての統計情報を返します。
入札目標パフォーマンス	ポートフォリオ入札戦略の統計情報を返します。
予算パフォーマンス	予算レベルでデフォルトによって集計したすべての統計情報を返します。
通話メトリクス通話詳細	通話専用広告または通話拡張機能の通話追跡のデータを返します。
キャンペーン広告スケジュール目標	AdSchedule条件別にキャンペーンのパフォーマンスをまとめます。
キャンペーン条件	キャンペーンレベルの条件を返します。
キャンペーングループのパフォーマンス	キャンペーングループに含まれるキャンペーンの全体的なパフォーマンス統計情報を返します。
キャンペーン場所目標	場所に基づくキャンペーン条件別にキャンペーンのパフォーマンスをまとめます。
キャンペーン除外キーワードパフォーマンス	キーワードベースのNegativeCampaignCriterionオブジェクトの属性を取得します。
キャンペーン除外プレースメントパフォーマンス	プレースメントベースのNegativeCampaignCriterionオブジェクトの属性を取得します。
キャンペーン除外場所	場所ベースのNegativeCampaignCriterionオブジェクトの属性を取得します。
キャンペーンパフォーマンス	キャンペーンレベルでデフォルトによって集計したすべての統計情報を返します。
キャンペーンシェアセット	SharedSetオブジェクトとキャンペーン間のすべての関係を返します。
クリックパフォーマンス	各クリックレベルで集計したすべての統計情報を返します。
クリエイティブコンバージョン	無料クリックに関する統計情報を返します。
条件パフォーマンス	広告グループ条件レベルで集計したすべての統計情報を返します。
リンク先URL	リンク先URLレベルで集計したすべての統計情報を返します。
表示キーワードパフォーマンス	キーワードレベルで集計したすべてのディスプレイネットワークとYouTubeネットワークの統計情報を返します。
表示トピックパフォーマンス	トピックレベルで集計したすべてのディスプレイネットワークとYouTubeネットワークの統計情報を返します。
最終URL	最終URLレベルで集計したすべての統計情報を返します。
性別パフォーマンス	性別別に集計したすべての統計情報を自動オーディエンスパフォーマンスとともに返します。
地理パフォーマンス	国/領土レベルで集計したすべての統計を返します（国/領土ごとに1行）。
キーワードレスカテゴリー	カテゴリー別に集計したキーワードレス広告（動的検索広告）の統計情報を返します。
キーワードレスクエリ	検索語に基づいて集計したキーワードレス広告（動的検索広告）の統計情報を返します。
キーワードパフォーマンス	キーワードレベルで集計したすべての統計情報を返します。
ラベル	アカウントのすべてのラベルをリストします。
ランディングページ	UnexpandedFinalUrlString別にデフォルトによって集計したすべての統計情報を返します。
マーケットプレイスパフォーマンス	アカウントレベルでデフォルトによって集計した、マーケットプレイスに表示された広告のすべての統計情報を返します。
有料オーガニッククエリ	クエリレベルでの広告とオーガニックリスティングに関する検索統計情報の全体像を表示します。
親ステータスパフォーマンス	親ステータスレベルで集計した統計情報を返します。
プレースホルダー	フィードベースの広告拡張機能の統計情報を返します。
プレースホルダーフィードアイテム	フィードアイテムレベルですべての統計情報を返します。
プレースメントパフォーマンス	プレースメントレベルで集計したすべての統計情報を返します。
製品パーティション	製品パーティション（ID field）レベルで集計したショッピングキャンペーン統計情報を返します。
検索クエリパフォーマンス	検索語レベルで集計したすべての統計情報を返します。
シェアセット	キャンペーン間でシェア可能なすべてのSharedSetオブジェクトを返します。
シェアセット条件	各シェアセットの条件を返します。
ショッピングパフォーマンス	製品（OfferIdフィールド）レベルで集計したショッピングキャンペーン統計情報を返します。
上位コンテンツパフォーマンス	上位コンテンツの入札単価調整比条件の統計情報を返します。
URLパフォーマンス	URLと条件レベルで集計したすべての統計情報を返します。
ユーザー広告距離	場所拡張機能からユーザーの距離別に集計した統計を返します。
動画パフォーマンス	アカウントのアップグレードされた動画広告向けAdWordsキャンペーンの統計情報を返します。

日付範囲

レポートのデータの日付範囲を選択します。

フィールド

レポートにインポートするすべてのフィールドのボックスにチェックを入れます。

セグメント

レポートにインポートするすべてのセグメントのボックスにチェックを入れます。

すべてのフィールドにデータを入力し、メニューのオプションを選択すると、Google Adsスクリプトが［クエリのプレビュー］ペインに自動的に表示されます。次のセクションの説明に従って、このスクリプトをコピーしてGoogle Adsに貼り付けます。

Google AdsでBigQueryスクリプトを構成する

このセクションでは、Google AdsでBigQueryスクリプトを構成する方法について説明します。スクリプトを構成したら、BigQuery Serviceコネクターを使用して、他のコネクターと同様にデータを取得できるようになります。

Google AdsでBigQueryスクリプトを構成するには、

上述の説明に従って、コネクター設定を構成します。
［クエリのプレビュー］ペインからスクリプトをコピーします。
Google Adsでアカウントにサインインします。
画面の右上隅にあるスパナアイコンをクリックします。
［スクリプト］をクリックします（［一括操作］の下）。
プラスボタンをクリックして新しいスクリプトを作成します。
スクリプトの名前を設定し、［承認］をクリックします。
［上級API］を選択します。
［Bigquery］ボックスにチェックを入れます。
ステップ4でコピーしたスクリプトをテキストボックスに貼り付けます。
［プレビュー］をクリックします。
（条件付き）プレビュー後にエラーメッセージが表示された場合は、指示に従ってください。
例えば、BigQueryを承認または再承認するために別のリンクをクリックするように求められる場合があります。
正しく構成できたら、［実行］をクリックします。
Google Adsのメインページに戻り、スクリプトの実行頻度を設定するように求められます。
［頻度］の下にある鉛筆アイコンをクリックして、スクリプトのスケジュールを設定します。
DomoのGoogle Ads via Google BigQuery Serviceコネクターページに戻り、コネクターの構成を続けます。