SuperAPI AI 工具集

geography-performance-review

营销与增长

查看项目

更新于 10-16 06:10

技能介绍

用途

地理业绩分析用于回答商家关于「哪些国家在驱动收入、订单、客户、退款」以及「地理结构是否发生变化」的问题。它面向 WooCommerce 店铺运营场景,把按账单国家(billing country)汇总的销售、订单、客户、退款、覆盖率和税务背景信号,整理成一份简洁的地理业绩回顾。

主要能力

  • 读取店铺档案,获取店铺名称、货币、地区、税务设置、配送与支付背景、目录背景。
  • 获取按账单国家划分的收入明细,包括付费收入、订单数、客单价、售出商品、退款、退款率、收入占比、待处理/挂起状态的国家行、覆盖率、不同国家数量、对比字段以及掉出排名的国家。
  • 获取按订单量排序的国家背景,用于发现订单量可观但收入较低的国家。
  • 获取全店客户结构,包括客户总数、新客与回头客数量、复购率、各分群收入与客单价、重叠客户等。
  • 针对最多三个信号最强的国家,获取活跃客户聚合背景,包括匹配的活跃客户数、占活跃客户比例、生命周期消费、平均生命周期订单、平均客单价及样本说明。
  • 获取按国家的退款信号,包括退款金额、退款次数、涉及订单、该行付费毛收入、退款率、退款占比、平均退款天数等。
  • 当商家询问税务门槛、VAT、GST、OSS、销售税或合规准备情况时,获取全店收入与税务背景,仅用于店铺层面的背景提示与实际检查。

使用方式

若用户未指定日期范围,默认使用 period: last_30_days 且 compare: true;若指定了明确范围,则遵循该范围,自定义范围应传入精确的 date_start 与 date_end。对比框架为上一段对应周期。分析过程中需区分不同数据框架:国家销售与退款按周期与账单国家划分;全店客户结构按周期但不按国家拆分;客户聚合模式使用活跃基数框架。税务与门槛背景仅供参考,不是申报指导或合规结论。

当商家询问收入、订单、客户、退款、税务阈值等问题时,可输出包含以下部分的回顾:快照、按国家的收入与订单、变动与集中度、客户结构、退款信号、覆盖率与税务背景、可操作的后续行动。用户问题若涉及渠道归因或具体产品在某国的表现,仅在返回数据支持的情况下给出,并且只能使用受支持的字段(已确认的产品 ID、归因渠道、来源、活动、设备)。

适用场景

  • 商家想知道哪些国家贡献了主要的付费收入与订单。
  • 商家想了解收入是否集中在少数国家,以及周期之间国家的进出与变动。
  • 商家怀疑某些国家的退款需要排查。
  • 商家希望了解全店新客与回头客结构,以及重点国家的活跃客户背景。
  • 商家询问与主要国家收入相关的税务门槛背景(仅作提示)。

限制

  • 这是基于历史账单国家的回顾,不代表配送目的地、税务建议、营销效果或因果关系。
  • 不推断州、城市、邮编、配送国家、会话、转化率、广告花费、ROAS、季节性、竞品影响、国家层面的客户动机或法律义务,除非商家提供该背景。
  • 不使用手工计算差额、百分比、占比、平均值或排名变化,须直接读取返回的预计算字段。
  • 待处理/挂起状态的国家收入属于支付流水,不算已收收入也不算损失收入。
  • 若账单国家覆盖率低于 95%,或未分配行较显著,需提及覆盖缺口,但不得猜测具体国家。
  • 退款是诊断信号,不能证明产品质量、配送失败、欺诈、支付争议或客户不满等问题。
  • 小样本(订单、客户或退款在 5 以内)需先说明数量再解读百分比。
  • 税务门槛内容必须以「建议咨询会计师或税务工具」的口径表达,不得声明已注册、须注册、已越线或应缴金额。
  • 最终回答中不得出现工具名、参数名、数据库表、内部字段路径或原始字段名,需翻译成商家语言。
  • 若商家要求州、城市、邮编或配送国家细节,应说明本回顾仅按账单国家进行,并指向 WooCommerce 订单页面手动排查。

输出结构

输出包含:店铺信息、周期、对比周期、国家基准(账单国家)、快照、按国家的收入与订单、变动与集中度、客户结构、退款信号、覆盖率与税务背景、可操作的后续行动。语气需冷静、商业化和谨慎。