販売チャネルアプリの注文帰属設定が強化

8月 03, 2026

API CHANGE

販売チャネルアプリの
注文帰属設定が強化

API 2026-07から、より粒度の高い注文ソース追跡が可能に

2026年7月リリースのAPIバージョン2026-07より、sales channel appがマーケットプレイス・地域・アカウント・サーフェスといったアプリ/チャネルより細かい粒度で注文帰属を定義・管理できるようになります。既存のデフォルト帰属（アプリ・チャネル単位）のみを使うアプリは変更不要です。新機能を活用するにはchannel_config拡張を持つsales channel appである必要があります。

OVERVIEW

01変更点の全体像：Before / After

NEW FEATURES

02新機能のまとめ

作成・管理

orderAttributionDefinitionUpsertミューテーションで帰属定義をupsert。orderAttributionDefinitionsクエリで一覧取得。GraphQL Admin APIから削除も可能。

チャネル接続時の定義

チャネル接続作成時にチャネルベースの帰属定義を作成できる。order_attribution_config拡張で静的な帰属ソースを定義することも可能。

注文・カート作成時に渡す

orderCreateにhandle渡し対応。Storefront API cartCreateミューテーションやカートパーマリンクでもsource_name経由でhandle指定可能。

読み取り

Order.attributionで解決済みの帰属詳細を取得。Order.channelInformationは引き続き利用可能だが非推奨（deprecated）となった。

FLOW

03注文帰属の解決フロー

USE CASES

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

課題: 複数マーケットプレイス（例：Amazon・楽天・Yahoo!）を1つのsales channel appで管理しており、注文がどのマーケットプレイス経由かを区別できない
打ち手: 各マーケットプレイスごとにorderAttributionDefinitionUpsertで帰属定義を作成し、注文作成時に該当するhandleをsourceNameに渡す
効果: Shopify管理画面やレポートでマーケットプレイス単位の売上・注文数を正確に把握でき、チャネル戦略の意思決定精度が向上する
技術メモ: アプリはchannel_config拡張を持つsales channel appである必要がある。orderAttributionDefinitionsクエリで定義一覧を確認してからhandleを使用すること

課題: グローバル展開しているブランドで、地域（日本・APAC・欧米など）ごとの注文帰属を分けてレポートしたいが、現状はチャネル単位でしか集計できない
打ち手: order_attribution_config拡張で地域ごとの静的帰属ソースを定義し、カート作成（cartCreate）時に地域に対応するhandleをsource_nameに渡す
効果: 地域別の売上レポートが自動的に分類されるようになり、マーケティング予算配分や在庫計画の地域最適化が容易になる
技術メモ: Storefront APIのcartCreateミューテーション、またはカートパーマリンク経由でもsource_nameパラメータを使ってhandleを渡せる

課題: B2B販売チャネルで企業アカウントごとの注文帰属を管理したく、営業担当者やアカウントマネージャーが担当顧客の注文を正確に把握できていない
打ち手: 企業アカウントごとに帰属定義を作成し、orderCreateミューテーションでhandle付きの注文を作成。Order.attributionで帰属情報を読み取るワークフローを構築する
効果: アカウント単位の売上追跡が可能になり、B2B顧客ポータルやCRM連携の精度が向上。契約更新や与信判断に活用できるデータが揃う
技術メモ: 定義handleがShopifyに承認済み定義と一致しない場合はapp帰属にフォールバックするため、handleの管理・同期ロジックを実装することが推奨される

DEV NOTES

05技術者向けポイント

項目	内容
対象APIバージョン	2026-07以降。それ以前のバージョンでは利用不可
アプリ要件	`channel_config`拡張を持つsales channel appのみ対象。通常アプリは利用不可
新規ミューテーション	`orderAttributionDefinitionUpsert`（作成・更新）、Admin APIからの削除も対応
新規クエリ	`orderAttributionDefinitions`クエリで定義一覧を取得可能
フォールバック挙動	`sourceName`が承認済み定義と一致しない場合、Shopifyはアプリ単位の帰属にフォールバック。ハンドル管理が重要
非推奨フィールド	`Order.channelInformation`はdeprecatedとなった。新規実装では`Order.attribution`を使用すること
変更不要なケース	デフォルトのアプリまたはチャネル単位の帰属のみ使用するアプリは対応不要