概要:AppsFlyer MCP可将您的AppsFlyer数据与任意LLM(如Claude或VS Code)连接。您可在AI聊天中直接提出问题、获取投放洞察并采取行动。
什么是AppsFlyer MCP?
AppsFlyer MCP可帮助您将LLM安全连接到AppsFlyer平台,以便您可以通过简单的对话与营销数据进行交互。借助AppsFlyer MCP,您可以基于实时数据做出更快速、更明智的决策。
MCP可以帮助您:
- 获取即时的广告活动表现、趋势和KPI。
- 比较ROAS、激活量和LTV等指标。
- 审核OneLink模板、链接和受众连接并对其进行故障排除。
- 检索配置指南或产品文档。
设置AppsFlyer MCP
AppsFlyer MCP可连接到多种LLM客户端。目前支持的渠道包括:
- Claude (Anthropic):适用于Pro、Max、Team和Enterprise版本(网页端和桌面端)。
- Cursor IDE:支持。可按项目或全局添加MCP服务器。
- VS Code
- 其他平台:Windsurf、Cline CLI,以及支持自定义MCP URL的工具
- ChatGPT:即将上线
Claude (Anthropic)
支持Pro、Max、Team和Enterprise版本(网页和桌面端)。
以下步骤适用于网页端和桌面端Claude。
设置步骤
点击左下角的姓名 > 设置 或在新聊天中,点击搜索和工具> 管理连接器。
打开连接器标签页。
- 切换到组织连接器标签页。
- 在连接器部分中,单击添加连接器。
- Connector name:AppsFlyer
- Connector URL: https://mcp.appsflyer.com/auth/mcp
- 点击添加。
- 切换到您的连接器标签页。
- 在连接器部分中,单击AppsFlyer连接旁边的连接 。
- 按提示登录AppsFlyer。
测试步骤
- 在任意聊天窗口中,点击设置按钮。
- 如果AppsFlyer对接成功,菜单中会显示工具列表。
注意
Team和Enterprise版本中,只有Owner或Admin有权限添加添加组织对接。
Cursor IDE
要在本地开发环境中通过Cursor IDE访问AppsFlyer MCP服务器,请按以下步骤操作:
-
根据使用范围创建或打开配置文件:
-
全局配置:
~/.cursor/mcp.json -
项目配置:
.cursor/mcp.json
-
全局配置:
-
在JSON文件的
mcpServers字段下添加以下内容:{ "mcpServers": { "appsflyer": { "url": "https://mcp.appsflyer.com/auth/mcp" } } } -
重启Cursor IDE以应用新配置。
- 按提示登陆以获取MCP服务访问权限。
VS Code
按下
Cmd+Shift+P或Ctrl+Shift+P,打开Command Palette。选择Configure MCP Servers。
在
.vscode/mcp.json中添加以下内容:{ "appsFlyer": "https://mcp.appsflyer.com/auth/mcp" }保存文件并重启Copilot Chat。
其他平台
默认情况下,仅支持上述列出的LLM。如果您希望连接未在列表中的其他平台,请联系您的CSM,或发送邮件至hello@appsflyer.com。
使用AppsFlyer MCP
使用场景与示例提示
AppsFlyer MCP为您提供了一套工具和资源,旨在帮助您获取营销分析、效果洞察,并执行配置任务。
重要提示!
通过AppsFlyer MCP生成的答案,仅在以下支持的使用场景中是可靠的。超出这些范围的回答未经AppsFlyer验证,可能不准确或具有误导性。对于不在MCP对接预期范围内的AI生成结果,我们无法保证其准确性。
一些使用场景与示例提示包括:
表现分析
了解实时汇总营销绩效数据。您可以识别效果最佳和效果不佳的广告系列,进行对比、发掘趋势并并获取洞察,以帮助指导决策。
提示词:“上周Mypets.android.com在美国表现最佳的媒体渠道有哪些?”
预期的AI响应:返回表现最佳的媒体渠道,包括激活量、收入和ROAS。
提示词:“哪个广告活动的ROAS最高且总激活量不低于5000?”
预期的AI响应:识别并对符合条件的广告活动排序,提供效果洞察。
提示词:“昨天Mypets.android.com应用在中国的激活量是多少?”
预期的AI响应:返回该应用当天在中国的激活数量。
提示词:“请生成Mypets.android.com应用在过去一天的表现概览,按广告活动分组。”
预期的AI响应:返回按广告活动分组的效果报告。
提示词:“对比上周与前一周的D1留存,按媒体渠道分组。”
预期的AI响应:返回分媒体渠道的周同比D1留存对比结果。
OneLink管理
查询并审核OneLink模板和链接,确保路由一致性和用户路径准确性,帮助排查问题并验证批量链接配置。
提示词:“审核‘HolidayPush2025’模板,并展示所有带参数的链接。”
预期的AI响应:生成包含短链和参数值的CSV表格。
提示词:“为什么这个OneLink会将现有用户重定向到App Store?”
预期的AI响应:结合链接参数和返回逻辑,给出排查洞察。
提示词:“列出TravelBuddy应用所有支持二维码的OneLink。”
预期的AI响应:返回包含二维码链接和相关元数据的OneLink列表。
知识库和开发人员支持
快速访问AppsFlyer文档和DevHub资源。在AI聊天中直接获取SDK配置、产品行为和衡量逻辑的准确答案。
提示词:“如何在Android上配置应用内事件去重?”
预期的AI响应:提供配置步骤、代码示例和最佳实践。
提示词:“TikTok激活的归因回溯期是多少?”
预期的AI响应:基于最新平台归因规则给出说明。
提示词:“使用AppsFlyer优化应用ROAS的最佳方法是什么?”
预期的AI响应:提供策略方向,例如用户细分、合作渠道优化和LTV衡量最佳实践。
应用管理
快速获取应用的关键配置,例如归因回溯期、打开超时、再营销设置等。您可以跨应用审核和对比配置,确保一致性、提升管理效率,并识别因配置差异导致的衡量偏差。
提示词:“我的游戏应用的归因回溯期是多少?”
预期的AI响应:列出应用及其归因回溯期,并标注与标准值的差异。
提示词:“哪些应用设置了不同的回溯期?”
预期的AI响应:列出回溯期不一致的应用及其配置值。
提示词:“请列出我所有已置顶的活跃iOS应用。”
预期的AI响应:返回已置顶且活跃的iOS应用列表,包括应用ID和名称。
提示词:“AppsFlyer游戏应用当前的打开超时是多少?这会影响再营销归因吗?”
预期的AI响应:返回打开超时设置,并解释其对再营销归因的影响。
受众共享管理
即时了解受众结构、归属、合作渠道连接和活跃测试情况,简化跨职能广告活动管理。
提示词:“给我FinancePro应用的所有活跃受众。”
预期的AI响应:列出受众及其元数据,如创建日期、所有者和合作渠道。
提示词:“谁最后更新了‘Churned Users - Tier A’受众?”
预期的AI响应:返回最后修改的用户ID或邮箱及时间戳。
提示词:“列出当前与Meta和TikTok进行分测的所有受众。”
预期的AI响应:列出活跃受众及其测试配置和分配比例。
反馈工具
您可以通过助手界面直接提交关于AppsFlyer MCP的使用反馈,帮助我们改进产品。
提示词:“分析工具提供的洞察非常棒,对决策帮助很大。如果能增加应用内事件的衡量选项就更好了。”
预期的AI响应:AI会将该信息提交给AppsFlyer MCP产品团队。
用户管理和角色控制
通过检索完整的用户和角色信息,简化AppsFlyer账号管理,帮助管理员保持清晰的数据结构并高效维护访问控制。
提示词:“列出最近6个月未登录的非活跃用户。”
预期的AI响应:筛选列表,显示上次登录日期超过6个月或没有登录的用户,包括他们的电子邮件地址、角色和确切的上次登录时间戳,以帮助识别要停用的用户。
提示词:“按权限等级列出所有用户,并标注管理员用户。”
预期的AI响应:用户按角色类型分类(Admin、Team member、Viewer等),清晰标注管理员用户,并显示其可访问的应用和地域权限。
提示词:“有团队成员反映无法登录AppsFlyer,能否检查该用户是否存在以及状态如何?”
预期的AI响应:返回账号验证信息,包括用户是否存在、当前角色、关联应用、最后登录时间及可能的访问限制。
提示词:“哪些用户可以访问超过5个应用?他们的角色是什么?”
预期的AI响应:列出可访问应用数超过5的用户,显示其角色及完整的可访问应用列表,用于识别高权限用户或潜在的权限过度分配。
其他信息
安全与隐私
- 身份验证:需安全登录AppsFlyer。登录凭证不会暴露给AI工具。
- 访问控制:所有API访问均由您的AppsFlyer用户角色管理。
- 数据使用:数据经过加密、实时处理,且不会被存储。
- 隐私合规:AppsFlyer MCP遵循与AppsFlyer相同的合规标准。使用AppsFlyer MCP服务器需要用户主动选择加入,并且提供便捷的退出选项。
工具映射
默认情况下,所有工具均已启用。建议您保持启用状态,以确保功能完整,避免使用过程中出现问题。
每个工具都会映射到一个功能类别,例如表现分析、应用管理或OneLink管理。部分类别可能包含多个工具。
以下为有关工具及其类别映射的完整列表。
| 类别 | 工具 | 说明 |
|---|---|---|
| 表现分析 | fetch_aggregated_data | 获取汇总面板数据,可自定义日期范围、分组、指标和筛选条件 |
| get_today_date | 获取指定时区的当前日期,用于日期查询。 | |
| get_supported_metadata | 查看所有可用指标(如展示量、点击量、激活量、收入、ROAS等) | |
| get_supported_dimensions_ids | 查看所有可用的维度(例如,国家/地区、媒体渠道、广告系列等) | |
| 应用管理 | get_apps | 列出所有有权限的应用,并按已置顶/未置顶状态及转移请求分类 |
| get_app_settings | 获取所有应用的配置,包括归因窗口、隐私控制、打开管理和平台特定配置。 | |
| OneLink管理 | get_onelink_templates | 列出所有OneLink模板(基础路由配置)。 |
| get_onelink_template_links | 获取从特定模板生成的所有OneLink链接 | |
| get_onelink_details | 获取特定OneLink的完整配置详情。 | |
| 受众共享管理 | list_active_audiences | 列出所有每天计算的活跃受众。 |
| list_audiences_connections | 列出所有广告合作渠道的受众数据对接。 | |
| get_audience_connections | 获取特定受众的合作渠道对接信息。 | |
| 知识库和开发人员支持 | get_public_knowledge | 在AppsFlyer知识库和DevHub中搜索文档。 |
| 反馈工具 | send_feedback | 提交有关工具或系统的反馈。 |
| 用户管理和角色控制 |
特点与局限性
| 特点 | 说明 |
|---|---|
| 多账户使用 | AppsFlyer MCP仅使用默认账号的数据 |
| OneLink链接 |
|
| 频次限制 |
|
| 日期范围 |
|
| 分组限制 |
|
| 应用限制 |
|
| 支持的维度 |
|
常见问题解答
为什么我无法使用某项功能?
请检查您的权限。AI只能访问您在AppsFlyer角色权限范围内的数据。
AppsFlyer MCP安全吗?
安全。您需要使用AppsFlyer凭证登录,AI只能访问您有权限查看的数据。连接通过安全API进行,就像我们的面板或标准API一样。
Claude或其他工具会看到我的密码,或使用我的数据来训练模型吗?
不会。这些工具使用安全令牌获取数据,不会看到您的密码,也不会用您的数据训练模型。
AppsFlyer MCP服务器会存储我的数据或凭证吗?
AppsFlyer MCP作为安全代理, 只会实时获取数据并返回查询所需内容,不会进行归档或长期存储。
在我们公司,谁可以配置对接?
- Claude(Team/Enterprise版)必须由组织的Owner/Admin添加,之后任何用户都可以连接自己的账号。
- 其他IDE(例如Cursor):任何人都可以使用自己的API key进行设置。
是否有功能限制?
AI只能执行AppsFlyer MCP支持的操作。大多数功能仅支持读取(如获取分析数据)。出于安全原因,写入数据(如更新设置)可能会受到限制。大批量查询可能会被缩短,且AI仅能访问您的API权限范围内的数据。所有操作都会被记录。
如果AI给出了错误的答案怎么办?
这种情况很少见,但可能会发生。请重新检查查询和表达方式。您也可以要求AI提供引用或原始数据。同时请将问题反馈给我们,只需输入“请将我的反馈提供给AppsFlyer”,并联系AppsFlyer支持团队,附上查询详情。
我收到“authentication failed”“disconnected”或“no permission”等提示,该怎么办?
请重新登录。您的令牌可能已过期或被撤销(例如更改密码后)。请在LLM设置中删除并重新添加对接,然后再次登录。
AppsFlyer拥有哪些安全认证?
AppsFlyer已通过SOC 2 Type 2、ISO和CSA STAR认证。
我必须拥有AppsFlyer账号才能使用吗?
是的,您需要是AppsFlyer用户才能使用此工具。您可以在此注册AppsFlyer账号。
任何用户都可以随意使用AppsFlyer MCP吗?
并非如此。所有访问都受您现有的AppsFlyer用户角色控制。每一个操作都会通过与AppsFlyer API相同的审计日志进行记录。
AppsFlyer MCP无法使用(被禁用)
请输入“将我的反馈提供给AppsFlyer”,并联系AppsFlyer支持团队。
如果我登录,AI是否会访问我在AppsFlyer平台存储的所有数据?
不会。您选择的AI工具只能访问您的AppsFlyer用户角色有权限查看的数据。您的登录仅用于代表您发起API调用,凭证不会被共享。通过AppsFlyer MCP访问的数据不会被用于训练大语言模型(LLM,如Claude)。检索到的数据可能会临时与LLM共享以完成查询,但只包含生成回答所需的字段,且不会被保留用于训练。
请注意:该连接会将数据发送至您选择的AI工具,AppsFlyer无法控制该工具是否会存储或学习这些数据。我们建议您查看AI提供商的使用条款,以了解其数据使用政策。
Beta内测版是否对所有AppsFlyer用户开放?
目前,使用Beta内测版需申请登记。请填写此处表单,我们将在您获得访问权限后通知您。