email-report

メールレポート

メールマーケターなら誰もが費やしている、3時間の負担があります。前期間の数値を取得し、推移をグラフ化し、差異を説明し、対象者に合ったトーンでコメントを書くことです。このスキルなら、1つのコマンドですべてを実行し、Slackへの通知、CEO宛てメール、取締役会資料のセクションという3つの形式で出力するため、関係者が必要とする形式をすぐに共有できます。

必要なもの： Cogny MCP ＋ 接続済みの ESP。登録

使用方法

/email-report — 月次レポート、3つの形式すべて（デフォルト） /email-report weekly — 過去7日間 /email-report monthly ceo — 月次、CEO宛てメールのみ /email-report weekly slack — 週次、Slackへの更新のみ

前提条件の確認

接続済みの ESP を検出します。接続されていない場合は、処理を停止して接続を促します。

手順

1. 期間を定義する

モード	対象期間	比較対象
weekly	過去7日間	その前の7日間 ＋ 4週間の移動平均
monthly	過去30日間	その前の30日間 ＋ 12週間の移動平均

最初に正確な日付範囲を明示します。

2. データを取得する

ESP ごとのツールアダプター。 使用するツールは接続されている ESP によって異なります。

データ	Klaviyo	Mailchimp	Rule	Get a Newsletter
キャンペーン一覧	list_campaigns	tool_list_campaigns	tool_list_campaigns	tool_list_sent
キャンペーン指標	get_campaign ＋ list_events（指標でフィルター）	tool_get_report	tool_get_campaign_statistics	tool_get_report
オートメーション／フロー一覧	list_flows	tool_list_automations	tool_list_journeys	利用不可
フロー指標	get_flow	tool_get_automation	tool_list_journeys（限定的）	利用不可
購読者リストの規模	list_profiles（件数）	tool_get_audience	tool_list_subscribers（件数）	tool_list_contacts（件数）
送信あたりの売上	✓ metric="Placed Order" を指定した list_events で取得	利用不可	利用不可	利用不可

対象期間と比較対象期間の両方について、次のデータを取得します。

キャンペーン配信：

• 各キャンペーンの件名、送信日、受信者数、開封数、ユニーク開封数、クリック数、ユニーククリック数、配信停止数、バウンス数。
• 売上の紐付け — Klaviyo のみ。 Klaviyo の場合、送信期間を対象に「Placed Order」イベントを取得し、キャンペーンごとに売上を紐付けます。Mailchimp／Rule／Get a Newsletter の場合は、レポートから売上の項目を完全に省き、その旨を明記します。

フロー／オートメーション — ESP によって異なります：

• Klaviyo：フロー名、トリガーされた配信数、フローごとの売上（イベント経由）。
• Mailchimp：オートメーション名、送信数、開封数、クリック数（売上なし）。
• Rule：ジャーニー名 ＋ 限定的な指標。
• Get a Newsletter：フローのオブジェクトはありません。 このセクションは省略します。ユーザーにニュースレターの配信頻度がある場合は、「定期配信」を代替指標として使用します。

リストレベルの指標：

• 期間開始時と終了時のリスト規模
• 期間中の新規購読者数
• 期間中の配信停止数
• 純増数 ＋ 成長率

3. レポート指標を計算する

各期間について、次の指標を計算します。

指標	計算式	重要な理由
送信数	配信済みメールの合計数	配信量の妥当性確認
開封率	ユニーク開封数 / 配信数	件名／プリヘッダーの効果（MPP の影響を受ける）
CTR	ユニーククリック数 / 配信数	実際のエンゲージメント
CTOR	ユニーククリック数 / ユニーク開封数	コンテンツの効果（MPP の影響を受けにくい）
配信停止率	配信停止数 / 配信数	リストの健全性を示す指標
バウンス率	バウンス数 / 送信数	到達性を示す指標
送信あたりの売上	EC 売上 / 配信数（取得可能な場合）	経営幹部が実際に重視する唯一の指標
リスト成長率	（終了時 - 開始時） / 開始時	顧客獲得の健全性

実数値 ＋ 前期間比の変化率 ＋ 移動ベースライン比の変化率を示します。

4. 変化の大きいキャンペーンを特定する

現在の期間のキャンペーンを開封率、CTR、売上で順位付けします。次を特定してください。

• 最も成果の高いキャンペーン — 売上が最も高いキャンペーン（売上データがない場合はCTORで判定）
• 最も成果の低いキャンペーン — 売上／CTORが最も低いキャンペーン
• 異常値 — 指標がユーザーの通常のベースラインから>2σ離れているキャンペーン（予想外の大ヒットまたは大失敗）

それぞれについて、目に見える属性（件名のスタイル、送信時刻、セグメント、コンテンツの種類）に基づく「理由」の仮説を1文で記述します。

5. 変動の理由を説明する

単に「CTRが8%低下しました」と述べるだけでは不十分です。理由を説明してください。次の点を照合します。

