用途:在分享筛选后的客户列表或受众链接前,以及识别、筛选、排序客户(细分、判断客户身份、找最高消费等)时使用。
主要能力:Audiences 可按字段过滤客户并分享仪表盘链接。过滤字段涵盖产品与时长(latestProduct、allPurchasedProductIds、latestPurchasedOffering、entitlements、offers)、消费与续订(totalSpent 可过滤和排序,totalRenewals 仅可过滤)、订阅状态(status、trial、自动续订意图、ownership)、商店平台国家(platform、latestStore、country、storefront)、日期(首次/最近出现、购买、续订、到期、试用、取消)、归因与实验(媒体来源、campaign、adGroup、关键词、价格实验)、身份与自定义属性(app user ID、email、locale、customAttribute:{key})。
使用方式:无专门 CLI 命令。用 get-audience-filter-options 获取项目特定字段值;用 preview-audience 传入 project_id 和 body.rules(或 body.audience_uuid)只读预览,不保存。排序用顶层参数 sort_by(status、latest_auto_renew_intent、first_seen_at、last_seen_at、total_spent)和 sort_direction(默认 asc 或 desc),样本通常上限 50。数量从 stats 读取(total_customers、active_subscriptions、active_trials、total_revenue),stats.is_approximate 为 true 时用约数。分享链接时使用结果中“Dashboard URL for this result”的精确 URL;无工具结果时才自行构造,格式为 https://app.revenuecat.com/projects/{project_id}/customer-lists/all-customers?filters={encoded_rule},project_id 需去掉 proj 前缀,filters 为 URL 编码的 JSON(groups 内条件 AND,组间 OR)。保存受众链接用 customer_list_id(list…),不能用 audience id(aud…)。
限制:过滤仅适用于 all-customers 列表;项目特定字段和自定义属性必须先获取有效值,不可猜测;totalRenewals 不能排序或作为样本列;无排序时样本无序,不能当作排名;过滤链接为临时视图,需主动询问是否保存为受众。