Promoted Placements beta now includes Shop Campaigns
- Announced
- Tags
- Catalog
- Severity
- info, set by
reef/rss-rule-v1 - Source
- https://shopify.dev/changelog/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
The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.