linkfox-temu-ads-eu
管理 Temu 欧洲站搜索推荐广告,支持可投商品检查、ROAS 预测、创建广告、查询详情、修改投放状态和预算、查询店铺广告报表与操作日志,并获取加签资源。适用于已授权 EU 店铺的广告投放维护与效果分析;不适用于商品管理、促销活动、定价、订单、售后或其他站点的广告管理。
SKILL.mdskills/linkfox-temu-ads-eu/SKILL.md
GitHubTemu 欧洲站电商广告
适用范围
适用
查看或维护已授权 Temu 欧洲站店铺的搜索推荐广告,核对可投商品、评估目标 ROAS,查看投放效果和操作历史。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 这些商品能不能投广告 | 可投商品检查:展示不可投原因。 |
| 先看预测,再为这些商品创建广告 | ROAS 预测与广告创建:按用户指定目标准备投放。 |
| 查看广告预算、状态和投放效果 | 广告详情:展示当前设置与可用指标。 |
| 暂停、开启、删除广告或调整预算、ROAS | 广告修改:核对目标商品和变更内容。 |
| 查询店铺广告报表或某商品的变更记录 | 效果分析与日志追溯:标明时间范围。 |
| 获取广告流程中返回的加签文件 | 加签资源获取:保留下载结果。 |
边界
商品管理、促销活动、发品、价格、订单和售后分别使用 linkfox-temu-manage-product-eu、linkfox-temu-promotion-eu、linkfox-temu-add-product-eu、linkfox-temu-price-eu、linkfox-temu-order-eu、linkfox-temu-returns-refunds-eu;美国站或全球站广告使用对应站点技能。
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
创建广告(temu.searchrec.ad.create) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.create |
references/apis/temu-searchrec-ad-create.md |
scripts/eu_ads_searchrec_ad_create.py |
创建广告。 |
广告详情查询(temu.searchrec.ad.detail.query) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.detail.query |
references/apis/temu-searchrec-ad-detail-query.md |
scripts/eu_ads_searchrec_ad_detail_query.py |
广告详情查询。 |
广告可创建商品查询(temu.searchrec.ad.goods.create.query) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.goods.create.query |
references/apis/temu-searchrec-ad-goods-create-query.md |
scripts/eu_ads_searchrec_ad_goods_create_query.py |
广告可创建商品查询。 |
广告操作日志查询(temu.searchrec.ad.log.query) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.log.query |
references/apis/temu-searchrec-ad-log-query.md |
scripts/eu_ads_searchrec_ad_log_query.py |
广告操作日志查询。 |
修改广告(temu.searchrec.ad.modify) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.modify |
references/apis/temu-searchrec-ad-modify.md |
scripts/eu_ads_searchrec_ad_modify.py |
修改广告。 |
店铺广告报表查询(temu.searchrec.ad.reports.mall.query) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.reports.mall.query |
references/apis/temu-searchrec-ad-reports-mall-query.md |
scripts/eu_ads_searchrec_ad_reports_mall_query.py |
店铺广告报表查询。 |
广告 ROAS 预测(temu.searchrec.ad.roas.pred) |
POST /temu/proxy → path:/openapi/router;Body type=temu.searchrec.ad.roas.pred |
references/apis/temu-searchrec-ad-roas-pred.md |
scripts/eu_ads_searchrec_ad_roas_pred.py |
广告 ROAS 预测。 |
| 加签文件下载 | POST /temu/fileDownload |
references/api.md |
scripts/temu_eu_file_download.py |
获取 Temu 加签资源;通用入口为 scripts/temu_file_download.py。 |
前置条件
先确定店铺和授权用途:准备 LinkFox 用户密钥及 Temu 店铺授权。Temu 没有 LinkFox 侧自动 OAuth,需在卖家后台手动复制店铺令牌;可直接使用或保存到本地店铺存储。授权步骤与本地辅助脚本见 references/access-token.md,流程与店铺类型对照见 references/authorization-flow.md。
确认目标 EU 店铺、商品和用户要求的操作范围;参数、默认值、兼容入口与运行约定见 references/api.md,各广告操作的完整字段见上方接口文档。
广告执行流程
- 先检查目标商品是否可创建广告,展示不可投原因。
- 按需查询 ROAS 预测,结合用户指定的投放目标准备创建内容。
- 在用户已明确的范围内创建广告,逐商品核对创建结果。
- 查询广告详情,查看状态、预算、ROAS 和效果摘要。
- 根据用户要求暂停、开启、删除或修改预算与 ROAS。
- 按用户指定时间范围查询店铺广告汇总和明细;需要追溯变更时查询商品操作日志。
单项查询只执行所需步骤;这些步骤不要求每次全部调用。加签资源按需获取。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 调用约束:同一会话、同一参数组合默认只调用一次;业务封装始终禁用响应缓存。失败或空结果时,先核对参数、店铺授权和返回的错误,不自动连续试探;写入结果不明时先查详情,避免重复创建或修改广告。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-ads-eu-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8000 字节:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8000 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
不消耗算力 (限时)。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 区分两套令牌:LinkFox 用户密钥用于网关认证,Temu 店铺令牌用于业务授权。主账号授权、多站点独立授权、有效期和 IP 白名单要求见授权说明。
- 清晰展示结果:先注明店铺和站点,再用表格展示商品、广告状态、预算、目标 ROAS、效果指标及失败原因;缺失信息按实际返回说明,不补造值。
- 区分预测与实绩:ROAS 预测用于创建前参考,广告详情与报表用于回看当前设置和效果;不把预测当成收益承诺。
- 保留指标口径:汇总、广告归因及净额指标分别展示,标明报表时间范围。预算、金额和 ROAS 的单位或倍率以实际响应及 Partner 文档为准,不擅自换算。
- 核对写入目标:创建、删除、开关投放和修改预算或 ROAS 均影响店铺广告;按用户已明确的商品与变更范围执行,逐项解释成功或失败,不以外层请求完成代替商品变更成功。
- 本地辅助能力:支持授权引导、店铺令牌保存与脱敏列表、通用代理及多站点兼容入口;具体 CLI 和参数约定集中在接口参考。
- 维护接入目录:后续明确要求接入新 Ads 操作时,以完整 Partner 请求与响应表为依据,补齐独立接口文档、业务脚本和接口清单,并同步 Partner 目录 与 文档索引。不将尚未接入的广告计划、广告组或创意能力当作现有能力。
使用示例
创建广告
用户:先看看这些商品能否投广告和预测 ROAS,再按我提供的预算创建。
确认店铺与商品,检查可投资格和预测,按用户指定的预算与目标准备创建,展示逐商品结果。
调整广告
用户:把指定商品的广告暂停,或调整为我提供的新预算。
核对目标与变更内容,执行对应修改,说明成功商品与失败原因;结果不确定时先查详情。
查看效果和历史
用户:查看这段时间店铺广告效果,并追溯这个商品的广告变更。
按时间范围查询报表与日志,区分汇总、明细和归因口径,展示可用结果。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。