Codexで業務改善 023

広告CSVをCodexで集計。未着・訂正版と、合算できない成果を分けた

執筆:Dignowa編集部公開:更新:読む目安:約5分

広告媒体ごとにCSVを落として、Excelへ貼り付け直す。Dignowaでは架空2媒体・2日分から確認用レポートを作りました。未着追加後は22,500円、訂正後は23,000円・220クリックです。費用とクリックをまとめても、計測条件が違う成果数は合算していません。

列名、文字コード、費用の単位を読み分ける

Coopelのアナグラムの事例には、管理画面からCSVを取得し、Excelやスプレッドシートへ貼り、月・週・キャンペーン別に集計する仕事が紹介されています。2025年2月19日公開の説明です。6人で毎朝180分相当を自動化したという報告は同社の値で、Dignowaの短縮時間ではありません。同社はDignowaの顧客ではありません。

アナグラムの導入事例

CodexがPythonの読み取り・検査・結果表を実装・実行しました。AIは開発に使い、計算はルールで処理します。媒体Aは日本語列・CP932、Bは英語列・UTF-8です。Aの費用は1円の100万分の1の整数単位で、10,000円を10,000,000,000として渡し、Bの円単位へそろえました。

同じ「秋の集客」という名称でも、媒体・アカウント・キャンペーンIDで分け、001の先頭0も残しました。CSVの合計行は明細との照合だけに使い、二重に足していません。入力と金額は独自の架空データで、実出稿・支払はしていません。

未着を費用0円にせず、訂正版は置き換える

受領予定はA・Bの9月28日・29日の4組です。初回はBの29日がなく、届いた3組の22,000円・210クリックだけが既知でした。全体の費用やクリック率は未確定です。

入力 費用・クリック 扱い
初回3組 22,000円・210回 全体未確定
Bの29日を追加、4組 22,500円・210回 全体集計
Aの28日を訂正、4組 23,000円・220回 旧版を置き換え

追加Bは500円・表示1,000回・クリック0回です。訂正Aのキャンペーン002は9,000円・90回から9,500円・100回へ変え、増分500円・10回だけを反映しました。同じ訂正版の再読、受領順を逆にした入力でも結果は一致しています。

同じ日付・版で内容違いなら保留します。版は独自の受領記録で管理し、実媒体の番号ではありません。ファイル名、元行、版を残し、訂正額の元CSVもたどれます。

初回の結果

追加後の結果

比率は合計から計算し、成果は計測条件ごとに読む

訂正後は表示13,500回、クリック220回です。クリック率は220÷13,500×100で約1.63%、クリック単価は23,000÷220で約104.55円です。行ごとの率を単純平均せず、合計の分子と分母から計算しました。表示用の丸めた値と、計算に使った値を残しています。

費用500円・クリック0回のBの29日は、クリック単価を計算不能にしました。0円と出して費用なしに見せません。

成果の仮条件はAがクリック後7日、Bがクリック後1日・表示後1日です。条件が違うのでAの9件とBの2件を分け、全体成果数とCPAは合算しません。CPAは1成果あたりの費用です。

意図したエラーと、配布ZIPの不備を分けて記録した

USD、タイムゾーン違い、負の費用、未登録キャンペーン、合計行不一致、受領後の変更を保留する検査を行いました。改行のあるキャンペーン名と小数成果も含みます。コマンドを5回実行し、50項目が通りました。これらの条件で集計処理の想定外の不具合は見つかっていません。

一方、配布ZIPではコードの参照先とCSVの格納先がずれていました。配置を直し、別フォルダーへ展開して再実行した5回・50項目も通っています。意図した入力エラーと、実際の配布不備を同じ失敗件数にはしません。

実行と検査の記録

ZIPを展開して実行した記録

架空の画面から取得したCSVでも、再集計できた

実際に操作した架空媒体のCSVダウンロード画面。実在する広告サービスの画面ではありません。
実際に操作した検証専用のCSV取得画面。広告サービスへのログインや接続は行っていません。

専用のダウンロード画面を作り、ブラウザーで5つのCSVを取得しました。保存したコピーは元データと一致し、そこからの再集計も訂正後の結果と一致しています。実広告サービスへのログインやCoopelの操作ではありません。

取得操作は、ツールから結果が返るまで約4時間の間隔がありました。原因未確認のため、CSVの処理性能や短縮時間の根拠には使っていません。

実務で使うなら普段のCSVと提出用レポートを比べ、列名、金額単位、期間、成果の定義を確認する進め方を想定しています。受領予定と版は今回設定ファイルへ記入しました。誰が管理するかも決める必要があります。実媒体の自動取得、ログイン維持、定期実行、現場の時間短縮は未検証です。

検証記録

取得ファイルの照合記録

参考情報