ShopifyQLでShop Campaignsの成果データを取得

8月 11, 2026

Developer Changelog

ShopifyQLでShop Campaigns
パフォーマンスデータを取得可能に

新スキーマ shop_campaign_insights が登場。広告費・ROAS・CACなどをAPIで直接クエリ

対象: ShopifyQLを利用するAnalytics・レポーティングアプリ開発者／ 提供開始: 2026年8月10日／ 変更点: shop_campaign_insights スキーマが追加され、既存の read_reports スコープのみでShop Campaignsの詳細指標を取得できるようになりました。

1Before / After：何が変わったか

2取得できる指標と次元

📊 メトリクス（指標）

広告費 (Ad Spend)
売上 (Sales)
注文数 (Orders)
ROAS（広告費用対効果）
平均注文金額 (AOV)
平均顧客獲得コスト (CAC)

📐 ディメンション（次元）

キャンペーン名
顧客セグメント
時間軸: 時間 / 日 / 週 / 月 / 四半期 / 年
タイムゾーン: 店舗設定に準拠

3業務に活かせる具体ユースケース

課題: 複数店舗のShop Campaigns成果を一元管理したい代理店・ブランドが、管理画面を行き来してCSVをエクスポートする手作業が発生していた
打ち手: shop_campaign_insights をShopifyQLで定期クエリし、BI ツール（Looker Studio / Tableau 等）に自動連携するパイプラインを構築する
効果: 全店舗のROAS・広告費・売上を一画面で比較でき、予算配分の意思決定を迅速化
技術メモ: 既存の shopifyqlQuery フィールドを使用。追加スコープ不要。パートナーダッシュボード経由で複数マーチャントに認可を得ること

課題: 広告キャンペーン開始・予算変更のタイミングと売上変動の相関を、アナリティクス画面上で視覚的に確認できなかった
打ち手: Analytics Annotations APIを活用し「キャンペーン開始」「予算変更」などのイベントをマーチャントのアナリティクスチャートに注釈として追加する
効果: 施策タイミングと売上指標の因果関係が一目で把握でき、キャンペーン改善サイクルが加速
技術メモ: Analytics Annotations APIはShopify開発者ドキュメントに別途仕様が公開されている（元記事より）。詳細は公式ドキュメントを参照

課題: レポーティングアプリ内でShop Campaignsのメトリクスを表示したいが、自前でデータを保存・管理するコストをかけたくない
打ち手: Analytics Web Componentsを使い、データストレージなしでShop Campaignsのメトリクスをアプリ UI に直接埋め込む
効果: インフラコストを抑えながら、マーチャントに統合されたキャンペーンレポート体験を提供できる
技術メモ: Analytics Web Componentsは元記事で同時発表された機能。詳細仕様・使い方は公式ドキュメントで確認のこと

4技術者向け実装ポイント

項目	詳細	ステータス
クエリフィールド	既存の `shopifyqlQuery` フィールドをそのまま使用	追加作業なし
必要スコープ	`read_reports` のみ。新規スコープ追加は不要	既存スコープ
スキーマ名	`shop_campaign_insights`	新規追加
時間粒度	時間単位〜年単位（店舗タイムゾーン準拠）	記載あり
Analytics Web Components	データ保存不要でメトリクスをアプリUIに埋め込み可能	同時発表
Analytics Annotations API	マーチャントのアナリティクスチャートに注釈を追加可能	同時発表
移行手順	既存ShopifyQL統合があればスキーマ名を指定するだけ	移行不要
料金・プラン	元記事に記載なし	要公式確認