Shopee-店铺广告v1.0.6

卖家每天定时调用 get_total_balance 查询已授权 appType=ad 店铺的广告账户余额，当余额低于阈值时触发通知并引导充值，避免广告因余额耗尽而停投。该流程依赖 auth skill 确认广告授权状态，并可通过 developerProxy 自动路由到 AD Token。

运营人员使用 get_all_cpc_ads_daily_performance 与 get_product_campaign_daily_performance 拉取按天维度的广告花费、点击、转化与 ROI 数据，汇总成日报推送给团队。结果落盘为 JSON 后可用 jq 抽取关键字段，避免大响应体污染上下文。

卖家围绕主推 SKU 通过 create_manual_product_ads 建立手动广告计划，再借助 get_recommended_keyword_list 获取推荐词并用 edit_manual_product_ad_keywords 调整出价与关键词。整个过程须先确认店铺已存在 appType=ad 授权，否则需走 authorize_url.py 引导授权。

营销团队在策划大促时调用 check_create_gms_product_campaign_eligibility 校验店铺是否具备 GMS 广告资格，随后使用 create_gms_product_campaign 创建活动，并在次日用 get_gms_campaign_performance 复盘投放表现。适合需要精细化运营 Shopee 站内广告的成熟卖家。

当广告接口返回 401/402 或提示余额不足时，按 references/onboarding.md 排查 API Key 配置与算力问题；同时用 auth skill 的 authorized_stores.py 确认识别出的店铺确实具备 appType=ad，避免将 ERP 授权误判为广告已授权。该场景偏工程运维，适合技术支持人员。

面向中小 Shopee 卖家提供广告托管服务，按管理的店铺数或接口调用算力阶梯计费。平台统一处理 appType=ad 授权、广告创建、效果报表与余额预警，卖家只需关注投放策略。

聚合 get_all_cpc_ads_daily_performance、get_product_campaign_daily_performance 等数据，为卖家生成广告诊断报告与关键词/出价优化建议。通过持续订阅收取服务费，帮助卖家提升广告 ROI。

将 Shopee Ads 能力集成进跨境电商 ERP 或数据中台，通过 developerProxy 统一转发接口并管理 AD Token。ERP 按广告 API 调用量向卖家或按订阅套餐向商家收费，形成平台级收入。