MetaコンバージョンAPIをPythonで実装する手順

ブラウザ計測だけに頼るMeta広告は、iOSの制限や広告ブロックでCVを取りこぼす。取りこぼしはそのまま学習の材料不足になり、CPA悪化につながる。対策がサーバーからCVを直接送るコンバージョンAPI（CAPI）だ。だが解説記事の多くは「とは」「メリット」で止まり、実際に動くコードまで書いたものは少ない。ここではPythonで最小構成を組み、検証で実際に詰まった3点まで先回りで潰す。読み終えれば今日から送信テストに入れる。

なぜサーバー側の計測が要るのか

従来のMetaピクセルはブラウザ上のJavaScriptでCVを送る。この方式はSafariのトラッキング制限や広告ブロックの影響を受け、購入やリード送信の一部がMetaに届かない。届かないCVは、自動入札の学習に使われない。つまり計測ロスは数字が減るだけでなく、配信の質そのものを下げる。

CAPIは自社サーバーからMetaのサーバーへ直接イベントを送る。ブラウザを経由しないため、規制やブロックの影響を受けにくい。結果として計測できるCVが増え、学習の元データが厚くなる。自動入札の挙動が計測に依存する点は、tCPA学習リセットの条件を整理した記事とあわせて読むと理解が早い。

Pythonで送る最小コードの骨格

用意するのは2つだけだ。Meta イベントマネージャで発行するアクセストークンと、ピクセルID（データセットID）。この2つがあればPythonのrequestsで送れる。

送信先はGraph APIのイベントエンドポイントで、形は https://graph.facebook.com/vXX.X/<ピクセルID>/events になる。vXX.X はGraph APIの最新版に合わせる。バージョンは公式ドキュメント（developers.facebook.com/docs/marketing-api/conversions-api）で確認する。

手順は次の流れになる。（1）url にエンドポイントを組み立てる。（2）1件のイベントを辞書で作る。必須は event_name（例: Purchase）、event_time（UNIX秒）、action_source（website）、user_data（後述のハッシュ済み値）。（3）payload を {"data": [event], "access_token": token} の形にする。（4）requests.post(url, json=payload) で送る。（5）戻り値の events_received が 1 なら受理されている。

この5行程度の骨格が土台になる。ブックマークして、自分の計測イベントに合わせて event_name と user_data を書き換えて使ってほしい。あとは購入完了やフォーム送信のサーバー処理から、この送信関数を呼ぶだけだ。

ハッシュ化で最初に詰まる

最大のつまずきが user_data のハッシュ化だ。メールや電話番号は生のまま送れない。SHA-256でハッシュ化して送る決まりになっている。ここで結果が合わないと、Metaはイベントを受理しても「一致率0%」になり、実質使えない。

原因はほぼ前処理だ。ハッシュ前に、全角を含む空白を除去し、すべて小文字化する。メールは前後の空白を落とす。電話番号は国番号を含めた数字だけにし、記号やハイフンを消す。この正規化を飛ばして生文字列をそのままSHA-256にかけると、Meta側の正規化と食い違い、一致しない。手順は「小文字化→空白除去→SHA-256の16進文字列」の順で固定するとよい。

検証では、同じメールでも前後に空白が1つ残っただけで一致率が跳ね上がる差が出た。前処理を関数に切り出し、全イベントで必ず通す設計にすると事故が減る。

重複排除とテスト送信の確認

ピクセルとCAPIを併用すると、同じCVが二重にカウントされる。これを防ぐのが event_id だ。ブラウザ側とサーバー側で同一の event_id を渡すと、Metaが同じCVと判定して片方に寄せる。IDは注文番号やセッション単位で一意に振る。ここを空にすると二重計上でCVが水増しされ、CPAの見え方まで狂う。

送信の成否は必ずテストで確かめる。イベントマネージャの「テストイベント」で発行される test_event_code を payload に足すと、送ったイベントが管理画面にリアルタイムで表示される。表示されれば経路は正しい。本番送信ではこのコードを外す。付けたまま本番に流すと、テスト扱いになり通常のCVに乗らない。この付け外しの戻し忘れが、地味に多いミスだ。

導入前に潰しておく点を並べる。ブックマークして着手前のチェックリストとして使ってほしい。

  • アクセストークンとピクセルID（データセットID）を発行済みか
  • Graph APIのバージョンを最新に合わせたか
  • user_data を小文字化・空白除去してからSHA-256したか
  • ブラウザ側とサーバー側で同一の event_id を渡しているか
  • test_event_code で受理を確認し、本番前に外したか
  • プライバシーポリシーが第三者へのデータ送信を許容する記載か

計測が整うと、次は結果を社内やクライアントへ共有する場面になる。CVの回復幅や学習の変化を資料にまとめるなら、AIスライド作成ツール「イルシル」を試してみると、図解つきの報告資料を短時間で組める。

まとめ

CAPIは「難しそう」で止められがちだが、Pythonの最小構成なら送信自体は数行で動く。壁になるのはコードの量ではなく、ハッシュ化の前処理・event_idの重複排除・test_event_codeの戻し忘れという3点だ。この3点を先に潰せば、計測ロスを埋めて自動入札の学習を厚くできる。まずはテスト送信で1件を通すところから始めるとよい。あわせてMeta広告レポートのPython自動化まで組めば、計測と分析が一本の自動化ラインになる。

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

本記事の送信コード完全版（正規化関数・event_id採番・エラーハンドリングつき）と、実運用での注意点は、運営者の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を一括生成するツール」のように、効果を秒数や...
続きを読む