在 5 分钟内完成第一次决策调用
EPVANTA 将分散的媒体信号转化为可执行的决策。按照以下步骤接入一个测试事件，在 Sandbox 中运行归因，并获取决策结果。
- 时间
- 5 分钟
- 环境
- Sandbox
- 最后更新
- 2026-07-17
- 1
- 2
发送测试事件
向 /v1/events 发送一个事件。右侧的 Live Runner 已预置示例请求。
- 3
运行归因
事件被处理后，调用 /v1/attribution/runs 触发一次归因运行，可选配置决策策略。
- 4
获取决策结果
通过 /v1/decisions/{decision_id} 获取可执行的决策建议，或订阅 Webhook 接收异步结果。
从测试事件到生产链路
EPVANTA 使用一套稳定的数据契约连接事件、归因、决策与交付。每个阶段都保留版本、权限和可观测状态。
从 Sandbox 到生产环境，边界始终清晰。
环境、凭证、权限和区域路由彼此隔离。上线前可以完整验证真实流程，又不会影响生产数据。
Sandbox 项目
使用测试凭证和 7 天数据保留完成端到端集成。
即时创建 · 无生产数据Scoped credentials
按项目、环境与具体操作分配最小权限。
Signed delivery
所有服务器提交与回调都支持签名验证。
Region routing
依据组织策略将数据固定在指定处理区域。
Audit trail
凭证、策略、Schema 与发布变化都保留审计记录。
事件与信号
事件是平台的最小输入单位。每个事件必须携带稳定身份、事件时间、来源与幂等键，才能进入可追踪的归因链路。
stringrequired业务事件名称
timestamprequired事件发生时间
stringrequired稳定的业务身份键
objectoptional渠道与业务上下文
归因模型
使用显式窗口、身份规则、区域与治理参数运行归因模型，支持实时或批量任务。
/v1/attribution/runs{ "workspace_id": "growth-cn", "model": "multi_touch", "date_range": "2026-07-01/2026-07-17", "identity": { "primary_key": "customer_id" }, "governance": { "data_region": "apac" }}决策策略
读取带置信度、依据、约束与审批状态的决策建议，并保留完整的可追踪上下文。
将高意向受众权重提高 14%
证据：增量贡献、渠道饱和度、转化质量与预算保护规则。
status: approval_required身份与去重
使用业务主键作为首选身份，并为设备或会话标识定义明确的回退顺序。幂等键负责保护网络重试，身份键负责稳定归因上下文。
customer_ididfa / gps_adidsession_iddeduplicated_event事件接入
提交渠道、花费、转化与收入事件，并在进入归因链路前完成 Schema 与身份校验。
实时事件与低延迟写入
POST /v1/events历史回填与大批量导入
POST /v1/events/batch标准化数仓增量同步
Scheduled connector归因运行
归因运行是隔离的异步任务。使用 run_id 查询进度、差异与治理检查，不需要在客户端维持长连接。
- 1
queued12 ms - 2
validating48 ms - 3
processing420 ms - 4
decision_ready8 ms
决策接口
读取决策时会同时返回建议动作、置信度、约束、审批状态和证据引用，确保下游系统不需要拼接上下文。
/v1/decisions/{decision_id}decisions:read/v1/decisions/{decision_id}/approvedecisions:approve/v1/decisions/{decision_id}/rejectdecisions:approve每一次投递都有状态、重试与恢复路径。
查看签名结果、响应码与下一次重试时间。失败事件可以安全重放，并沿用原始幂等键。
decision.readywh_01J8… · 2026-07-17 10:21:03 UTCDelivered · 204
x-epvanta-signature: t=1784283702,v1=9af21c…action.approval_requiredwh_01J9… · 2026-07-17 10:23:18 UTCDelivered · 200
x-epvanta-signature: t=1784283702,v1=9af21c…export.completedwh_01JA… · 2026-07-17 10:27:42 UTCRetrying · 503
x-epvanta-signature: t=1784283702,v1=9af21c…部署与区域
按照企业实施顺序完成审计、接入、回填、验证、发布与治理扩展，每一步都保留明确的验收条件。
- 01
审计现有模型
盘点事件 Schema、身份键、时间戳、花费来源与报表依赖。
- 02
连接接入面
把 SDK、API、Webhook、数仓与广告平台映射为稳定契约。
- 03
准备历史回填
标准化旧系统导出，并把历史数据与实时流量逻辑隔离。
- 04
并行验证
运行测试流量，对比归因窗口、回调、原始导出与看板输出。
- 05
分阶段发布
使用环境凭证、灰度发布与回滚检查点安全切换生产流量。
- 06
扩展治理
补齐预算控制、财务模型、审计记录和区域化隐私配置。
Rate limits
速率限制按工作区、环境和 Endpoint 单独计算。所有响应都会返回剩余额度与重置时间。
3,000 req / minBurst 500 / sec120 req / min20 concurrent6,000 req / minRegional cache错误码
invalid_request请求体或参数无效
authentication_error凭证缺失、过期或作用域错误
idempotency_conflict幂等键与已有请求不一致
rate_limit_exceeded请求超过工作区速率限制
监控与日志
使用 trace_id 关联事件接入、归因运行、决策和 Webhook 投递。原始日志可导出到现有可观测平台。
event.receivedschema.validatedattribution.queueddecision.readywebhook.delivered使用与你的工程工作流匹配的工具。
从快速验证到持续运维，所有入口共享相同的 API 契约、版本策略和示例数据。
TypeScript、Python、Go 与 Java 官方客户端。
npm · PyPI · Maven · Go modules下载版本化 Schema，生成客户端或接入内部网关。
OpenAPI 3.1 · JSON / YAML导入预设环境、变量和完整的关键调用路径。
Sandbox ready管理项目、密钥、事件回放和发布前检查。
epvanta 1.3.0事件接入、Webhook 验签、数仓同步与审批集成示例。
Reference implementations跟踪新能力、兼容性变化、弃用窗口和迁移说明。
Versioned · RSS上线前，把这些工程边界变成默认设置。
使用幂等键保护重试
对所有写入请求设置稳定的 idempotency_key，避免网络重试造成重复事件。
先验证签名，再处理回调
使用原始请求体校验时间戳与签名，并限制可接受的时间偏差。
分离历史回填与实时流量
为回填任务使用独立运行标识，避免迁移数据影响上线后的实时分析。
把错误响应纳入观测
记录 request_id、错误码、重试次数和速率限制头，建立可定位的故障链路。
接入前常见问题。
可以。事件接入、归因运行、决策读取和执行交付是独立权限面。团队可以先完成数据接入与并行验证，再逐步启用审批和执行能力。
是。两个环境使用独立项目、凭证、存储和 Webhook Endpoint。Sandbox 数据默认保留 7 天，不会进入生产归因或报表。
平台使用指数退避自动重试，并保留 72 小时投递记录。开发者可以在控制台或通过 API 使用原始幂等键安全重放失败事件。
破坏性变更只会进入新的主版本。每次弃用都会提供明确窗口、迁移指南与并行验证期，现有版本在公告窗口内持续可用。
用一个 Sandbox 项目验证完整决策链路。
带上你的事件 Schema、身份规则和回调需求。我们会帮助你的团队完成第一条可验证的集成路径。