分析チャートに「注釈（アノテーション）」 アプリが付けた出来事もグラフ上に出る

図解 ： アプリが追加したアノテーションを分析チャート上で確認できるようになった Analytics / New 分析チャートに「注釈（アノテーション）」 アプリが付けた出来事もグラフ上に出る キャンペーン開始、LP 公開、仕入先変更、ポップアップ出店 ——「いつ何があったか」がチャート上に印として乗る。アプリが追加した注釈は、どのアプリが付けたか（アプリ名・ロゴ）まで表示される。レポートの数値そのものは一切変わらない。 このページの構成 そもそも何が変わるのか（30秒で理解） 図解 ： 注釈が付いてからチャートに出るまで 注釈で印を付けられる出来事 突き合わせられる指標 アプリ由来の注釈は「出どころ」が見える できること／できないこと 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 そもそも何が変わるのか 分析チャートに 注釈（Annotations） が表示できるようになった。 注釈は 特定の日付、または日付範囲 に「この日、こういう出来事があった」という印を置くもの。 さらに アプリが追加した注釈 も Shopify 管理画面のチャート上に出るようになり、 どのアプリが付けたか （アプリ名やロゴ）が併記される。 従来 ： グラフは数字だけ 「7/12 に売上が跳ねている」まではわかるが、 なぜ跳ねたか はチャートの外。スプレッドシートや Slack の記憶を掘り返して突き合わせるしかなかった。 これから ： 出来事がグラフに乗る キャンペーン開始・LP 公開・仕入先変更などの注釈が同じチャート上に並ぶ。 数値の変化と出来事を同じ画面で読める 。アプリ由来なら出どころ（アプリ名・ロゴ）も表示。 注釈はレポートのデータを変えない。 あくまで「その数値に何が影響したかを理解するための文脈」を足すだけ。集計ロジックや数値そのものへの影響は無い。 2 図解 ： 注釈が付いてからチャートに出るまで 読み方のコツ ： 注釈は 「原因の候補」を提示するだけ 。記事も「何が指標に影響した かもしれない かを理解する助けになる」という表現に留めている。注釈が立っている＝因果が証明された、ではない。 3 注釈で印を付けられる出来事 記事に挙げられている例。「特定の日付」だけでなく「日付範囲」にも付けられるのがポイント。 商品ローンチ 新商品の発売日 マーケ施策 キャンペーン期間 セールイベント 割引施策の実施日 仕入先の変更 サプライヤー切替 LP 公開 ランディングページ ポップアップ出店 期間限定の実店舗 ビジネスの節目 マイルストーン その他 列挙は「such as」の例示 4 突き合わせられる指標 記事が「注釈と比較できる分析データ」として挙げている指標。売上系だけでなく 返品・フルフィルメント実績 まで含まれるのが実務的に効く。 記事が挙げている「読み解きの型」 1 キャンペーン期間中に売上は動いたか 日付範囲の注釈と売上カーブを重ねる。 2 LP 公開後に CVR は変わったか 公開日を境に前後比較する。 3 仕入先／倉庫変更後に配送実績は変わったか フルフィルメント指標と突き合わせる。 5 アプリ由来の注釈は「出どころ」が見える 今回のアップデートの主眼はここ。アプリが注釈を追加した場合、Shopify 管理画面は そのアプリ名やロゴを表示する 。レポートを見ている人が「この文脈情報はどこから来たのか」を判断できる。 誰が付けたかが並記される 注釈のラベルにアプリ名／ロゴが添えられる。複数のアプリが同時に注釈を投げている環境でも、情報源の切り分けができる。 レビュー時の信頼性判断に効く 記事の言葉では「レポートを見返しているときに、その文脈がどこから来たのかを理解する助けになる」。出どころ不明の注釈が混ざらない設計。 6 できること／できないこと 項目 今回の記事に書かれていること 判定 チャート上に出来事の印を表示 特定の日付、または日付範囲に注釈を表示できる できる アプリ追加分の識別 アプリが追加した注釈は、アプリ名やロゴで出どころを表示 できる 複数指標との突き合わせ 売上／セッション／CVR／AOV／販売点数／返品／フルフィルメント実績 できる レポートの数値を書き換える 「注釈はレポートデータを変更しない」と明記 しない 因果の証明 「何が指標に影響した かもしれない かを理解する助けになる」文脈追加まで しない 対象プラン・対象国 言及なし 記載なし 手動で注釈を追加する手順 この記事には手順の記載なし（詳細はヘルプ「Annotations in Shopify reports」を参照） 記載なし API / GraphQL / Webhook 仕様 言及なし 記載なし 対応するアプリの一覧 言及なし（「アプリが注釈を追加したとき」という記述のみ） 記載なし 対象レポート／チャートの範囲 「your analytics charts」とのみ。個別レポート名の指定は無し 記載なし 「記載なし」の行は この Changelog 記事に書かれていない という意味。実装・提案の前にヘルプページ「Annotations in Shopify reports」と実際の管理画面で確認すること。 7 技術者が押さえるべき5つのポイント 1. 表示レイヤーの機能であって、集計レイヤーではない 「注釈はレポートデータを変更しない」と明言されている。既存の集計・エクスポート・BI 連携への影響を心配する必要は無い。 可視化の上に重ねるオーバーレイ と捉えるのが正しい。 2. 「点」だけでなく「期間」も表現できる a specific date or date range と書かれている。ローンチのような単発イベントと、セール期間・ポップアップ出店のような継続イベントを、同じ仕組みで扱える。 3. アプリ由来注釈には provenance（出どころ）が付く アプリ名やロゴが表示される仕様。 誰の主張なのか が UI 上で保証されるので、複数アプリが注釈を出す環境でもノイズと有用情報を分離できる。 4. 追加方法・API 仕様の記載は無い この記事は「表示されるようになった」という告知。 アプリ側からどう登録するか（Admin API / GraphQL / スコープ）の記載は無い 。自社アプリから注釈を投げたい場合は開発者ドキュメントを別途確認する必要がある。 5. 相関の可視化であって、因果推論ではない 記事は一貫して「what might have influenced your metrics」という言い方をしている。注釈は「この時期にこれがあった」を並べるだけで、寄与度を計算してくれるわけではない。 効果測定の設計（比較期間・季節性・他施策との重なり）は従来どおり人間側の責任 。分析レポートに転載するときは、注釈＝仮説であることを明示しておくと後で揉めない。 8 業務に活かせる3つのユースケース USE CASE 1 キャンペーン振り返り会の「あの時何やってたっけ」を撲滅する 課題 月次レビューで売上の山谷の理由を毎回思い出せず、施策カレンダーとアナリティクスを別ウィンドウで突き合わせる作業が発生している。担当者が変わると再現不能になる。 打ち手 キャンペーン・セール・商品ローンチを注釈として日付範囲で登録し、売上／セッション／CVR のチャートに重ねて確認する運用に切り替える。 効果 振り返りの準備工数が減り、担当者交代時も「何がいつあったか」がチャート上に残る。ダッシュボードのスクリーンショットがそのまま報告資料になる。 技術メモ 注釈はレポートデータを変更しないので、既存の集計や外部 BI エクスポートには影響しない。手動での注釈追加手順はこの記事に記載なし、ヘルプ「Annotations in Shopify reports」で要確認。 USE CASE 2 LP・サイト改修のリリースを注釈化して、CVR 影響を即日で読む 課題 制作会社側で LP 公開やテーマ改修をリリースしても、クライアント側のアナリティクスには何も記録が残らず、CVR が動いたときに「改修のせいか、季節要因か」で議論が止まる。 打ち手 ランディングページ公開・テーマデプロイを注釈として登録し、CVR／セッション／AOV のチャートで公開日前後を比較。記事が挙げる「LP 公開後に CVR が変わったか」の型をそのまま使う。 効果 リリースと数値変動の対応関係が同一画面で示せるようになり、改修の説明責任を果たしやすくなる。次の改修提案の根拠にも転用できる。 技術メモ 注釈は因果を証明しない（記事も「影響した かもしれない 」という表現）。比較期間の取り方と他施策の重なりは自分で設計すること。 1 つの注釈に 1 つのリリースだけを対応させる と後の解釈がぶれない。 USE CASE 3 仕入先・倉庫の切替を注釈化して、フルフィルメント／返品への影響を追う 課題 3PL や仕入先を切り替えた後に配送遅延やクレームが増えても、切替日が記録されていないため「切替前後で本当に悪化したのか」を数値で示せない。 打ち手 仕入先変更・倉庫移管の実施日を注釈として登録し、フルフィルメント実績と返品のチャートに重ねる。記事が挙げる「仕入先・倉庫の更新後にフルフィルメント指標が変わったか」の型を適用。 効果 物流ベンダーとの交渉やレビューで、切替タイミングと実績変化を同じチャートで提示できる。SLA 見直しの一次資料になる。 技術メモ 返品はラグが大きい指標なので、切替直後だけ見ると悪化が過小評価される。注釈は「点」ではなく 移行期間を日付範囲 で置くと読みやすい。対象レポートの範囲は記事に記載なし、実際のチャートで注釈が出るか要確認。 9 提案で使える1行サマリ 「キャンペーン・LP 公開・仕入先変更といった ビジネス上の出来事を、分析チャートの上に直接“印”として重ねられる ようになった。 アプリが付けた注釈は どのアプリ由来かまで表示 され、売上・CVR・返品・フルフィルメント実績と突き合わせて読める。 レポートの数値は一切変わらない、純粋な文脈の追加。 まずは施策カレンダーを注釈に移し替えるところから。」 source ： changelog.shopify.com / view-app-added-annotations-on-your-analytics-charts published 2026-07-29 ／ generated 2026-07-31