BigQueryの接続

BigQueryを接続すると、注文・会員・ログなど自社のデータベースにしかないテーブルを、広告の成果とあわせて分析できます。実売上ベースのROAS、新規・リピートの区別、会員ランク別の成果など、媒体データだけではわからない質問をチャットですぐに聞けるようになります。

接続は参照専用です。AIはデータを読み取るだけで、編集や削除はできません。参照できる範囲も接続時に自分で選んだデータセットに限られ、選んでいないデータセットは名前がわかっても開けません。

準備するもの

BigQueryのデータにアクセスできるGoogleアカウント — 接続時にこのアカウントでログインします。
参照するデータセットの閲覧権限 — Google Cloudの管理者に、データの閲覧権限（BigQueryデータ閲覧者、roles/bigquery.dataViewer）を依頼してください。
クエリを実行するプロジェクトのジョブユーザー権限 — Google Cloudの管理者に、クエリの実行権限（BigQueryジョブユーザー、roles/bigquery.jobUser）を依頼してください。この権限がないと、データが見えてもクエリを実行できません。
そのプロジェクトでBigQuery APIが有効になっていること — コンソールで一度でもBigQueryを使ったことがあるプロジェクトなら、すでに有効になっています。

権限が足りない場合は、接続の最終ステップで事前にチェックされます。費用のかからないテストクエリで権限を確認し、「接続はできたのにクエリがすべて失敗する」状態を防ぎます。

ステップ1 — Googleアカウントの接続

ワークスペースのデータ連携画面で、BigQueryカードの接続を押します。
Googleアカウントでログインを押し、データにアクセスできるアカウントでログインします。
同意画面でBigQueryの権限に必ずチェックを入れます。チェックを忘れると接続できません。その場合はもう一度ログインし、その項目にチェックを入れてください。

Google Ads・GA4など、ほかのGoogleサービスをすでに接続している場合は、同じアカウントを再利用できます。ただし、BigQueryの権限は既存の連携に含まれていないため、同意画面がもう一度表示されることがあります。これは正常な動作です。

ステップ2 — プロジェクトの選択

データがあるプロジェクトを選びます。ここで選んだプロジェクトが、クエリが実行され、スキャン費用が請求される場所になります。

BigQueryのスキャン費用は、お客様のGoogle Cloudプロジェクトに直接請求されます（Neuroの料金とは別です）。そのため、次のステップでスキャン上限もあわせて設定します。

ステップ3 — データセットとスキャン上限の設定

参照を許可するデータセットにチェックを入れます。初期状態ですべてが選ばれることはなく、選んだものだけが開かれます。
上部でプロジェクトを切り替えながら、複数のプロジェクトのデータセットをまとめて追加できます（それぞれのプロジェクトにも参照権限が必要です）。
クエリごとのスキャン上限(GiB) — 初期値は10です。この値を超えるクエリは実行前にブロックされます。テーブルが大きい場合は値を上げてください。
1日のスキャン上限(GiB) — 初期値は100です。ワークスペースが1日に参照できる総量で、毎日午前9時（韓国時間）にリセットされます。クエリごとの上限だけでは小さなクエリの繰り返しを防げないため、あわせて設定します。
データの説明(任意) — よく使うテーブルやコード値の意味を書いておきます（最大2,000文字）。AIは列名だけではstatus = 3が何を意味するかわかりません。例：orders = 注文台帳, status 3=決済完了 / users.grade = 会員ランク(1〜5)
選択した N 件のデータセットで連携を押せば完了です。

個人情報を含むテーブルはそのまま開かないでください。参照したデータはAIの分析のために送信され、会話履歴に保存されてワークスペースのメンバーが閲覧できます。個人情報を除いた別のテーブルをデータ担当者に依頼し、そのデータセットだけを接続してください。

データセットのリージョンは1つにそろえる必要があります。BigQueryはリージョンが異なるテーブルをまとめて参照できないため、異なるリージョンのデータセットを1つの接続に含めることはできません。

ステップ3 — データセットの選択とスキャン上限の設定（名前は例として伏せています）

接続後に設定を変更する

連携済みサービスのBigQueryカードで設定（歯車）アイコンを押すと、再接続せずに次の項目を変更できます。

参照を許可するデータセットの追加・削除
クエリごと／1日のスキャン上限
データの説明

1日の上限は、クエリごとの上限と同じかそれ以上でないと保存できません。1日の予算がクエリ1件分より小さいと、その接続は最初のクエリから必ず拒否されてしまうためです。

活用例

接続後は、チャットで普段の言葉で依頼するだけです。AIが許可されたデータセットとテーブル構造を自分で確認するので、テーブルのパスを覚えておく必要はありません。

「今見られるデータセットとテーブルの一覧を見せて。」
「ordersテーブルにどんな項目があるか見せて。」
「先月の注文データと媒体別の広告費を合わせて、実売上ベースのROASを計算して。」
「新規顧客とリピート顧客に分けて、媒体ごとの貢献を比較して。」
「会員ランク別の購入コンバージョン率をキャンペーンごとに見せて。」

費用が気になる場合は、「このクエリは実行せずに、スキャン量だけ教えて」と依頼してください。実際に実行せずに、スキャンされるデータ量だけを確認できます（費用はかかりません）。

トラブルシューティング

「BigQueryの権限にチェックを入れてください」と表示される

Googleの同意画面でBigQueryの項目にチェックを入れずに進んだ場合です。チェックを忘れると接続できません。もう一度ログインし、その項目にチェックを入れてください。

「利用可能なBigQueryプロジェクトがありません」と表示される

ログインしたGoogleアカウントがBigQueryを使っているプロジェクトにアクセスできないか、そのプロジェクトでBigQuery APIが有効になっていない場合です。アカウントの選び間違い（会社のアカウントではなく個人のアカウントを選んだなど）が最も多いので、まずそれを確認してください。それでも一覧が空の場合は、Google Cloudの管理者にプロジェクトへのアクセス権限とBigQuery APIの有効化を依頼してください。

「このプロジェクトでクエリを実行する権限がありません」と表示される

データの閲覧権限はあっても、クエリの実行権限がない場合です。Google Cloudの管理者に、そのプロジェクトでのクエリ実行権限（BigQueryジョブユーザー、roles/bigquery.jobUser）を依頼してから、もう一度お試しください。データ閲覧者の権限だけではクエリを実行できません。

異なるリージョンのデータセットを一緒に選べない

データが保存されている地域（リージョン）が異なると、まとめて分析できません。同じリージョンのデータセットだけを選んでください。必要な場合はデータ担当者に相談してください。

クエリがスキャン上限を超えてブロックされる

AIに「期間を短くして」「必要な項目だけで」もう一度クエリするよう依頼してください。それでも足りない場合は、設定でクエリごとの上限を上げてください。

1日のスキャン上限に達した

毎日午前9時（韓国時間）に自動でリセットされます。それまでに続けて使う必要がある場合は、設定で1日の上限を上げてください。

AIが列の値の意味を誤って解釈する

設定のデータの説明に、そのテーブルとコード値の意味を書いてください。この説明はクエリのたびにAIに一緒に渡されるため、分析の精度が目に見えて上がります。一方で、長すぎるとクエリごとの費用が増えるので、よく使うテーブルを中心に簡潔に書くのがおすすめです。

特定のデータセットがAIから見えないと言われる

接続時にそのデータセットを選んでいなかった場合です。設定でデータセットを追加するとすぐに反映され、再接続は不要です。

接続や利用中に問題がある場合は、pango_plat@pango-gy.comまでご連絡ください。2営業日以内に返信します。