PaidSync.ai で GA4 を Gemini と Gemini CLI に接続

Gemini アプリ（個人アカウント）。 gemini.google.com を開き、Settings、Connected Apps の順に進み（表示されない場合は先に Personal Intelligence を開きます）、Custom apps の下で Add a custom app を選びます。

PaidSync のサーバー URL を貼り付けて Next をクリックします。PaidSync は自分自身を登録するため、コピーする API キーも、Advanced features に入力するものもありません。

ウェブで一度追加すれば、Gemini のモバイルアプリでも使えます。Google はカスタムアプリを、個人の Google アカウント、18 歳以上、米国、英語、Keep Activity オンに限定しています。

職場または学校のアカウントでは追加できないため、代わりに下の Gemini Enterprise を使ってください。

Gemini CLI。 コマンドを実行し、/mcp auth paidsync と入力して、PaidSync のログインでサインインします。

Google は 2026年6月18日に、無料プランと Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えたため、それらのアカウントは下の Antigravity を使います。

VS Code の Gemini Code Assist エージェントモードは、Gemini CLI と同じ設定ファイルを読み込みます。~/.gemini/settings.json に次を追加します。

Antigravity は別のキーを使います。

エージェントパネルのメニューを開き、MCP Servers、Manage MCP Servers、View raw config の順に選ぶか、~/.gemini/config/mcp_config.json を編集して、serverUrl でサーバーを追加します。

Antigravity は、動的クライアント登録によって自動的にサインインします。

Gemini Enterprise、Business エディション。 チームの管理者が、Settings and help、Manage team、Connected apps、Add MCP Server の順に進んで PaidSync を追加します。

PaidSync は、Gemini が必要とする Streamable HTTP トランスポートと、https://api.paidsync.ai/authorize および https://api.paidsync.ai/token の OAuth 2.0 を提供します。

そのフォームが求めるクライアント認証情報については、support@paidsync.ai にメールしてください。

PaidSync のサインイン画面が開きます。Continue with Google を選ぶか、PaidSync のメールとパスワードでサインインします。次に PaidSync の画面で、PaidSync 経由で Gemini が広告アカウントを管理することを許可するか尋ねられます。承認する を押すと、PaidSync が接続されます。

PaidSync が初めてで Google でサインインする場合は、Approve を押したときに無料アカウント（月 100 タスク、クレジットカード不要）が作成されます。この画面には、PaidSync の中ですでに接続されている広告アカウントも表示されます。新しいアカウントでは、ステップ 3 を終えるまでその一覧は空です。

どのチャットでも 「GA4 を接続してください。」 と入力します。Gemini は Google 自身のサインイン画面と同意画面を開くリンクを返します。GA4 プロパティにアクセスできる Google アカウントでサインインし、アクセスを承認してください。PaidSync は Google に analytics.edit と analytics.readonly のスコープを要求するため、Gemini はレポートを読み取り、ご依頼の管理上の変更を行えます。PaidSync が Google のパスワードを見ることはありません。

戻って 「GA4 プロパティを一覧表示してください。」 と入力します。Gemini は list_ga4_properties を使って、Google ログインで開けるすべてのプロパティを表示するので、使うプロパティを指定します。接続とプロパティの一覧表示では、タスクは消費されません。続けて 「過去 7 日間の GA4 のセッションとコンバージョンを表示してください。」 を試してみましょう。GA4 は PaidSync ダッシュボードから接続することもできます。どちらの方法でも同じ PaidSync ログインを使うため、Gemini はどちらの場合でもそのプロパティを認識します。

Gemini は GA4 プロパティを照会し、任意の期間やセグメントについて、セッション、ユーザー、コンバージョン、収益、直帰率を返します。

Gemini にトラフィックをソースやチャネルグループ別に分けさせ、オーガニック、有料、ダイレクト、リファラルを並べて比較できます。

Gemini は、コンバージョン率または総コンバージョン数で並べた、成果の高いランディングページを、参考としてセッション数付きで返します。

Google Ads や Meta Ads も接続すると、Gemini は広告費を GA4 のコンバージョンと突き合わせ、ファネル全体の実際のキャンペーン ROAS を示せます。

Gemini は、フォーム送信、ボタンクリック、スクロール深度、動画視聴など、GA4 で設定したあらゆるカスタムイベントを照会できます。

PaidSync へは、登録したときと同じ方法でサインインしてください。Continue with Google か、PaidSync のメールアドレスとパスワードを使います。

アカウントがないメールユーザーは、先に paidsync.ai/signup で作成し、その後 Gemini で PaidSync をもう一度追加します。Google 自身の同意画面でエラーになった場合は、Gemini に 「GA4 を接続してください」 ともう一度頼むと、新しいリンクが届きます。

PaidSync には既定の GA4 プロパティがありません。GA4 へのリクエストは毎回プロパティを指定するため、名前またはプロパティ ID で目的のプロパティを Gemini に伝えると、リクエストごとにそのプロパティが送られます。ID が分からない場合は、Gemini に list_ga4_properties で GA4 プロパティを一覧表示させてください。タスクは消費されません。

PaidSync は、接続した Google ログインで開けるプロパティを一覧表示します。GA4 では、管理者が Admin、続いて Property access management でそのログインを追加します。レポートの読み取りには閲覧者ロールで足り、カスタムディメンションなどの変更には編集者ロールが必要です。別の Google ログインで接続してしまった場合は、PaidSync ダッシュボードで接続を解除し、アクセス権のあるログインでもう一度接続してください。

PaidSync は、チャットを軽く保つため、Gemini に短い初期ツールリストだけを見せます。まず Gemini に paidsync_context を呼び出すよう頼んでください。接続済みのプラットフォームと、GA4 を含む全ツールの一覧が返され、Gemini はそれらのツールを paidsync_exec 経由で実行します。Gemini に PaidSync がまったく表示されない場合は、Settings、続いて Connected Apps に一覧表示されているか確認してください。