[封闭测试]AppsFlyer MCP

概要:AppsFlyer MCP可将您的AppsFlyer数据与任意LLM(如Claude或VS Code)连接。您可在AI聊天中直接提出问题、获取投放洞察并采取行动。

beta feature.png

什么是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。

设置步骤

  1. 点击左下角的姓名 > 设置 或在新聊天中,点击搜索和工具> 管理连接器

  2. 打开连接器标签页。

  3. 切换到组织连接器标签页。
  4. 在连接器部分中,单击添加连接器。
    1. Connector name:AppsFlyer
    2. Connector URL:   https://mcp.appsflyer.com/auth/mcp  
  5. 点击添加
  6. 切换到您的连接器标签页。
  7. 在连接器部分中,单击AppsFlyer连接旁边的连接
  8. 按提示登录AppsFlyer。

测试步骤

  1. 在任意聊天窗口中,点击设置按钮。
  2. 如果AppsFlyer对接成功,菜单中会显示工具列表。

注意

Team和Enterprise版本中,只有Owner或Admin有权限添加添加组织对接。

Cursor IDE

要在本地开发环境中通过Cursor IDE访问AppsFlyer MCP服务器,请按以下步骤操作:

  1. 根据使用范围创建或打开配置文件
    • 全局配置: ~/.cursor/mcp.json
    • 项目配置: .cursor/mcp.json
  2. 在JSON文件的mcpServers字段下添加以下内容

    {
      "mcpServers": {
        "appsflyer": {
          "url": "https://mcp.appsflyer.com/auth/mcp"
        }
      }
    }
            
  3. 重启Cursor IDE以应用新配置。
     
  4. 按提示登陆以获取MCP服务访问权限。

VS Code

  1. 按下Cmd+Shift+PCtrl+Shift+P,打开Command Palette。

  2. 选择Configure MCP Servers

  3. .vscode/mcp.json中添加以下内容:{ "appsFlyer": "https://mcp.appsflyer.com/auth/mcp" }

  4. 保存文件并重启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链接
  • 仅包括通过OneLink管理页面创建的链接(不包括API/SDK/批量创建的链接)
  • 不返回单平台链接(旧版链接)。
频次限制
  • Analytics:
    • 20次/分钟
  • Audiances:
    • 350次/分钟
日期范围
  • Analytics:
    • 3年
分组限制
  • Analytics:
    • 每次请求最多4个分组
应用限制
  • Analytics:
    • 每次请求最多10个应用
支持的维度
  • Analytics:
    • country、media_source、app_id、campaign_id、campaign、adgroup、adgroup_id、adset、adset_id、attributed_touch_type、attribution_entity、attribution_type、channel、date、engagement_type、event_name、install_store、keywords、partner、site_id、source、store_product_page

 

常见问题解答

为什么我无法使用某项功能?

请检查您的权限。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内测版需申请登记。请填写此处表单,我们将在您获得访问权限后通知您。