P-MAXの検索語句をPythonで取得する実装手順

P-MAX（パフォーマンスマックス）を回すと必ず突き当たるのが「検索語句が見えない」という壁だ。管理画面のインサイトはカテゴリ単位で丸められ、生の検索語句まで降りられない。Google広告APIを使えば語句レベルに近いデータを引ける。ただし通常の検索語句レポートとは取得口が違い、そこを知らないと空の結果を返し続けて時間を溶かす。実際に詰まった罠と、そのまま流用できる取得クエリを配置表つきでまとめた。

なぜP-MAXの検索語句は普通のレポートで取れないのか

検索広告なら search_term_view リソースに投げれば検索語句が返る。だがP-MAXにこのビューは効かない。campaign_idで絞っても該当行がゼロで返り、権限エラーも出ないため「データが無い」と誤読しやすい。実際、最初の実装ではsearch_term_viewに対してP-MAXのcampaign_idを渡し、30分ほど「配信はあるのに0件」の原因を追った。答えは単純で、P-MAX専用の campaign_search_term_insight という別リソースを使う必要がある。公式のフィールド定義（developers.google.com/google-ads/api/fields/v22/campaign_search_term_insight）にこの分離が明記されている。取得口を1つ間違えるだけで詰まる、典型的なAPIの落とし穴だ。

campaign_search_term_insight の構造を押さえる

このリソースは2階層で考えると理解が早い。上位が category_label（管理画面で見えるカテゴリ名）、その下に segments.search_term で実際の検索語句がぶら下がる。つまりGoogleは生の語句を「カテゴリ」で束ねて返す設計だ。指標は metrics.impressions・metrics.conversions・metrics.conversions_value が取れる。注意点は3つ。（1）campaign_search_term_insight.campaign_id での絞り込みが必須で、無指定だと全キャンペーンが混ざる。（2）語句単位のクリック数やコストは提供されず、取れるのはインパクション・CV・CV値まで。（3）データは一定のプライバシー閾値を超えた語句のみ表示され、少量配信の語句は出てこない。ここを期待値として持っておかないと「取得漏れ」と誤診する。

そのまま使えるGAQLクエリ

ブックマークして、自分のcampaign_idに書き換えて使ってほしい。GAQLは1行で書ける：SELECT campaign_search_term_insight.category_label, segments.search_term, metrics.impressions, metrics.conversions, metrics.conversions_value FROM campaign_search_term_insight WHERE campaign_search_term_insight.campaign_id = 123456789 AND segments.date DURING LAST_30_DAYS

実装手順は次の4ステップに落ちる。（1）google-ads の公式Pythonクライアントを google-ads.yaml の認証情報で初期化する。（2）GoogleAdsService の search_stream にcustomer_idと上記クエリを渡す。（3）返ってきた行を category_label ごとにまとめ、search_term を配下に格納する。（4）conversions で降順ソートし、CVの多い語句カテゴリから予算配分やアセット改善の判断材料にする。認証まわりの初回セットアップでつまずく場合は、Google広告APIをPythonで動かす手順と初回の壁に開発者トークンとOAuthの通し方をまとめてある。この取得手順の完全版はnoteの実践ガイドにまとめている。

取得後にやるべき運用アクション

語句が取れて終わりでは意味がない。CVが付いている語句カテゴリは、対応する検索テーマのアセット（見出し・説明文）を厚くする。逆にインプレッションだけ多くCVゼロが続くカテゴリは、アカウント単位の除外キーワードで削る判断に使う。除外の自動抽出ロジックは除外キーワード自動抽出をPythonで実装と組み合わせると、P-MAXの語句インサイトをそのまま除外候補リストに流し込める。週次でこのクエリを回し、前週比でCV語句カテゴリの増減を見るだけでも、ブラックボックスと言われるP-MAXの中身がかなり見えるようになる。

