Amazon Ads オフライン HTML レポート

できること

GGRN の原典での Skill 名は amazon-ads-analyzer です。このディレクトリ項目では、そのオフラインレポート用途を示します。販売者が用意した Amazon 広告エクスポートを、検証可能な自己完結型 HTML レポートに変換します。観測された行、計算した指標、仮定、信頼度メモを分けて扱い、ACOS、TACOS、ROAS、CTR、CVR、CPC、CPM、損益分岐 ACOS をオフラインで確認してから、管理された形で共有できます。Amazon にログインしたり、販売者の Ads Console や Business Reports を取得したり、入札を変更したり、キャンペーンを開始・公開したりはしません。

使う場面

レポートがすでにローカルにあり、繰り返し可能な週次・月次レビュー、財務担当への引き継ぎ、変更前後の比較、共有用の意思決定資料が必要なときに使います。短い検索語 CSV の PPC 診断より広く、アカウントまたはキャンペーンの根拠と単位経済をまとめます。最新レポートの取得には、先に Amazon Ads Report Downloader を使います。検索語 CSV がすでにある場合は Amazon PPC Analyzer で診断し、その後この Skill でオフライン成果物を作成します。

入力

Amazon の XLSX または CSV エクスポート、スクリーンショット、貼り付けた指標を用意します。サイトまたは marketplace、Seller か Vendor か、レポート名、日付範囲とタイムゾーン、通貨、campaign/SKU/ASIN の範囲、目的、目標 ACOS、価格、COGS、FBA またはフルフィルメント費、紹介料、返金・返品、総売上を記録します。各値を観測値、計算値、仮定のいずれかに分類してください。画像や貼り付けデータは手動転記と照合が必要です。

出力

元のワークフローが示すローカル成果物は二つです。正規化データの report-data.json と、生成された自己完結型ビューの AMAZON-ADS-REPORT.html です。実用的なレポートには、式の入力、ACOS/TACOS/ROAS、効率指標、損益分岐 ACOS、日付と marketplace の範囲、信頼度ラベル、分母がない項目の注記を含めます。HTML はオフラインで開けますが、共有前にアカウント ID、ASIN、キャンペーン名などの機微情報を削除してください。このディレクトリ項目はこれらのファイルを生成していません。

ワークフロー例

デモのみ、未実行。 次の匿名化された数値は計算例のために作った仮定であり、Amazon のエクスポート、API 応答、実行記録ではありません。

seller_ads:
  marketplace: US
  period: 2026-08-01/2026-08-31
  impressions: 500000
  clicks: 10000
  orders: 400
  ad_sales_usd: 10000
  spend_usd: 2000
  total_sales_usd: 20000
unit_economics:
  price_usd: 40
  cogs_usd: 12
  fulfillment_usd: 7
  referral_fee_usd: 6
market_report_context:
  source: hypothetical market-side report context
  keyword: insulated bottle
  estimated_searches: 120000
  sponsored_traffic_share: 0.08

この仮定では、ACOS は 2,000 / 10,000 = 20%、ROAS は 10,000 / 2,000 = 5.0、TACOS は 2,000 / 20,000 = 10% です。CTR は 10,000 / 500,000 = 2%、CVR は 400 / 10,000 = 4%、CPC は $2,000 / 10,000 = $0.20、CPM は $2,000 / 500,000 * 1,000 = $4.00 です。損益分岐 ACOS は ($40 - $12 - $7 - $6) / $40 = 37.5% です。市場レポートのコンテキストは別の注記として保持し、販売者の実績の証明や販売者側フィールドの補完には使いません。ここでは report-data.json、HTML ファイル、市場 API 応答を生成していません。

元のソースにあるコマンドを参考として示します。このレビューでは実行していません。

python scripts/build_report.py --data report-data.json --out AMAZON-ADS-REPORT.html

対応エージェントとセットアップ

固定したソースには Claude Code、Codex、Cursor、Windsurf、Gemini、Goose が記載されています。2026-09-15 に確認した根拠は、固定コミットの SKILL.md、その commit、MIT LICENSE、skills.sh のディレクトリエントリ です。LICENSE には Amazon との非提携および商標に関する注意書きもあります。導入は手動です。固定ソースを確認したうえで、作者の README に従ってください。この項目は source-reviewed であり、install-tested ではなく、インストールコマンドを掲載していません。

アカウント、API、権限の要件

オフライン経路では、記載されたレポートスクリプトのためにローカルファイルシステムの読み書きと shell 実行が必要です。この項目は Amazon アカウントや API key を要求しません。認証済みの販売者アカウントからエクスポートを取得した場合、その認証は Skill の外側で行われています。Ecommerce Data API を呼び出す場合は別のアカウントと認証情報が必要で、個別に承認してください。

制限と人による確認の境界

期間、通貨、marketplace、アトリビューション期間、集計範囲が一致しなければ比率は意味を失います。ACOS は広告費を広告帰属売上で割り、TACOS は広告費を総売上で割ります。損益分岐 ACOS は、含める変動費、返金、税、割引によって変わります。Seller と Vendor のレポートは項目が異なることがあり、遅延や分母の欠落も判断を変えます。スクリーンショットや貼り付け値は自動検証されません。信頼度は追跡可能性のラベルであり、統計的証明やセキュリティ検証ではありません。共有前に計算を確認して機微情報を削除し、HTML だけで利益保証や入札変更の承認をしないでください。

Ecommerce Data API と組み合わせる

別途承認した場合、amazon.keywords.research でキーワードの需要、成長、競争、コンバージョン、PPC の背景を補足できます。amazon.traffic.sources ではトラフィック源の構成を、amazon.keywords.traffic-stats では ASIN の集計トラフィックキーワード統計を補足できます。追加の呼び出しを行う前に、正規の キーワード調査ドキュメント とトラフィックソースドキュメント を確認してください。任意のライブ市場コンテキストには Ecommerce Data API キーを作成 できますが、オフラインレポート自体には不要です。これらは市場側のコンテキスト用インターフェースで、販売者の非公開広告コンソール、広告レポート、Business Reports を読み取るものではありません。API 応答の時刻、marketplace、出典を販売者エクスポートと分けて記録し、市場推定を実際の広告実績として扱わないでください。