タスクの詳細
現在「キャンセル」、進捗 0%。工程は全11件中 2件完了。
残りの工程: 03. Click数を取得できるAPI・レポートAPI・CSV出力の有無を確定する / 04. 2アカウントのAPI利用条件・対象サイト・site_id対応を確定する / 05. 出力用スプレッドシートの構成と列定義を確定する / 06. 2025年1月1日以降の過去データ取得方式を確定する / 07. GASの認証情報保管・実行権限・日次実行方式を設計する / 08. 成果数・Click数の取得処理を実装する / 09. 日次集計・スプレッドシート転記・更新反映を実装する / 10. 過去データを取り込み、手動値と照合する / 11. 日次自動実行・再実行方法・障害時対応を確認する
最新報告「方針・進捗の再整理（Click数API確認待ち）」（2026-08-31 16:34:45）
タスクの詳細情報・説明 別ウィンドウで表示
依頼の詳細（2026-08-31更新）
目的
Felmatの2アカウント（ビューティーライフ、きれいサロン／remvy）について、2025年1月1日以降の実績を日次で取得し、アカウント別の専用Googleスプレッドシートへ蓄積する。
既存レポートへの直接出力は行わず、既存レポート側からIMPORTRANGEで出力用スプレッドシートを参照する運用とする。
出力項目
- 日時（日次）
- Click数
- 発生数
- プロモーション名
- サイト名
確認済みの取得方法
共有されたFelmat成果取得APIでは、成果発生日、発生数、プロモーション名、サイト名、成果ステータスを取得できる。取得期間は1回あたり60日以内のため、過去データは期間分割して取り込む。
未確定事項
総Click数は、共有された成果取得APIでは取得できない。成果に紐づくクリック日時は含まれるが、成果に至らなかったクリックを含む総Click数にはならない。
Felmat側で、日次・プロモーション別・サイト別のClick数を取得できる別API、レポートAPI、またはCSV出力機能の有無を確認中。確認結果により、APIのみで進めるか、CSV取得を含む代替方式にするかを確定する。
実装方針
必要データを取得できる方法が確定後、GASで各アカウントのデータを日次取得・集計し、出力用スプレッドシートへ自動転記する。初回は2025年1月1日以降の履歴を取り込み、その後は毎日更新する。
完了条件
- Click数・発生数を必要な粒度で取得できる方法を確定している
- 2アカウント分のデータが出力用スプレッドシートへ日次で蓄積される
- 2025年1月1日以降の過去データを取り込める
- 既存レポートからIMPORTRANGEで参照できる
- 手動値との照合と日次更新の確認が完了している
期限
2026年9月中
対応者メモ・コメント 別ウィンドウで表示
作業工程・チェックリスト
コメント コメントフォーム
Codex
単体HTMLのfelmatレポート体験版を public_html/felmat_report_test/demo.html に作成。conversion.20260701-20260731.csv 3,029件から、日時・プロモーション・サイト・承認状態・デバイス・報酬のみを埋め込み、掲載URL・計測パラメータは除外。API通信なしで、URLパラメータによる期間/集計単位/表示内容/状態/デバイス/対象名/各ID・名称/出力項目の再現、KPI、集計/明細切替、ページング、条件URLコピー、CSV/JSONダウンロードを体験可能。preset=all / approved / mobile / client_requestを用意。ブラウザ確認：全件3,029件、報酬74,721,080円、日次31行が元CSVと一致。status=承認&device=SP&view=detailは1,925件で一致。console errorなし。本番未配置。進捗率は変更なし。
Codex
フィルター結果のCSV・JSONダウンロード機能をローカル実装。現在のGET条件をそのまま引き継ぎ、60日分割でfelmat APIを取得後、対象名・promotion/site ID/名称・statusで絞り込み、日/月/年/プロモーション/サイト単位に集計して出力する。CSVはUTF-8 BOM付き・表計算式注入対策、JSONは条件・生成日時・件数・rowsを含む。既存.htaccessのBasic認証に加えdownload.phpでも未認証401、no-store、キー未設定503を実装。ローカル確認：PHP lint正常、未認証401、認証済みキー未設定503、集計テストは2成果・クリック記録1・報酬350で一致。実API取得はAPIキー記入後に検証するため、チェック09は未完了のまま。
Codex
Web公開領域外の /data-organizing.com/config/felmat.php にAPIキーを保存し、public_html/felmat_report_test から読み込む構成を実装。実キーは未記入で、画面・ログ・Gitへ出さない設計です。プロトタイプ画面には期間、データ種別、集計単位、成果ステータス、出力項目、対象名、プロモーション/サイト名・IDの可変フィルターを設置し、すべてGETパラメータへ反映。今回条件は preset=client_request（2025-01-01〜2026-08-31、日次、対象：ビューティーライフ・きれいサロン・remvy）で用意。felmat APIの60日上限は11リクエストへの分割を確認。総クリック数は成果APIのclick_timeだけでは取得できないため、別クリック/リファラーデータ連携が必要。次は仮データまたは実キー取得後のAPI取得処理を接続する。
Codex
タスク管理を開始しました。
【確認済み】
- 添付のfelmat成果取得API Ver.2.1を確認
- APIは成果レコード取得用で、1回の指定期間は60日以内
- 発生・承認・却下・更新データの種別があり、継続運用では更新データ（type=9）の反映が必要
- 既存data-organizing.comにはfelmatの管理画面取得処理と成果詳細保存処理があるが、今回のプロモーション別クリック数＋成果数レポートとは集計単位が異なる
- タスクを18工程へ分割し、確認済み工程を1件完了に設定
【APIキー配置案】
APIキーはpublic_html内へ置かず、/data-organizing.com/config/felmat.php のように公開ディレクトリ外へ配置する。felmat_report_test側から絶対パスで読み込む。ファイル権限は所有者だけが読み書きできる設定を基本とし、Git・コメント・ログ・画面には値を出さない。
【次の作業】
1. APIキー保存ファイルと読込方式を確定
2. 想定画面と仮データ構造を整理
3. felmat_report_testへプロトタイプを作成
4. プロトタイプ確認後、クリック数・成果数の定義と実データ接続を確定
現時点では本番データ取得・APIキー保存・本番処理変更は未実施です。
【方針・進捗の再整理】
今回のゴールは、Felmatの2アカウント（ビューティーライフ、きれいサロン／remvy）の実績を、2025年1月1日以降・日次でアカウント別の出力用Googleスプレッドシートへ蓄積することです。既存レポートは、必要に応じてIMPORTRANGEで参照します。
共有資料の成果取得APIで確認できた範囲：
- 発生日時、発生数、プロモーション名、サイト名、成果ステータス
- 1回の取得期間は60日以内。履歴取得は期間分割が必要
未確定の範囲：
- 総Click数は成果取得APIの対象外。資料内のclick_timeは成果に紐づくクリック日時であり、総Click数ではない
- Felmat側で、日次・プロモーション別・サイト別のClick数を取得できる別API、レポートAPI、またはCSV出力機能の有無を確認中
先方がマーケ側へ確認する予定のため、現時点ではこの回答待ちです。回答後、APIのみで取得するか、CSV出力を含む代替方式にするかを確定します。
実データ取得、APIキー設定、本番実装、過去データ取込は未着手です。以前のプロトタイプ先行・画面表示中心の記述は、今回の「データ取得とスプレッドシート蓄積を優先する」方針に合わせて更新しました。