Dev Dashboard で UI Extension の「読み込み失敗」が見えるようになった

図解 ： Dev Dashboard で Checkout / Customer Account UI Extension の読み込み失敗が見えるようになった Dev Dashboard / UI Extensions / モニタリング Dev Dashboard で UI Extension の「読み込み失敗」が見えるようになった Checkout と Customer Account の UI Extension が、アプリ起因でどれくらい・どのストアで読み込みに失敗しているかを Dev Dashboard で確認可能に。近日中にマーチャント側にも健全性ステータスとアラートが表示される予定。 このページの構成 そもそも何が変わるのか（30秒で理解） 仕組み図解 ： 失敗が検知されてから届くまで Dev Dashboard で見られる 3 つの情報 カウントされる失敗／されない失敗 近日公開 ： マーチャント側の健全性ステータス 今やるべき対応（3ステップ） 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか UI Extension の読み込みに失敗すると、購入者には作り込んだ体験が表示されない。しかもアプリ開発者側からは気づきにくかった。 今回、 Dev Dashboard がこの「マウント失敗」を可視化 し、原因の特定と修正を早く進められるようになった。 これまで ： 失敗しても気づけない Extension が読み込めなくても、購入者の画面から「消える」だけ。開発者側では問題を見つけにくかった。 これから ： 失敗率・ストア・ログが見える アプリのホームの Operations に失敗率と失敗の多いインストール先ランキング、Logs に失敗イベントが記録される。 対象 ： Checkout UI Extensions Customer Account UI Extensions 2 仕組み図解 ： 失敗が検知されてから届くまで マウント失敗（mount failure） とは ： Extension が購入者の画面に読み込まれ、表示されるまでの過程で失敗すること。今回は アプリ側が原因の失敗だけ が集計対象になる。 3 Dev Dashboard で見られる 3 つの情報 Operations Extension mount failure rate 指定した期間内に Extension が何回読み込まれ、そのうち何割が失敗したか。 Operations 失敗率の高いインストール先 Top extension installations by failure rate。 現行バージョン の Extension が最も失敗しているストアと Extension target のランキング。読み込み 10 回以上のインストールが対象。各行からそのストアのマウント失敗ログへ移動できる。 Logs UI extension イベント マウントに失敗するたびに新しいイベントが記録される。 store／extension／target／result で絞り込める。 4 カウントされる失敗／されない失敗 計上される アプリが原因の失敗 失敗率・ランキング・Logs に反映されるのはアプリ起因の失敗だけ。 計上されない アプリ以外が原因の失敗 Shopify 側 ネットワーク 購入者のブラウザ これらは集計に含まれず、Logs にも出ない。 「アプリ起因」をどう判定しているか、具体的にどんなエラーが該当するかは記事に記載なし。 5 近日公開 ： マーチャント側の健全性ステータス 今後、マーチャントも 設定 ＞ アプリ で、自分のストアに入っている Extension について同じ健全性情報を見られるようになる。各 Extension の現行バージョンに、 直近 7 日間の読み込み をもとにステータスが付く。 ステータス 失敗率の条件 継続期間 マーチャントへの影響 評価なし 週の読み込みが 10 回未満 — ステータス表示なし Warning 5% 超が失敗していると確信できる 3 日間 設定 ＞ アプリ にステータス表示 Critical 50% 超が失敗していると確信できる 2 日間 ステータス表示 ＋ Shopify 管理画面でアラート Critical アラートの受信者 ： レポートを閲覧でき、かつそのアプリにアクセスできるストアスタッフ。公開日は記載なし（「近日」とのみ記載）。 6 今やるべき対応（3ステップ） 1 Dev Dashboard のアプリホームを開く Operations セクションで Extension mount failure rate を確認。 2 失敗の多いストア／target を特定 ランキングの行からそのストアのマウント失敗ログへ。 3 Logs で絞り込んで修正 store／extension／target／result でフィルタして原因を追う。 記事の呼びかけは 「マーチャントに見える前に、今のうちに Dev Dashboard で確認して直そう」 。 7 技術者が押さえるべき5つのポイント 1. アプリ起因の失敗だけが数字に出る Shopify・ネットワーク・ブラウザ起因は除外。数字が出たら「自分のコードの問題」として扱ってよい前提の指標。 2. 評価対象は「現行バージョン」 ランキングもマーチャント向けステータスも、Extension の現在のバージョンが対象。修正版をリリースした後の評価は新バージョンの読み込みで行われると読める。 3. 「10 回」がしきい値 ランキングは読み込み 10 回以上のインストールのみ。マーチャント向けも週 10 回未満は評価なし。低トラフィックのストアでは数字が出にくい。 4. target 単位で切り分けられる ランキングは「ストア × Extension target」、Logs も target で絞り込める。特定の配置場所だけで落ちるケースの特定に使える。 5. 放置するとマーチャントに見える ＝ 猶予は短い 失敗率 50% 超が 2 日続くと Critical となり、マーチャント管理画面にアラートが出る。 デプロイ後に Dev Dashboard を見る運用 を組み込まないと、マーチャントからの問い合わせで初めて知ることになる。API・Webhook でこの指標を取得できるかは記事に記載なし。 8 業務に活かせる3つのユースケース USE CASE 1 リリース後チェックに「マウント失敗率」を組み込む 課題 Checkout UI Extension を更新しても、本番で一部ストアだけ表示されていないことに気づけない。 打ち手 デプロイ後の確認項目に Dev Dashboard の Extension mount failure rate を追加。日付範囲をリリース前後で比較する。 効果 Warning／Critical になる前に異常を検知し、マーチャントに見える前に修正できる。 技術メモ 評価は現行バージョン単位。リリース直後は読み込み回数が少ないため、10 回以上溜まってからランキングを確認する。 USE CASE 2 「特定ストアでだけ出ない」問い合わせの一次切り分け 課題 マーチャントから「チェックアウトにアプリの表示が出ない」と言われても、再現できず調査が長引く。 打ち手 Logs の UI extension イベントを store と target で絞り込み、そのストアでマウント失敗が記録されているか確認する。 効果 失敗ログがあればアプリ側の問題として調査に進め、無ければアプリ起因ではない可能性を前提に切り分けられる。 技術メモ Shopify・ネットワーク・ブラウザ起因の失敗はログに出ない仕様。「ログに無い ＝ 表示された」とは言い切れない点に注意。 USE CASE 3 構築案件で導入アプリの健全性をマーチャントと一緒に確認する 課題 Checkout／顧客アカウントに複数アプリの Extension を入れているが、どれが正常に動いているか運用側から見えない。 打ち手 マーチャント向け表示の公開後、設定 ＞ アプリ のステータスを定例の運用チェック項目に入れる。Critical アラートを受け取るスタッフ権限も確認しておく。 効果 不具合アプリの早期発見と、アプリベンダーへの根拠ある問い合わせが可能になる。 技術メモ アラートは「レポート閲覧権限」と「そのアプリへのアクセス権」の両方を持つスタッフに届く。公開時期は記載なし。 9 提案で使える1行サマリ 「Checkout／顧客アカウントの UI Extension が アプリ起因でどれだけ読み込みに失敗しているか を、 Dev Dashboard でストア・target 単位まで追えるようになった。 近日マーチャントにも Warning／Critical で見える ので、今のうちに確認・修正しておくべき。」 source ： shopify.dev / changelog / Dev Dashboard now shows when checkout and customer account UI extensions fail to load published 2026-11-06