記事のサマリー(TL;DR)
- App Events API が全アプリ向けに提供開始。単一エンドポイントに任意イベントを送信し Dev Dashboard Logs で一元監視
bulk_edit_completedやsync_failedなど機能利用・パフォーマンス・コンバージョン信号を自由に定義可能- Partner Dashboard でメーターを定義すれば、任意のアプリイベントを使用量ベース課金(Usage-based charge)に転換できる
Shopify アプリ開発者・パートナーが押さえておくべき運用監視の変化
Shopify パートナーとして日本市場向けにカスタムアプリや公開アプリを開発・運用している場合、これまでは Webhook や Function 実行ログとアプリ独自のトラッキングが分断されがちでした。App Events API により、ビジネスロジック固有のイベント(例:onboarding_completed、automation_created)を Shopify の Dev Dashboard Logs に集約でき、障害検知・機能利用率の把握・課金根拠の記録を単一の場所で行えます。使用量課金モデルを採用している、あるいは検討しているアプリでは、追加コードなしに任意イベントをメーターと紐づけられる点が実装コストの削減につながります。
詳細
App Events API とは
App Events API は、アプリから Shopify へ任意のイベントを送信するための単一エンドポイントです(2026年5月12日より全アプリ向けに提供)。送信されたイベントデータは Dev Dashboard Logs に自動的に集約され、Webhook・Function 実行・API 呼び出しのデータと並べて確認できます。
1. 単一 API エンドポイントへのイベント送信
event_handle と任意の属性(attributes)を定義してエンドポイントに送信します。主なユースケースは以下の4カテゴリです。
| カテゴリ | イベント例 |
|---|---|
| 機能利用(Feature usage) | bulk_edit_completed、report_generated、automation_created |
| ワークフロー(Workflows) | onboarding_completed、campaign_sent、export_finished |
| パフォーマンス(Performance) | sync_failed、api_timeout、rate_limit_hit |
| コンバージョン信号(Conversion signals) | limit_hit、premium_viewed、milestone_achieved |
| 課金対象アクティビティ(Billable activities) | order_processed、email_sent、label_printed |
2. Dev Dashboard での確認
送信されたすべてのアプリイベントは Dev Dashboard Logs に自動的に表示されます。Shopify が提供する Webhook・Function 実行・API 呼び出しのデータと同一画面で監視できるため、障害発生時の原因特定やパフォーマンス分析が容易になります。
3. オプション:アプリイベントを課金に転換
Shopify App Pricing の仕組みを利用すると、任意のアプリイベントを使用量ベースの課金(usage-based charge)に転換できます。手順は以下の通りです。
- Partner Dashboard でメーター(meter)を定義する
- メーターを対応する
event_handleに紐づける - Shopify 側がメータリングと請求処理を自動で実行する
追加コードは不要で、現在の課金方式に関わらず全アプリで利用可能です。