SuperAPI AI 工具集

audiences

通用与其它

查看项目

更新于 10-16 07:24

技能介绍

用途:在同一个 placement 上,让不同用户看到不同的付费墙或流程。一个 segment 是一组必须全部匹配的过滤器;一个 audience 是 placement 中的一条记录,包含一个 segment(或空)、一个付费墙或流程、一个优先级。placement 从最低优先级向上检查,返回用户匹配的第一条;默认 audience(segment_ids: [])排在最后兜底。所有改动写入 placement 后立即对真实用户生效。

主要能力:管理 segments 与 audiences。不负责付费墙或流程本身的构建与发布(由 flow-generator 负责)、placement 迁移(migrate-placements)、Apple Search Ads 相关 segment(ads-manager)、SDK 属性上报(adapty-integration)、audience 上的 A/B 测试(见 https://adapty.io/docs/add-audience-paywall-ab-test)。

使用方式:先解析 $ADAPTY(adapty --version,必要时 npm i -g adapty@latest 或 npx --yes adapty@latest)。常用命令:segments list --app <app> --page-size 100;segments get --app <app> <id> --json;segments create --app <app> --title <t> --filter <f>;segments update --app <app> <id> --title <t> --filter <f>;placements list --app <app> --page-size 100 --json;placements get --app <app> <id> --json;placements update --app <app> <id> --title <t> --developer-id <d> --audiences '<json>'。过滤器格式为 field:OPERATOR:value,支持 IN、NOT IN、>、>=、<、<=、BETWEEN、IS NULL、IS NOT NULL;无 =,等值用 IN 单值。字段名必须来自已确认列表(ip_country、install_date、age、total_revenue_usd、campaign、ad_group、creative)或从已有 segment 的 filters[] 读取,不得猜测。

适用场景:按国家、语言、应用版本、平台、收入等条件分流付费墙或流程。

限制:写入前须展示前后 audience 表确认;不得改变请求外用户所见;不得遗漏已读 audience;版本须严格 SemVer(如 2.0.0);语言用 2 位 ISO 639-1;一个 audience 只含一个 segment,“或”需两条记录;新 audience 放在默认之前;不要用 placements --paywall-id。字段名错误会被拒绝,但含义错误的合法名会被静默接受。