開発者向けの変更です。
Shopify の Catalog API で商品を検索して見せるアプリ・サービスの開発者と、Shop Campaigns を出している店に関わる話です。
Promoted Placements がベータになり、Shop Campaigns が含まれます
掲載は2026年10月27日、Shopify の developer changelog です。
フラグは「Update」。
対象の面は Catalog です。
出典: Shopify developer changelog「Promoted Placements beta now includes Shop Campaigns」2026年10月27日
https://shopify.dev/changelog/posts/promoted-placements-beta-now-includes-shop-campaigns
Promoted Placements is now in beta, and it includes Shop Campaigns. When a search _catalog result comes from a merchant running Shop Campaigns, you earn the commission that merchant funds, added to Shopify’s base rate.
(Promoted Placements はベータになり、Shop Campaigns を含みます。search_catalog の結果が Shop Campaigns を出している店のものなら、その店が出す手数料を、Shopify の基本の率に上乗せして受け取れます)
受け取るのは、ベータの条件を満たし、Catalog API で商品を見せる側です。
外部のプラットフォームを有効にした店では、Catalog API もその1つになります
店の側の変化は、次の1文に書かれています。
Merchants running Shop Campaigns with external platforms turned on now include the Catalog API as one of those platforms.
(外部のプラットフォームを有効にして Shop Campaigns を出している店では、Catalog API もそのプラットフォームの1つに含まれるようになりました)
店の手数料が届く先に、Catalog API を使う側が加わる、という整理になります。
手数料の率は、商品ごとに同じフィールドで返ります
On their products, placement.commission.percentage.value returns the total rate, combining the merchant’s commission and Shopify’s base rate.
(それらの店の商品では、placement.commission.percentage.value が、店の手数料と Shopify の基本の率を合わせた合計の率を返します)
使うフィールドは、これまでと同じ placement.commission.percentage.value です。
ただし率は商品ごとに変わります。
自分の集計で率を見せているなら、このフィールドから読むよう公式は書いています。
店が手数料を出している商品をクリックした購入者は、Shop に移ります。
Buyers who click a product with merchant-funded commission land in Shop (shop.com).
(店が手数料を出している商品をクリックした購入者は、Shop(shop.com)に移ります)
対象は、招待で参加したベータの組織だけです
Organizations in the Promoted Placements beta that have accepted the terms and turned on Earn commission for a saved catalog. Access is invite-led, and you can join the waitlist from the docs.
(Promoted Placements のベータに入り、規約に同意して、保存したカタログで Earn commission を有効にした組織が対象です。参加は招待制で、資料から順番待ちに登録できます)
- ベータに参加している
- 規約に同意している
- 保存したカタログで「Earn commission」を有効にしている
手数料が付くのは search_catalog だけ。
対象も、Shopify の店の商品に限られます。
開発者がやることは無いと、公式は書いています
No action is required, because commission comes back in the same field you already read.
(手数料は、すでに読んでいるのと同じフィールドで返るので、対応は要りません)
続けて、次の2つを求めています。
- 登録したカタログの
catalog.catalog_idをsearch_catalogに渡し続けること - 購入者を Shopify が返すバリアントの URL のとおりに送ること
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- Shop Campaigns の店の手数料の率や、Shopify の基本の率の値は書かれていません
- 日本の店が Shop Campaigns を出せるか、日本の店の商品がこの対象に入るかは書かれていません
- 店の側で、Catalog API への配信だけを止められるかは書かれていません。書かれているのは「external platforms turned on」の店が対象、ということまでです
- ベータの招待の条件や、正式な提供の時期は書かれていません
- 本文のリンク先の Catalog API の資料は、本記事では読んでいません
- 🔴 本記事は Catalog API や Shop Campaigns の画面を開いて確かめていません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやること
- ベータに参加している開発者は、
search_catalogに登録したカタログのcatalog.catalog_idを渡し続け、購入者を返されたバリアントの URL のとおりに送る - 自分の集計で手数料の率を見せている開発者は、商品ごとに
placement.commission.percentage.valueから読む - Shop Campaigns を出している店は、外部のプラットフォームを有効にしているかを確かめ、Catalog API も外部のプラットフォームの1つに含まれることを知っておく
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。3 は店向けに足した整理で、一次ソースは店に何かを求めていません。
出典
- Shopify developer changelog「Promoted Placements beta now includes Shop Campaigns」2026年10月27日
https://shopify.dev/changelog/posts/promoted-placements-beta-now-includes-shop-campaigns
上記の Shopify 公式の情報だけを一次情報として使っています。
次の事項は「未確認」として扱い、推測で補っていません。
- 手数料と基本の率の値
- 日本の店が対象に入るか
- Catalog API への配信だけを止められるか
- ベータの招待の条件と正式な提供の時期

