获取 Google Shopping 商家广告落地 URL

接口说明

该接口用于根据广告点击追踪参数 shop_ad_aclk，获取 Google Shopping 商家广告的完整跳转 URL。返回结果中会卖家设置的完整广告链接，以及从 Google Shopping 到最终落地页之间的重定向路径。

请求方式

GET https://api.seermartech.cn/v3/merchant/google/sellers/ad_url/$shop_ad_aclk

计费说明

该接口按请求次数计费。

由于原文未提供明确单价，无法直接换算人民币。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

---

请求参数

路径参数

字段名	类型	说明
shop_ad_aclk	string	唯一的广告点击归因参数。可通过 /v3/merchant/google/products/task_post/ 或 /v3/merchant/google/sellers/task_post/ 的结果获取。

---

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段名	类型	说明
version	string	当前 API 版本。
status_code	integer	通用状态码。完整错误码请参考 /v3/appendix/errors。建议在接时做好异常与错误处理。
status_message	string	通用状态信息。
time	string	接口执行时间，单位秒。
cost	float	本次请求总费用，单位 USD。可按该字段结算。
tasks_count	integer	tasks 数组中的任务数量。
tasks_error	integer	tasks 数组中返回错误的任务数量。
tasks	array	任务结果列表。

tasks 数组字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式。
status_code	integer	任务状态码，范围通常为 10000-60000。
status_message	string	任务状态信息。
time	string	任务执行时间，单位秒。
cost	float	当前任务费用，单位 USD。
result_count	integer	result 数组中的结果数量。
path	array	本次 GET 请求的 URL 路径。
data	object	请求参数回显。
result	array	结果数组。

result 数组字段

字段名	类型	说明
ad_aclk	string	唯一广告点击归因参数。
ad_url	string	广告的完整 URL。
ad_url_redirects	array	从 Google Shopping 跳转到最终 ad_url 之前经过的重定向 URL 列表，最多返回 10 个。

---

调用示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/merchant/google/sellers/ad_url/DChcSEwiSl5TKpbPoAhVFmdUKHfa_B_wYABADGgJ3cw&sig" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

# 使用 sellers 或 products 任务结果中获取到的 ad_aclk
ad_aclk = "DChcSEwiSl5TKpbPoAhVFmdUKHfa_B_wYABADGgJ3cw&sig"

url = f"https://api.seermartech.cn/v3/merchant/google/sellers/ad_url/{ad_aclk}"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

if data.get("status_code") == 20000:
 print(data)
else:
 print(f'请求失败: {data.get("status_code")} - {data.get("status_message")}')

TypeScript

import axios from "axios";

// 使用 sellers 或 products 任务结果中获取到的 ad_aclk
const adAclk = "DChcSEwiSl5TKpbPoAhVFmdUKHfa_B_wYABADGgJ3cw&sig";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/google/sellers/ad_url/${adAclk}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error.response?.data || error.message);
 });

---

响应示例

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.6697 sec.",
 "cost": 0.000001,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "shops_list",
 "api": "merchant",
 "function": "sellers",
 "se": "google",
 "ad_aclk": "DChcSEwj2qKzGv_rrAhWXIK0GHbB0BQEYABAHGgJwdg"
 },
 "result": [
 {
 "ad_aclk": "DChcSEwj2qKzGv_rrAhWXIK0GHbB0BQEYABAHGgJwdg",
 "ad_url": "https://example.com/product?utm_source=shopping&utm_medium=cpc",
 "ad_url_redirects": [
 "https://www.google.com/aclk?...",
 "https://tracking.example.com/redirect?...",
 "https://example.com/product?utm_source=shopping&utm_medium=cpc"
 ]
 }
 ]
 }
 ]
}

---

使用说明

• shop_ad_aclk 是本接口的核心参数，通常来自商品列表或商家列表采集任务的结果。
• 如果需要还原广告真实跳转链路，可重点解析 ad_url_redirects。
• ad_url 可用于识别卖家是否附带了跟踪参数、联盟参数、再营销参数或自定义落地页参数。
• 建议同时校验顶层 status_code 和任务级 status_code，只判断 HTTP 状态码。

---

错误处理建议

完整状态码与错误信息请参考 /v3/appendix/errors。接时建议重点处理以下场景：

• 路径中的 shop_ad_aclk 缺失或格式错误
• 广告点击参数已失效，无法解析到广告 URL
• 平台广告链路发生变更，导致重定向路径不完整
• 接口返回任务级错误，但 HTTP 请求本身成功

---

实用场景

• 还原广告落地链路：获取从 Google Shopping 广告点击到最终页面的完整跳转路径，帮助排查追踪参数丢失、跳转异常或中间页问题。
• 识别卖家投放参数：提取 ad_url 中的 UTM、联盟标记或渠道参数，用于分析竞品投放策略和归因设计。
• 监控重定向合规性：检查 ad_url_redirects 是否存在过多跳转、异常域名或非预期中转链接，降低广告审核与落地风险。
• 分析竞品落地页策略：结合商家广告 URL 判断竞品是否按产品、地区、渠道使用不同落地页，优化自身投放结构。
• 排查抓取与归因问题：当商品广告点击后到达页面与预期不一致时，可通过本接口快速定位是广告参数、重定向链路还是最终落地页导致的问题。