実装前の確認チェックリスト

  • 使うリソースは search_term_view ではなく campaign_search_term_insight か
  • WHERE句に campaign_search_term_insight.campaign_id を入れたか
  • 取得指標をimpression・CV・CV値に限定しているか（クリック/コストは非提供）
  • 0件時に「配信なし」と即断せず、プライバシー閾値と絞り込み条件を先に疑ったか
  • API versionは v22 など有効なバージョンを指定しているか

抽出した語句カテゴリを提案資料やレポートに落とすなら、以下のツールが図解化を早めてくれる:

AIスライド作成ツール「イルシル」を試してみる

まとめ

P-MAXの検索語句は「取れない」のではなく「取得口が別」なだけだ。campaign_search_term_insight にcampaign_idで絞ったGAQLを投げれば、カテゴリと語句、CV指標まで降りられる。まず今週の配信キャンペーン1本で上のクエリを回し、CV語句カテゴリを3つ書き出すところから始めるとよい。

実務でそのまま使いたい人へ

本記事の手法の完全版（実際のコード・テンプレート・つまずき対処つき）は、運営者のnote（note.com/ryo_ai_hack）で公開している。実データに基づく実践ガイドをまとめて読める。

DMM 生成AI CAMP

コメント

コメントを投稿

このブログの人気の投稿

Claude Skills販売で月5万稼ぐ3ステップ実践

イメージ
2026年、Anthropicが公開した「Claude Skills」が新たな副業の入口として注目を集めている。SKILL.mdというMarkdown形式の手順書を1枚書くだけで、誰でも自分の業務ノウハウをAIワークフローとして販売できる仕組みだ。海外では非エンジニアが50日で5,000ドルを売り上げた事例も登場し、日本でも参入の動きが加速している。今回は「Claude Skills 販売 副業」を軸に、月5万円を狙うための3ステップを具体的に解説する。コードは一切不要、初期費用もほぼゼロで始められる。 Claude Skillsとは何か:販売できる理由 Claude Skillsは、Claude Codeが特定タスクを実行する際に読み込む「再利用可能な指示書」である。実体はSKILL.mdというテキストファイル1枚で、業務手順を自然言語で記述するだけで動く。プログラミング言語は必要なく、日本語で「請求書を読み取り仕訳を生成する」「議事録から議題別サマリを作る」といった手順を構造化して書けば成立する。 販売できる理由は3つある。第一に、Anthropicの審査やマーケットプレイス登録が不要で、自分のサイトやGumroad経由で即販売できる。第二に、業務知識そのものが資産になるため、士業・人事・経理など専門職の暗黙知が高値で売れる。第三に、購入者はファイルをClaude Codeに置くだけで使えるため、サポート負荷が極めて低い。海外メディアagent37の報告では、税務処理を自動化するSkillが1本79ドルで継続的に売れている。 月5万円のリアルな単価設計 1本2,980円のSkillを月17本売れば達成できる。1本9,800円なら月5本で到達する。高単価帯は専門業務向け、低単価帯は汎用ツール系という棲み分けが定石となっている。 ステップ1:売れるSkillテーマを30分で決める 最初の関門はテーマ選定である。売れるSkillには共通点が3つある。「毎週繰り返す業務」「結果物がテキストかコード」「担当者の判断が定型化できる」の3点だ。この条件を満たす自分の業務を15個書き出し、上位3つに絞り込む作業を30分で行う。 具体例を挙げる。広告運用者なら「日次レポートのSlack要約Skill」、人事なら「面接フィードバック整形Skill」、ライターなら「SEO見出し構成生...
続きを読む

Claude CodeでExcel自動化副業を月5万にする手順

