Meta広告レポートをPythonで自動化する実装手順

広告運用者にとって、毎朝のレポート更新は避けて通れない。Meta広告マネージャを開き、数字をコピーし、スプレッドシートに貼る。この作業を複数アカウントで回すと、それだけで1時間が消える。だが Meta の Marketing API と Python を組み合わせれば、この定型作業は数分に縮む。実際に3アカウントの日次レポートを自動化したところ、毎朝の手作業がほぼゼロになった。ここでは、アクセストークンの取得から Insights API の呼び出し、現場でハマった罠までを、そのまま動くコードとあわせて解説する。

なぜMeta広告レポートはPython自動化に向くのか

GAS やスプレッドシートのアドオンでも自動化はできる。ただ、複数媒体を横断し、独自の集計軸で並べたい運用者には Python が向く。理由は3つある。第一に、pandas で自由に集計・結合できる。第二に、Meta・Google・Yahoo の各 API を同じ言語でまとめられる。第三に、cron や launchd で完全に無人化できる。実測では、3アカウントの日次集計を手作業で回すと毎朝およそ50分かかっていた。Python 化した後は、朝には集計済みの CSV が出来上がっている。この差は月20営業日でおよそ16時間になる。この集計ロジックの完全版は note の実践ガイドにまとめている。

事前準備 アクセストークンとアカウントIDを用意する

Insights API を叩くには、事前に2つの値がいる。アクセストークンと広告アカウントIDだ。手順はこうなる。（1）Meta for Developers でアプリを作り、ads_read の権限を付ける。（2）短期トークンは数時間で失効するため、ビジネス設定からシステムユーザーの長期トークンを発行する。（3）広告アカウントIDはビジネスマネージャで確認し、必ず先頭に act_ を付けた形（例 act_1234567890）で使う。ここを普通の数字だけで渡すと、API はエラーを返す。最初の詰まりどころなので、まず1件だけ手元で叩いて疎通を確かめるとよい。

PythonでInsights APIから広告データを取得する

取得のエンドポイントは GET /v21.0/{act_アカウントID}/insights になる。主要なパラメータは fields、level、date_preset、access_token の4つだ。fields には spend（消化額）、impressions、clicks、ctr、cpc、actions（コンバージョン）を指定する。level を campaign にすればキャンペーン単位、ad にすれば広告単位で返る。date_preset に yesterday を渡せば前日分だけが取れる。まずは短い骨格をブックマークして、自分の環境に合わせて書き換えて使ってほしい。

import requests; params={"fields":"campaign_name,spend,impressions,clicks,ctr,cpc,actions","level":"campaign","date_preset":"yesterday","access_token":TOKEN}; r=requests.get("https://graph.facebook.com/v21.0/"+ACCOUNT_ID+"/insights", params=params); data=r.json()["data"]

返ってきた data はレコードの配列だ。あとは pandas.DataFrame に渡せば、そのまま集計・CSV出力に進める。公式のフィールド仕様は Meta for Developers の Insights API ドキュメントで確認できる。

実装でハマった5つの罠と回避策

ここが自作の山場になる。実際に運用して踏んだ罠を、回避策とあわせて残す。第一に、コンバージョン数は actions という配列でネストして返る。単純な数値ではないため、action_type（例 lead や offsite_conversion）を指定して該当要素だけを抜き出す必要がある。第二に、spend や ctr は数値ではなく文字列で返る。集計前に float へ変換しないと、足し算が文字連結になって壊れる。第三に、date_preset はアカウントのタイムゾーン基準で切られる。管理画面の数字と合わないときは、まずタイムゾーンを疑う。第四に、1回のレスポンスは件数上限があり、paging.next の URL を辿らないとデータが欠ける。件数が多いアカウントほど気づきにくい。第五に、短時間に叩きすぎるとレート制限に当たる。レスポンスの X-Business-Use-Case-Usage ヘッダで消費率を監視し、しきい値を超えたら待つ処理を入れる。

  • アクセストークンはシステムユーザーの長期トークンを使う
  • アカウントIDは先頭に act_ を付ける
  • spend や ctr は文字列なので float に変換する
  • CV は actions 配列から action_type 指定で抽出する
  • paging.next を辿って全ページ取得する

3媒体横断レポートへ拡張する設計

Meta 単体で動いたら、次は横断だ。設計の肝は、媒体ごとの取得関数を分けたうえで、出力を共通スキーマに正規化することにある。たとえば date・media・campaign・cost・imp・clicks・cv の7列にそろえる。Meta は spend、Yahoo は cost と、媒体ごとに項目名が違うため、取得直後にこのスキーマへ寄せておくと後段が楽になる。あとは pandas.concat で縦に結合し、Looker Studio か CSV に流すだけだ。Yahoo 側の実装で踏む罠は Yahoo広告APIをPythonで自動化して詰まった5つの罠 にまとめてある。取得したデータから日予算の自動調整まで踏み込むなら 広告の日予算を自動計算するPython実装 が次の一歩になる。

作った横断レポートをそのまま提案資料やスライドに落とすなら、以下のツールが手早い:

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

まとめ

Meta広告レポートの自動化は、トークン取得・Insights API 呼び出し・罠の回避、の3段で組める。まずは前日分1アカウントを取るところから始め、動いたら媒体を足し、最後に共通スキーマで束ねる。この順で進めれば、毎朝の手集計は着実に消えていく。今日はアクセストークンの発行と、骨格コードの疎通確認まで進めてみてほしい。

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

本記事の手法の完全版（実際のコード・テンプレート・つまずき対処つき）は、運営者の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を一括生成するツール」のように、効果を秒数や...
続きを読む