アプリが analytics_app_events 拡張でイベントを宣言し、App Events API で送信すると、マーチャントはレポートビルダーや ShopifyQL（FROM app_events）でアプリの指標・ディメンションを分析できるようになる。
アプリの数字を見るには別ダッシュボードを開く必要がある。アプリ開発者は自前で分析画面を作り、ホストする必要があった。
マーチャントは Shopify を離れずにアプリの指標を分析。レポートビルダーでも ShopifyQL でも扱える。開発者は分析基盤を自作・ホスト不要。
「メール送信」のような一般的なイベント種別は、Shopify が定義した標準イベントを使う。例 ： shopify.marketing.email_sent。一覧は Standard event registry に記載。
アプリ固有の 属性（attributes）と指標（metrics） を持つイベントを独自に定義できる。
標準イベントをベースに、自分のアプリ独自の属性・指標を追加できる。
| 状況 | 扱い | 必要な対応 |
|---|---|---|
| アプリの活動を Shopify Analytics で見せたい開発者 | 対象 今回の新機能を利用できる | 拡張で宣言 → deploy → API で送信 |
| Dev Dashboard ログや課金用に既に App Events を送っている | 自動では出ない Analytics には反映されない | Analytics に出したい場合のみ、リリース済みの Analytics App Events 宣言と一致させる |
| 既存の App Events 連携を変えたくない | 変更不要 | 対応なし（Analytics 表示を望む場合のみ対応） |
| 料金・対応プラン・データ保持期間 | 記載なし | ガイド・API リファレンスで要確認 |
shopify.extension.toml に analytics_app_events 拡張を作り、標準 or カスタムイベントを宣言。
shopify app deploy でリリース設定をリリースして、宣言を有効な状態にする。
アプリがインストールされたストア向けに、宣言と一致するイベントを送る。処理後にレポート可能になる。
メールマーケティングアプリが標準の「メール送信」イベントを宣言する例。
[[extensions]] type = "analytics_app_events" handle = "app-events" [[extensions.events]] name = "shopify.marketing.email_sent" kind = "standard"
イベント処理後、送信メール数を日次の時系列で集計する例。
FROM app_events SHOW emails_sent TIMESERIES day
同じデータはレポートビルダー（GUI）でも探索できる。
イベントは analytics_app_events 拡張で宣言し、shopify app deploy でリリース済みになっていることが前提。宣言に一致しないイベントは Analytics に出ない。
Dev Dashboard ログや課金のために送っているイベントは、そのままでは Analytics に現れない。載せたいなら宣言側を合わせる設計が必要。
一般的な種別（メール送信など）は標準イベントが用意されている。足りない分は「標準を拡張」→ それでも無ければ「カスタム」という順で検討すると整理しやすい。
マーチャントは FROM app_events と指標名（例 ： emails_sent）で ShopifyQL を書く。宣言する指標・属性がそのままマーチャントの分析語彙になる点を意識して命名する。
記事では「自前のアナリティクスを構築・ホストする必要がない」と明言。アプリ内レポート画面の開発・保守を Shopify Analytics に寄せられる可能性がある。既存ダッシュボードとの機能差（粒度・保持期間など）は記載なし のため、置き換え判断は要検証。
shopify.marketing.email_sent を宣言・deploy し、送信ごとに App Events API へ送る。emails_sent を日次で追える。アプリの存在感が分析の場に常駐する。