服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Promoted Placements beta 仍是 invite-led；组织必须接受条款，并在已保存的 catalog 上启用 Earn commission。
- placement.commission.percentage.value 是单一总比例，已经包含 Shopify 基础佣金与商家通过 Shop Campaigns 出资的部分。
- 商家出资的额外比例因商品而异，只适用于美国、美元和有效活动商品，且买家需在 Shop 应用或 shop.com 完成购买。
- 佣金只适用于 search_catalog 返回的 Shopify 商家商品；站外商品不含 placement 对象，也不赚取 Promoted Placements 佣金。
这次更新影响哪些 Catalog API 集成？
Shopify 在 2026 年 10 月 27 日宣布，Promoted Placements 进入 beta，并把开启外部平台的 Shop Campaigns 商家纳入 Catalog API 搜索。对已加入项目的集成，符合条件的 search_catalog 结果会返回商家出资的佣金；原有调用结构不需要为这项变化另加新接口。
这不是面向所有 Shopify app 的自动收入功能。Shopify 的 changelog 称它为 beta，项目文档将费率描述为 Developer Preview；文档也提醒费率可能在正式 GA 前变化。
先确认项目和已保存 catalog 的资格
Promoted Placements 是邀请制。符合条件的组织需要加入项目、接受条款，并对已保存的 catalog 启用 Earn commission；未加入项目或未启用的 catalog 不会因此获得商家出资部分。新建 catalog 的默认行为与加入项目前已保存的 catalog 可能不同，应以 Dev Dashboard 中每个 catalog 的实际设置为准。
调用 search_catalog 时继续传入已登记的 catalog.catalog_id。Shopify 说明这个字段用于选择已保存 catalog 的设置；没有项目权限时，响应可能只包含自然商品结果。不要仅凭 API 请求成功就判断已获得推广佣金资格。
佣金字段表示基础比例加商家出资的总比例
对带有 placement 对象的推广商品，直接读取 placement.commission.percentage.value。这个数值已经是该商品适用的总比例：Shopify 基础佣金加上商家通过 Shop Campaigns 出资的部分，不应再把基础比例重复加一次。
Shopify 当前 Developer Preview 文档列出的合资格商品基础比例为 0.3%，并说明费率可能在 GA 前改变。商家活动可以把商品的总比例提高，因此不要把一个商品的比例套用到整个 catalog；报告应保留每个变体返回的实际值。
商家出资的额外比例何时适用？
Shop Campaigns 的商家出资部分只适用于美国、美元计价的有效活动商品。买家必须在 Shop 手机应用或 shop.com 完成购买，才适用高于基础比例的商家出资部分。
如果买家转到商家的网店或其他结账体验完成购买，符合资格时仍可能只有基础比例，不会因为搜索结果显示了更高的总值就自动获得活动增量。项目按自己的归因与资格规则核定最终佣金，取消、退款或无效流量也可能导致佣金被扣回。
哪些结果不包含这个佣金字段？
这项收入只针对 search_catalog 返回的 Shopify 商家商品。自然商品可能没有 placement 对象；站外商品也不在佣金项目内。不要用商家活动的存在推断所有搜索结果都能获得佣金。
站外品牌商品是另一类 Catalog API 结果：它们由品牌自己的网站销售，没有 Shopify checkout，也没有 Promoted Placements 佣金。显示不同来源时，必须向买家明确区分。
怎样保留购买归因？
向买家提供 Shopify 返回的变体 URL 时，要原样保留其中的归因参数。不要把链接改成自有跳转、遮蔽来源或删除参数；Shopify 文档说明这些改动会使转化无法归因。
对账时区分 API 返回的商品总比例、实际购买位置和最终核定的佣金。基础比例、活动增量和实际付款不是同一字段，也不应把 API 预览值写成已到账的收入。
资料来源
常见问题
placement.commission.percentage.value 需要再加 Shopify 基础比例吗？
不需要。Shopify 文档说明该值是总比例，已经包含 Shopify 基础佣金与商家出资的活动增量。
所有 Shop Campaigns 商品都会增加佣金吗？
不会。商家出资的额外比例要求商品属于美国、美元计价的有效活动，且买家在 Shop 应用或 shop.com 完成购买；同时集成还需符合 Promoted Placements 项目资格。
Promoted Placements 已向所有 Shopify app 开放了吗？
没有。Shopify 说访问是邀请制；组织需要接受条款，并为已保存的 catalog 启用 Earn commission。
站外品牌商品能获得 Promoted Placements 佣金吗？
不能。Shopify 文档说明站外商品不会包含 placement 对象，也不属于该佣金项目。