本基线中,正式环境尚未开放 submission一次提交形成的结果记录:read Key 路径。检查提交时使用独立的已登录会话;交付记录导出仍使用 Data Key。
执行前先查操作开放范围与兼容性。
客户反馈记录有问题时,先整理反馈涉及的活动Developer 组织的一组数据工作及其相关设置 ID、订阅范围、日期和记录 ID。有 Data 读取权限的 API Key 只能重读其获准订阅中已交付的记录;它看不到全部提交,也不能读取其他组织的数据。计算比例之前,先在报告中写清范围和统计时段。
逐个活动使用一把对目标订阅有 Data 读取权限的完整组织 API Key,取得方法见为组织准备数据读取权限。在 bash 或 zsh 中运行下面的命令,在不回显的提示处输入 Key;它只传给明确指定的命令。Key 和标识符应属于下面地址对应的生产环境。Key 保存在组织批准的密钥存储中,导出记录保存在私有目录。
export HB_ENVIRONMENT='production'
export HB_API_URL='https://api.humanbased.ai'
unset HB_API_KEY
printf 'Data Key: '
read -rs HB_API_KEY
printf '\nCampaign ID: '
read -r HB_CAMPAIGN_ID
printf 'Subscription ID: '
read -r HB_SUBSCRIPTION_ID
HB_AUDIT_DIR="$(mktemp -d)"
printf 'Export directory: %s\n' "$HB_AUDIT_DIR"
hbd --version
HB_API_KEY="$HB_API_KEY" hbd auth whoami --json
HB_API_KEY="$HB_API_KEY" hbd campaign subscription list "$HB_CAMPAIGN_ID" --json
HB_API_KEY="$HB_API_KEY" hbd campaign records pull "$HB_CAMPAIGN_ID" --subscription "$HB_SUBSCRIPTION_ID" \
--limit 200 --all --json > "$HB_AUDIT_DIR/campaign-records.json"
printf 'Exit code: %s\n' "$?"导出全部交付记录说明了续读和文件保管方法。记录退出码;只有 data.complete=true,才能把文件视为该订阅当前可读范围的完整结果。每个相关活动和订阅都要分别读取,一份文件不代表整个组织。
如果这把 Key 还具有 campaign:read 权限,可以用同一个左闭右开的事件时间区间建立活动层面的基线:
HB_API_KEY="$HB_API_KEY" hbd campaign metrics "$HB_CAMPAIGN_ID" --from <start-iso> --to <end-iso> --json
HB_API_KEY="$HB_API_KEY" hbd campaign outcomes "$HB_CAMPAIGN_ID" --from <start-iso> --to <end-iso> --json分别保留两条命令的分母与时间口径。这些数字描述活动事件;交付记录导出描述一项订阅当前可读的行。两者不是同一批记录,不能直接相除当作通过率。
按行制作核查表,保存 campaign_id、subscription_id、submission_id、所查日期或字段,以及证据引用。对照约定的交付字段和客户反馈的记录 ID,检查必填值、日期窗口、重复的交易标识或标准化地址、交易所与网络标签。先标为待复核线索:相同地址可能对应获准的不同工作,评分或成功拉取也不能证明客户已经入库,更不能证明钱包的现实归属。
有目标活动权限的人,可以用已登录的 CLI 会话查看原始提交和审核结果;组织 API Key 也可获授 submission:read,但只能读取所属组织及活动白名单内的活动:
hbd campaign submissions list <campaign-id> --page 1 --limit 100 --json
hbd campaign submissions inspect <campaign-id> <submission-id> --json如果要使用已登录会话,运行前确认当前 shell 没有设置 HB_API_KEY;Key 则需带 submission:read。对受保护或封闭的活动,登录的人可在终端加 --reveal 查看隐藏的答案,Key 始终收到隐藏字段。按活动和贡献者抽查有线索、无线索的记录,再把交付 ID 与客户入库日志对账。记录审核人实际看过的证据、结论,以及尚待客户确定的口径,然后再给出质量结论。读取和写报告不会改变审核结果或奖励。生产环境尚未部署这项 Key 权限;开放前请使用登录会话。