イメージ
Claude Codeを副業に使いたいが、何から手をつければ収入につながるのか見えにくい。本記事は、需要が安定しているExcel自動化案件に的を絞り、3週間で初案件を獲得し月5万円までスケールさせる具体的な手順をまとめる。コーディング未経験でも、手順どおりに進めれば動くものを納品できる構成にした。 なぜExcel自動化が初心者の最短ルートなのか クラウドソーシングで需要が枯れない領域がExcel関連だ。ランサーズやクラウドワークスでは「VBAでの集計自動化」「データ整形」「請求書生成」が常時数百件単位で募集されている。単価は1案件3,000〜30,000円で、納期も短い案件が多い。 従来は VBAの知識 が壁だった。だがClaude Codeは自然言語の指示からVBAコードを生成し、ターミナル上で実行・修正まで完結する。リベシティの解説によれば、Excel自動化はClaude Code副業16ジャンルの中で初心者が最も入りやすい分野とされている。 参考: リベシティのClaude Code活用例まとめ 準備するもの（初期費用は月3,000円のみ） Claude Pro契約: 月額20ドル（約3,000円） Node.js: 公式サイトから無料でインストール Microsoft Excel: すでに持っているはず クラウドソーシングのアカウント: ランサーズかクラウドワークス 初期投資はClaude Proの月3,000円のみ。1案件取れれば即回収できる水準だ。インストール手順は Uravationの2026年最新ガイド に図解で載っている。 3週間ロードマップ：初案件獲得まで 1週目：Claude Codeで動くものを3つ作る 最初の壁は「指示の出し方」だ。いきなり案件に応募せず、まず手元のExcelで3つの小さな自動化を作る。例として「フォルダ内のCSVを1つに統合」「請求書テンプレへの差し込み」「重複行の検出」が定番だ。各15〜30分で完成する。 この段階で重要なのは、生成されたVBAを 必ず自分で1行ずつ読む こと。読めなくても動作の意図は把握する。後工程のエラー対応で効いてくる。 2週目：ポートフォリオを2本作る 応募時に提示する成果物を準備する。「営業日報の月次集計を5秒で完了するマクロ」「100枚の請求書PDFを一括生成するツール」のように、効果を秒数や...
続きを読む

Difyの使い方｜初心者でも10分で作れるAIアプリ入門

イメージ
「AIを使ったアプリを作りたい。でもプログラミングの知識がない」——そんな悩みを持つ人が急増している。2026年現在、ノーコードでAIアプリを開発できるツールは複数ある。中でも注目度が高いのがDify（ディフィ）だ。オープンソースで公開されており、無料プランでもチャットボットや文章生成ツールを作成できる。 Difyをまったく触ったことがない初心者でも大丈夫。この記事では、アカウント登録からAIアプリ完成までの全手順を解説する。最短10分で、自分だけのAIチャットボットが動き出す。 Difyとは？ノーコードで使えるAI開発プラットフォーム Difyは、大規模言語モデル（LLM）を活用したAIアプリをノーコードで開発できるプラットフォームだ。オープンソースとして公開されている。2026年4月時点でダウンロード数は500万を超えた（ Dify公式サイト ）。 主な特徴は以下の3つ。 マルチモデル対応 ：OpenAIのGPT、AnthropicのClaude、GoogleのGeminiなど数百種類のAIモデルを切り替えて使える ノーコードUI ：処理ブロックをつなげるだけで、チャットボットやワークフローを構築できる RAG（検索拡張生成） ：自社ドキュメントやFAQをアップロードし、その情報をもとに回答するAIを作れる プログラミング経験がゼロでも、ブラウザ上で直感的に操作できる。これがDify最大の強みだ。 Difyの始め方｜アカウント登録から初期設定まで3ステップ Difyを使い始めるまでの手順はシンプルだ。3ステップで完了する。 ステップ1：アカウントを作成する Difyクラウド版（ cloud.dify.ai ）にアクセスする。「始める」ボタンをクリックしよう。Googleアカウント、GitHubアカウント、メールアドレスのいずれかで登録できる。所要時間は1分程度だ。 ステップ2：AIモデルのAPIキーを設定する ログイン後、画面右上のアカウントアイコンから「設定」に進む。「モデルプロバイダー」を開き、使いたいAIサービスを選ぼう。事前に取得したAPIキーを入力して保存すれば完了だ。 まだAPIキーがない場合はOpenAI公式サイト（ platform.openai.com ）で取得できる。無料クレジットが付くため、初期費用はか...
続きを読む