Skip to main content
POST
Create an attribution link
使用该接口为某个品牌商品创建推广归因链接。请求必须包含 brand_idproduct_id,也可以传入可选的 tracking_iddestination_url 字段说明:
  • tracking_id:客户侧追踪标识,最多 200 个字符。建议把下游系统里的 tag、campaign、source 等追踪值放在这里;前后空白会被裁剪,不能包含 ASCII 控制字符。创建成功后会在创建响应和列表响应中返回规范化后的值,后续报表也会使用该字段做下游归因。
  • destination_url:Amazon 落地页 URL,可选。未传入时默认使用商品详情页;它决定用户点击后进入哪个 Amazon 页面,不承担追踪 tag 的作用。
成功时返回 201{ "link": LinkDTO } 创建成功后,响应里的 marketplace 会返回该链接对应的 Amazon 站点域名,例如 amazon.comamazon.co.ukamazon.de。该字段用于判断链接所属站点,不表示合作状态,也不是追踪 tag。 可能的错误:
  • 400 invalid_request:请求体不完整或字段无效。
  • 403 forbidden_resource:当前 Token owner 无权访问该品牌或商品。
  • 403 ads_not_connected:品牌广告连接状态不满足创建要求。
  • 404 product_not_found:商品不存在或不可访问。
相关接口:如需查看已创建的归因链接,请使用 列出归因链接

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
brand_id
string
必填

品牌 ID。Brand ID.

product_id
string
必填

商品 ID。Product ID.

destination_url
string

Amazon 落地页 URL;可选,默认使用商品详情页。Amazon landing page URL; optional, defaults to the product detail page.

tracking_id
string

客户侧追踪标识;可选,前后空白会被裁剪,不能包含 ASCII 控制字符。创建和列表响应会返回规范化后的值,后续报表也会使用该字段做下游归因。Client-side tracking tag; optional, leading/trailing whitespace is trimmed and ASCII control characters are rejected. Create/list responses return the normalized value, intended for downstream reporting.

Maximum string length: 200

响应

Attribution link created