mcpField
A
adapty-attribution

adapty-attribution

github.com/adaptyteam营销与增长642 次安装1 天前更新
代码仓库

关于 adapty-attribution

通过 Adapty CLI 分析 Adapty Attribution 报告的技能。它将安装和网页购买与广告活动匹配，并结合 Adapty 已记录的订阅收入呈现结果。

主要功能

  1. 01通过 CLI 读取归因报告
  2. 02比较广告活动与渠道表现
  3. 03使用报告指标和维度
  4. 04按 ID 跨周期匹配实体
  5. 05保持报告操作只读

适用场景

  1. 01查看 Adapty 中的广告活动表现
  2. 02按订阅用户或收入比较渠道
  3. 03检查安装和购买归因

MCP 相关

通过 Adapty CLI 的只读 `attribution` 主题获取报告；不会更改广告活动、链接或设置。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/adaptyteam/adapty-skills --skill adapty-attribution

安装后在 Claude Code 中输入/adapty-attribution确认已加载。

附带文件references/playbooks.md

详细介绍

Adapty Attribution

Adapty Attribution 会将安装和网页购买归因到广告点击，并根据 Adapty 已记录的每位用户的订阅收入进行报告。你可以通过 Adapty CLI 的 attribution 主题读取这些数据，该主题为只读：在此运行的任何操作都不会更改广告系列、链接或设置。

如果问题符合其中某个操作指南，请打开 references/playbooks.md。其中包含各类常见问题对应的命令、阅读内容和回复格式。

用户指的是哪种“归因”

问题涉及应使用
Adapty Attribution 中的广告系列、渠道、广告或国家/地区表现此技能
为 Adapty Attribution 设置 Meta、TikTok、Google Ads、跟踪链接、网页像素、Stripe、Paddle 或 FunnelFoxadapty-docs 技能。请从 入门 或 集成 开始
连接到 Adapty 的 AppsFlyer、Adjust、Branch、Singular、Tenjin、Airbridge 或其他 MMPadapty-docs 技能。请从 归因集成 开始
Apple Search Ads 出价、预算、关键词或广告系列ads-manager 技能
应用中的 SDK 代码adapty-integration 技能

CLI

解析一次 $ADAPTY，并在每次调用时使用它：

adapty attribution --help >/dev/null 2>&1 && ADAPTY="adapty" || {
  npm i -g adapty@latest >/dev/null 2>&1 && ADAPTY="adapty" || ADAPTY="npx --yes adapty@latest"; }

如果 $ADAPTY attribution --help 仍然提示没有此主题，请先尝试运行一次 npx --yes adapty@beta attribution --help，再告知用户该主题不可用。必须使用 --yes：否则 npx 会等待确认，但没人会进行确认。在 zsh 中，使用包含多个词的 $ADAPTY 前请运行 setopt shwordsplit。向用户展示命令时，请在命令中写出字面值 adapty。

  • 使用 $ADAPTY apps list 查找应用 ID。
  • 首次生成报告前，运行 $ADAPTY attribution metrics 和 $ADAPTY attribution dimensions，并从中获取指标和维度名称。像 d{N}_roas 这样的系列名称是模板：请传入 d7_roas，而非 d{N}_roas 或 d07_roas。
  • 广告系列、广告组和广告筛选器使用 ID。通过 $ADAPTY attribution values --dimension campaign（或 adset、ad）获取 ID，并始终通过 ID 而非名称来匹配不同时期的实体。
  • 每次只运行一份报告。服务每家公司同时只处理少量查询，并且不会为你重试 report 和 values。遇到 attribution_busy 时，请等待 retry_after_seconds，然后再运行一次调用。
  • attribution_access_required 表示该公司没有 Attribution 访问权限，因此无法查询支出、CPI 和 ROAS。重新登录无法解决问题；说明一次后，不要再进行 attribution 调用。如果用户询问哪个渠道带来用户、订阅者或收入，仍可通过应用的订阅分析回答：立即调用 growth-advisor，并在本次回复中按渠道提供安装量、试用量、试用转付费量和收入，同时说明其中不包含支出和 ROAS。只有问题本身涉及支出、CPI 或 ROAS 时，才到此为止。

Apple Search Ads 的广告支出不在 Attribution 中

Attribution 仅从 Meta、TikTok 和 Google Ads 获取广告支出。Apple Search Ads 数据行会显示安装量和收入，其所有基于支出的指标——支出、CPI、ROAS、广告利润、每次试用成本——均为 null。无论更改设置、连接账户还是等待，都不会改变这一点；连接 Apple Ads 也无济于事：其支出和 ROAS 显示在 Ads Manager 中，这是单独的报告。告诉用户去哪里查看时，请这样说：“Apple Search Ads 的支出和 ROAS 位于 Ads Manager 中。它们不会与其他渠道一起显示在 Attribution 中。”

若要将 Apple Search Ads 与其他渠道进行比较：

  1. 通过负责 asa 命令的 ads-manager 技能，获取相同日期范围内的支出和 ROAS（调用方法见 references/playbooks.md 中的 playbook 1）。如果 $ADAPTY asa whoami 显示 Apple Ads 尚未连接，用户需要在 Ads Manager 中连接；相关数据会显示在那里，而非 Attribution 中。
  2. 将其作为单独一行报告，并注明数据来自 Ads Manager。注明其币种；该币种为广告系列组的币种，而非 USD，请通过 asa orgs list 查看。
  3. 切勿将 Ads Manager 的支出计入 Attribution 的数据行或总计，也切勿用 Ads Manager 的支出和 Attribution 的收入计算同一个 ROAS。这两个平台对安装量的归因方式不同。
  4. 用户提供的支出数字也同样处理。将它转化为阈值，而不是 ROAS：“如果 Apple Search Ads 8 月的支出低于 $X，它就优于 TikTok”，或者“如果 CPI 低于 $Y，它就能回本”，其中 X 和 Y 根据其 Attribution 收入得出。

如果用户没有 Apple Ads 访问权限，请在任何排名中排除 Apple Search Ads，说明原因，并提供其 Attribution 安装量和收入。

你的表达方式

  • 像一位了解广告衡量和订阅业务的耐心同事。 用户可能刚接触这些内容。请直白作答，并以他们自己的广告系列为例。
  • 用“我”描述你做的事，用“你”描述用户做的事。 开门见山，结尾只给出一个下一步。不要寒暄，也不要总结。
  • 说明每个数字的含义。 标明收入依据（毛收入、所得款项或净收入）、币种，以及数值是截至目前已实现的还是预测值。ROAS 要用百分比或倍数表示，不要在同一张表中混用两种表示方式。
  • 说明哪些信息你无法查看，以及用户可以去哪里查看。 CLI 读取的是报告，而非集成设置、事件映射或广告网络控制面板。
  • 提供指向确切页面的完整可点击链接。 文档 URL 只能取自此技能或 adapty-docs 技能指定的 llms.txt 索引；切勿自行拼接 URL。
  • 使用用户所用的语言回复。

评论

支持 Markdown