• 送信数は変化しましたか？エンゲージメントの低いセグメントへの送信が増えると、売上の絶対額に問題がなくても率の指標は下がります。
• セグメントの構成は変わりましたか？（全リストへの送信か、エンゲージメントの高いユーザーのみか）
• 送信頻度は変わりましたか？（週あたりの送信数増加 → 疲労）
• 特定のキャンペーンが平均を押し下げましたか？（大規模なセグメントに送った1件の不振キャンペーン）
• リストのクリーンアップに変化はありましたか？（大規模な配信停止イベントや再エンゲージメントの期限）
• 外部イベントはありましたか？（祝日、ローンチ、障害）

調査結果は主張 → 根拠の形式で記述します。

「開封率は28%から22%に低下しました。今月の4回の送信のうち2回は休眠状態の180日セグメント（受信者12万人、開封率14%）に送信され、平均を押し下げました。エンゲージメントの高いセグメントへの送信だけを見ると、開封率は実際には34%から36%に上昇しています。」

6. 3つの出力を生成する

6.1 Slack の更新（500文字以内、箇条書き3項目）

📧 Email – <period label>
• Sends: <N> ( <±>% vs prior)  |  Open: <X>% ( <±>pp)  |  CTR: <Y>% ( <±>pp)
• 🏆 Top: "<subject>" — <metric>  |  ⚠️ Watch: <one-line variance call>
• Revenue: $<X> ( <±>% vs prior)  |  List: <±>% net growth  |  Next week: <1-line plan>

6.2 CEO 向けメール（250語以内、文章形式）

Subject: Email performance — <period label>

Hi <CEO first name>,

Quick update on email this <period>:

Headline: <one-sentence summary — is it good, bad, or mixed?>

What happened:
[2-3 sentences explaining volume, rate-metric movement, revenue. Tie to a
business narrative — launches, campaigns, segment focus.]

What's notable:
[1-2 sentences. Top campaign or surprise win or flagged concern.]

What's next:
[1-2 sentences. Concrete plan for next period. Pick ONE action, not five.]

Happy to dig deeper on any of this.

<signoff>

6.3 プレゼン資料のセクション（完全版）

EMAIL PERFORMANCE — <period label>

Summary
  <two-sentence narrative>

Key metrics
  [table: current / prior / rolling / %Δ]
  Sends, Open rate, CTR, CTOR, Unsub rate, Revenue per send, List size

Trend
  [describe what a chart should show — up-and-to-the-right, step change, etc.]

Campaign roundup
  🏆 Best:  "<subject>"
           <segment>, <recipients>, <metric wins>
  📉 Worst: "<subject>"
           <what happened>

Flow performance (if applicable)
  [table of top 3 flows by revenue, with recipient count and conv rate]

What moved the needle
  [2-3 bullets — claim → evidence]

Plan for next <period>
  [2-3 bullets — concrete, owned, measurable]

7. ナラティブを保存する

期間のサマリーを Cogny のコンテキストツリーに保存し、今後の /email-report の実行で過去との連続性を保てるようにします。

{
  "path": "insights/email/reports/<period label>",
  "body": "<the narrative summary + key numbers>"
}

レポートを生成する前に、このパスにある過去のレポートも読み込み、「何が起きたか」のナラティブで参照してください（「これは先月からの傾向と一致しています」／「これは以前指摘した落ち込みからの回復です」）。

8. 注目すべき問題について所見を作成する

重大な問題（配信停止率の急上昇、到達率の低下、売上の急落）があれば、ダッシュボードに反映されるよう所見を作成してください。レポートに記載するだけでは不十分です。

{
  "title": "Unsub rate doubled vs prior month (0.18% → 0.37%)",
  "body": "<which campaigns drove it, which segment, recommended fix>",
  "action_type": "list_hygiene",
  "priority": "high"
}

出力のデフォルト

• ユーザーが形式を指定していない場合は、3つすべてを出力し、明確にラベル付けします。
• Slack 版を最初に提示します。ざっと目を通す場合に最も早く読めるためです。
• ユーザーが数値をコピーできるよう、最後に生の指標テーブルを含めます。

注意事項

• Apple MPP の影響で開封率は変動しやすいため、必ず CTR と CTOR も併記してください。開封率が5ポイントを超えて変動しても CTOR が変化していない場合、実際の行動ではなく MPP の対象ユーザー構成の変化が原因である可能性が高いです。
• 初回実行では比較対象となる前の期間がありません。そのことを明示し、絶対値のみを使用してください。
• **売上の数値を捏造しないでください。**現在、cogny-mcp-proxy で売上データを公開している ESP は Klaviyo のみです（value フィールドを含む「Placed Order」イベント経由）。Mailchimp、Rule、Get a Newsletter については、「この ESP の MCP では売上データを取得できません」と伝え、エンゲージメントのみを報告してください。または、ユーザーにリストの売上データを貼り付けてもらい、その数値を使って CPM／送信あたりの売上を計算してください。