開発者向けの変更です。
アプリの App Events を、Shopify の管理画面からも送れるようになりました。
管理画面からも App Events を送れるようになります
発表は2026年11月18日の developer changelog です。
出典: Shopify developer changelog「App Events: Send events from Admin UI extensions and embedded apps」2026年11月18日
https://shopify.dev/changelog/posts/app-events-send-events-from-admin-ui-extensions-and-embedded-apps
- フラグは「Update」
- タグは「Admin Extensions」と「App Bridge」
- Version は 2027-01
At Editions, we launched app events for Checkout and Customer Account UI extensions. This release adds the Shopify admin, so you can now track app usage across all three surfaces. This is a new, optional API, so no action is required.
(Editions で、チェックアウトとお客様アカウントの UI 拡張向けに app events を出しました。今回は Shopify の管理画面が加わり、3つの場所でアプリの使われ方を追えます。新しい任意の API なので、対応は要りません)
送る方法は shopify.appEvents.emit() の呼び出し。
渡すのは、イベントのハンドル(名前)と、任意の属性です。
対象は API 2027-01 以降の拡張と、App Bridge の埋め込みアプリです
今回新たに送れるようになったのは、管理画面の UI 拡張と埋め込みアプリの2つです。
UI 拡張は、API のバージョンが 2027-01 以降のものに限られます。
Embedded apps (App Home): Apps that use App Bridge can call the same method from the app’s pages in the Shopify admin.
(埋め込みアプリ「App Home」:App Bridge を使うアプリは、管理画面のアプリのページから同じメソッドを呼べます)
Embedded apps do not need a specific API version.
(埋め込みアプリには、決まった API のバージョンは要りません)
埋め込みアプリの側は、バージョンを問わない形。
一部の場所では、呼んでも何も送られません。
On should-render targets and data targets, emit() sends nothing and resolves {success: false, error: ‘Emit is unavailable.’}. An embedded app gets the same result where the Shopify admin does not offer App Events.
(should-render のターゲットと data のターゲットでは、emit() は何も送らず、失敗の結果を返します。管理画面が App Events を提供していない場所では、埋め込みアプリも同じ結果になります)
属性に個人を特定できるデータは入れません
公式は、属性に入れてはいけないデータを具体的に挙げています。
Shopify adds your app and the shop to each event, so you do not need an access token or a shop ID. Do not include data in attributes that could identify an individual, such as names, email addresses, phone numbers, staff member IDs, or customer IDs.
(Shopify が各イベントにアプリと店を付けるので、アクセストークンや店の ID は要りません。属性には、名前、メールアドレス、電話番号、スタッフの ID、顧客の ID など、個人を特定できるデータを入れないでください)
アプリと店の情報は、Shopify の側で付く仕組み。
名前やメールアドレス、顧客の ID は、属性に入れない決まりです。
送れる数には上限があり、管理画面から送るイベントは請求に使われません
UI 拡張1つあたりの上限は、まとめて送れるのが最大20イベント、その後は1秒に2イベントです。
Each Admin UI extension can send a burst of up to 20 events, then 2 events per second. An embedded app has the same limit, shared across the app in one Shopify admin tab. Events from Admin UI extensions and embedded apps are not processed for billing. To report usage for Shopify App Pricing, send a billing event from your app backend.
(管理画面の UI 拡張は、それぞれ最大20イベントをまとめて送れ、その後は1秒に2イベントです。埋め込みアプリにも同じ上限があり、管理画面の1つのタブの中でアプリ全体で分け合います。UI 拡張と埋め込みアプリからのイベントは、請求には使われません。Shopify App Pricing の利用量を報告するには、アプリのバックエンドから請求のイベントを送ります)
埋め込みアプリの上限は、1つのタブの中でアプリ全体の共有。
Shopify App Pricing の利用量を報告するには、アプリのバックエンドから請求のイベントを送ります。
Shopify が受け付けたイベントは Dev Dashboard のログに出ます
受け付けられたイベントは、バックエンドから送ったものと一緒に Dev Dashboard のログに並びます。
Events that Shopify accepts are visible in the Dev Dashboard logs, together with the events that your app backend sends. Events do not identify the extension that sent them or the staff member who used it.
(Shopify が受け付けたイベントは、アプリのバックエンドが送るイベントと一緒に Dev Dashboard のログに出ます。イベントからは、送った拡張も、使ったスタッフも分かりません)
どの拡張から来たか、どのスタッフが使ったかは、イベントに残りません。
公式の手順の最後も、ログでの確認です。
Run shopify app dev and use the extension or app in a development store.
… Open Logs in the Dev Dashboard to confirm that your events arrive.
(shopify app dev を動かし、開発ストアで拡張かアプリを使います。…Dev Dashboard の Logs を開き、イベントが届くかを確かめます)
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 管理画面から送ったイベントが、Shopify Analytics の店のレポートにも出るかは書かれていません。書かれているのは Dev Dashboard のログに出ることです
- 上限を超えたときに、超えた分がどう扱われるかは書かれていません
- イベントの名前と属性に、数や長さの決まりがあるかは書かれていません
- 店の側で、アプリがイベントを送っているかを知る方法は書かれていません
- 🔴 本記事は Related docs の3本を読んでいません。開発ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは、使う場合だけ次の5つです。
- 管理画面の UI 拡張から送るなら、
shopify.extension.tomlの api_version を 2027-01 以降にする shopify.appEvents.emit()を、イベントのハンドル(名前)と属性をつけて呼ぶ- 属性に、名前・メールアドレス・電話番号・スタッフや顧客の ID など、個人を特定できるデータを入れない
- 開発ストアで動かし、
emit()の結果を見る。success が false なら error で原因を読む - Dev Dashboard のログで届いたかを見る
店がやることは、今回の発表の範囲ではありません。
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「App Events: Send events from Admin UI extensions and embedded apps」2026年11月18日
https://shopify.dev/changelog/posts/app-events-send-events-from-admin-ui-extensions-and-embedded-apps
上記の Shopify 公式の情報だけを一次情報として使っています。

