连接 Qualtrics
导入 Qualtrics 问卷回答，让人群根据你们自己的数据作答。品牌管理员只需创建一次只读 OAuth 客户端，几分钟就能完成，访问权限也始终留在你们品牌内部。
Qualtrics 里存着客户已经给过你的回答。把这些回答导进来，人群就能根据你自己的问卷数据作答，而不是靠猜。
Qualtrics 的 OAuth 客户端只在单个品牌内有效，所以没有现成的 iMario 公共应用可以直接授权。需要你们 Qualtrics 的管理员自己建一个客户端，iMario 用它读取数据，而且只读你选中的问卷。创建不收费，几分钟就能完成，访问权限也始终留在你们品牌内部。
管理员一次性配置
-
在 Qualtrics 里打开账号菜单 → Account Settings → OAuth Client Manager。
-
点击 Create Client，起一个同事一看就认得出的名字，比如“iMario”。
-
Grant Type 选择 Authorization Code。
-
在 Redirect URI（回调地址）里原样粘贴下面这个地址：
https://api.imario.ai/api/connections/callback -
Scopes 只勾选下面这两项，其他一概不勾：
权限范围 iMario 能读取的内容 read:surveys你的问卷和问卷里的题目，这样每条回答都能对上它所属的题目 read:survey_responses回答本身，导入后就成了人群的回答 -
保存，然后复制 Client ID 和 Client Secret。Secret 只显示一次。
这两项都是只读权限范围，这个客户端改不了、也删不了 Qualtrics 里的任何内容。
查找数据中心 ID
iMario 还需要你的数据中心 ID，因为每个 Qualtrics 品牌都部署在各自的主机上。数据中心 ID 就是 Qualtrics 网址的第一段，比如 iad1.qualtrics.com 的数据中心 ID 是 iad1。也可以在 Account Settings → Qualtrics IDs 里查看。
在 iMario 里连接
- 在 Create audience 里点击 Connect a data system，选择 Qualtrics。
- 粘贴第 6 步复制的 Client ID 和 Client Secret，再填上你的 Qualtrics datacenter ID（Qualtrics 数据中心 ID）。
- 点击 Connect to Qualtrics，在 Qualtrics 自己的页面上确认授权。
- 页面会列出你的问卷，最近修改过的排在最前。Qualtrics 的列表里不提供回答数量，所以 iMario 会直接说明这一点，而不是先显示一个导入后又对不上的数字。真实数量要等导入时才能拿到。勾选要用的问卷。
- 点击 Import。
iMario 读取的内容
只读你勾选的问卷，而且只读题目和回答。每份答卷保留各题的作答；如果问卷是发给邮件列表的，还会保留受访者的邮箱地址。这个地址只用作关联字段，绝不会当成回答，有了它，答卷才能落到人群里对应的那个人身上。匿名链接收回的答卷没有邮箱地址，但照样计入人群的回答。
时间戳、IP 地址和 Qualtrics 自己的内部字段，在导入时就会丢弃。
问题排查
Qualtrics 页面提示回调地址不匹配。回调地址是逐个字符比对的。检查末尾是不是多了斜杠，再确认填的是上面那个地址，而不是某个测试环境（staging）的地址。
连接后提示“Insufficient scope”（权限范围不足）。创建客户端时漏勾了两项权限范围中的一项，或者选了别的授权类型。到 OAuth Client Manager 里改好，再重新连接：令牌只带有你授权那一刻已有的权限范围。
列出的问卷没有任何回答。还没人作答的问卷，没有内容可以导入。
导入后要等一会儿才出现内容。Qualtrics 没有直接返回回答的接口，它会先生成一个导出文件，iMario 要等这个文件生成好。问卷很大时，可能要等上一分钟。