📘
接入前需要准备哪些资料？
通常需要提供产品的基本信息、当前使用的数据采集方式，以及希望重点观察的指标清单。如果已有历史报表，一并提供能帮助我们更快对齐口径，减少前期沟通轮次。资料越完整，方案给出的速度越快，后续联调时出现的口径偏差也越少，建议在正式对接前先由产品与数据两侧各指定一名联系人统一整理。
使用说明 - 米兰(AC·中文)官方网站
本栏目是米兰(AC·中文)官方网站为合作客户整理的使用说明专区，集中解答从接入准备到日常运营中会遇到的实际问题。米兰中国官网的使用说明覆盖接入前的资料准备、接口对接周期、数据看板的自定义配置、异常数据的排查思路、多人协作的权限管理，以及历史数据的迁移方式等核心环节。无论你是第一次接触这套系统，还是已经在使用中遇到具体疑问，都可以在这里找到对应的操作口径与判断方法。我们把客户问得最多、也最容易产生误解的地方逐条写清楚，帮助你减少沟通轮次，让项目更快跑通，也让后续的日常使用更顺畅、更规范。
常见问题与操作说明
⏱️
对接周期一般要多久？
标准接口接入通常在两个工作日内给出方案，联调视产品侧排期而定，多数项目能在一到两周内跑通。私有化部署因为涉及环境准备，时间会相应长一些。影响周期的关键因素主要是数据源是否稳定、字段口径是否明确，以及双方联调窗口能否对齐，提前把这些确认清楚可以明显缩短整体时间。
📊
数据看板可以自己配置吗？
可以。常用指标已内置模板，直接选用即可，也可以按自己的口径新建指标与图表。配置项支持保存为方案，后续版本切换时直接套用，不用每次重做。对于同一指标存在多种统计口径的情况，建议在命名时标注清楚适用范围，避免团队成员在看板上读到不同含义的数据而产生误判。
🔍
出现数据异常怎么排查？
先在采集日志里确认事件是否正常上报，再检查指标口径是否被改动过。若两边都正常，可以联系对接人拉取明细数据比对，多数问题能在当天定位到原因。排查时建议按时间顺序记录每一步的观察结果，这样即使问题当天没能解决，交接给其他同事时也能快速复现，不必从头再来一遍。
👥
支持多人协作查看吗？
支持。可以按项目组分配账号并设置不同的查看与编辑范围，运营、研发、发行各看各的部分，避免权限交叉。人员变动时由管理员统一调整即可。建议在项目初期就把角色划分固定下来，明确谁负责配置、谁只负责查看，这样后续新增成员时按既有角色直接分配，不用每次重新讨论权限边界。
📦
历史数据能迁移过来吗？
能。提供按标准格式整理的历史数据即可导入，导入后与后续新增数据在同一套口径下展示。如果历史数据的字段结构差异较大，我们会先给出映射建议再执行。迁移前建议先做一次小批量试导，确认字段对应关系和统计结果都符合预期，再执行全量导入，避免返工。
关于使用说明，你该关注什么
这一块具体包含什么
使用说明栏目并不是一份简单的功能清单，而是围绕客户从接入到日常运营的完整路径展开。它包含三类内容：一是流程类说明，比如接入前需要准备哪些资料、对接周期如何估算；二是操作类说明，比如看板如何配置、协作账号如何分配；三是排查类说明，比如数据异常时的定位顺序和比对方法。三类内容分别对应客户在不同阶段会遇到的问题，建议按自己的当前进度选择阅读，不必从头看到尾。
客户通常会关心哪几个点
从实际沟通来看，客户最集中的关注点有三个。第一是时间成本，也就是从确认合作到真正跑通需要多久，这直接影响项目的排期安排；第二是数据口径，客户会反复确认看板上的数字和自己内部报表是否一致，口径不一致往往比功能缺失更让人困扰；第三是权限边界，尤其是涉及多团队协作时，谁能看、谁能改必须提前说清楚。这三点在使用说明里都有对应的条目，阅读时可以先看这三块。
判断说明是否讲清楚的标准
一份合格的使用说明，标准其实很简单：读完能不能直接照着做。具体来说，它应该给出明确的动作顺序，而不是只描述状态；应该说明在什么情况下适用、什么情况下不适用，而不是一概而论；应该在可能出现分歧的地方给出判断依据，比如口径不一致时以哪一方为准。如果一段说明读完仍然不知道下一步该做什么，那它就没有真正起到说明的作用，这也是我们在整理本栏目时反复对照的标准。
第一次接触容易忽略的地方
初次接触这套系统的客户，最容易忽略的是资料准备的完整度。很多人以为只要提供产品名称和大致需求就可以开始，实际上数据采集方式和指标清单才是决定对接速度的关键，缺了这两项，方案阶段就会反复来回。另一个容易被忽略的点是历史数据的字段结构，如果没有提前整理，导入时才发现字段对不上，会额外增加不少工作量。建议在正式对接前先把这两件事做好，后续会顺畅很多。