広告3媒体レポート統合をPythonで実装した手順

Meta・Google・Yahooを回している運用者なら、3媒体の数字を1枚に並べる作業に毎朝時間を溶かしているはずだ。媒体ごとに管理画面を開き、CSVを落とし、列名を手で揃える。この手集計はミスの温床であり、月次のたびに憂うつになる。結論から言うと、統合でつまずく原因のほぼ全ては「コスト単位と列名のバラつき」に集約される。ここさえ設計すれば、3媒体の横断CPA比較はPythonで5分に落ちる。実際に運用中のスクリプトをもとに、設計から実装、ハマった点までを順に示す。

なぜ3媒体を1つにするだけで数字がズレるのか

統合が難しいのはAPI連携そのものではない。各媒体が「同じ指標」を別の名前・別の単位で返すからだ。特にコストの表現がバラバラで、ここを見落とすと合計金額が桁単位で狂う。

  • Google広告API: コストはマイクロ単位で返る。cost_microsを1,000,000で割って初めて円になる
  • Meta広告API: コストはspendという名前で、しかも数値でなく文字列で返る。floatへの変換が要る
  • Yahoo広告API: コストはcostだが、レポート項目の指定を誤ると税抜・税込がズレる

クリック・表示回数・CVも同様で、Metaはimpressions、Googleはimpressions、Yahooはimpsのように微妙に違う。つまり統合の本質は「API取得」ではなく「取得後の正規化」だ。列名と単位を共通スキーマに寄せる工程を設計に入れないと、後から必ず破綻する。Google広告APIの単位仕様は公式リファレンス（developers.google.com/google-ads/api）に明記されている。個別のMeta取得の基礎はMeta広告レポートをPythonで自動化する実装手順にまとめた。

設計図: 共通スキーマを最初に固定する

実装より先にやるべきは、3媒体を流し込む「共通の器」を決めることだ。器が決まれば、各媒体の処理は器に合わせる変換関数を書くだけになる。横断分析できない案件のほぼ全ては、この器を決めずにコードから書き始めている（Qiitaの横断分析の解説でも同じ指摘がある）。ブックマークして、自分の担当媒体に合わせて列を足し引きして使ってほしい。以下が実運用で落ち着いた8列の共通スキーマだ。

（1）date（日付・YYYY-MM-DD固定）（2）media（媒体名・meta/google/yahooの3値）（3）campaign（キャンペーン名）（4）cost（コスト・円・整数）（5）clicks（クリック）（6）impressions（表示回数）（7）conversions（CV）（8）cpa（cost÷conversions・後段で計算）。この8列に全媒体を寄せると、CPAやCTRは同じ式で一括計算できる。指標名のマッピング表さえ持てば、LINE広告やX広告を足すときも器は変えずに済む。

実装の核心はコスト単位の変換だけ

スキーマが決まれば、実装で気をつけるのは単位変換のみだ。ここを1行の変換関数に閉じ込めておくと、媒体追加時の事故が激減する。Googleのマイクロ変換は「cost = row.metrics.cost_micros / 1_000_000」、Metaの文字列変換は「cost = int(float(record['spend']))」、Yahooはレポート項目でCostを税込指定して「cost = int(row['Cost'])」とする。この3種類のcostを共通スキーマの整数円に寄せ、pandasのconcatで縦積みするだけでよい。

CVの持ち方にも注意が要る。Meta広告は1件のCVが小数（0.0）で返る場合があり、int変換で切り捨てると過小計上になる。conversionsはfloatのまま保持し、CPA計算時にのみ丸める。横断のCPAは「df.groupby('media').apply(lambda g: g.cost.sum() / g.conversions.sum())」で媒体別に一撃で出る。個別APIの取得側で詰まりやすい罠はYahoo広告APIをPythonで自動化して詰まった5つの罠で先に潰しておくと早い。この統合スクリプトの完全版はnoteの実践ガイドにまとめている。

実運用でつまずいた3点と対処

正規化の設計が正しくても、運用に乗せると別の落とし穴が出た。実際に踏んだ3つを共有する。

  • タイムゾーン: Google広告はアカウントのタイムゾーン設定で日付が切られる。管理画面がJSTでもAPIがUTCで返る設定だと、Metaと1日ぶんズレて合計が合わない。3媒体ともJST基準に揃えてから結合する
  • アトリビューション窓の差: MetaのCVはデフォルトでクリック7日・ビュー1日を含む。Googleの設定と窓が違うと、同じ「CV」でも定義が別物になる。横断比較の前に各媒体の窓を明記し、揃える判断を入れる
  • 通貨と税: 全媒体を円・税込に統一する。Metaのspendは税抜で返るため、統合時の総コストが請求額と乖離する

この3点を潰した結果、それまで管理画面手集計に朝90分かけていた3媒体レポートが、スクリプト実行の約5分に短縮できた。手作業の転記ミスもゼロになった。数字がズレたときに「どの媒体の単位か窓か」を切り分けられるよう、変換関数にコメントで単位を残しておくと復旧が速い。

まとめ

3媒体統合の勝負どころは、APIの叩き方ではなく取得後の正規化にある。共通スキーマを先に固定し、コスト単位とアトリビューション窓を揃える。この順番さえ守れば、横断CPA比較は誰でも再現できる。統合したデータを客先向けのレポートやダッシュボードに落とすなら、以下のツールが図解の下地づくりに使える。

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

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

本記事の統合スクリプトの完全版（実際のコード・共通スキーマ定義・媒体追加時のつまずき対処つき）は、運営者の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見出し構成生...
続きを読む

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 ）で取得できる。無料クレジットが付くため、初期費用はか...
続きを読む

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を一括生成するツール」のように、効果を秒数や...
続きを読む