Skip to main content

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. No action is required.

What changed

Merchants running Shop Campaigns with external platforms turned on now include the Catalog API as one of those platforms. On their products, placement.commission.percentage.value returns the total rate, combining the merchant's commission and Shopify's base rate. Buyers who click a product with merchant-funded commission land in Shop (shop.com).

Who is affected

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.

What to do

No action is required, because commission comes back in the same field you already read. Keep passing your enrolled catalog.catalog_id on search_catalog and send buyers to the variant URL exactly as Shopify returns it. If you show a commission rate in your own reporting, read it from placement.commission.percentage.value, since it now varies by product.

Earning applies to search_catalog only, and only to products from Shopify merchants.

Related docs

Was this page helpful?