AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文以开源仓库 marketing skills 中的 Adobe Analytics 集成文档 为骨架完整讲解 AI Agent 如何通过 Reporting API 2.0 拉取企业级跨渠道分析数据、通过 Data Insertion API 完成服务端埋点、并通过 AppMeasurement.js 实现客户端采集。读完本文你将掌握 Adobe Analytics 的认证流程、核心数据模型Report Suite / eVars / props / Events、常用维度与指标以及如何在 adobe-analytics.js 零依赖 CLI 的辅助下让 Agent 直接执行报表查询、维度列举与分段筛选等自动化操作。一、Adobe Analytics 在 Marketing Skills 中的定位Adobe Analytics 是 Adobe Experience Cloud 的核心组件面向企业级跨渠道测量与归因。在 marketing skills 仓库中它被收录在 工具注册表 的Analytics分类下与 GA4、Mixpanel、Amplitude、PostHog、Segment、Plausible 并列定位为「企业级分析Enterprise analytics」。注册表对工具接入方式的标注如下来自 REGISTRY.md集成方式可用性说明API✓Reporting API 2.0、Data Insertion APIMCP-无原生 MCP ServerCLI-无官方 CLI但仓库提供了零依赖包装脚本 adobe-analytics.jsSDK✓AppMeasurement.js、Mobile SDKs、Launch标签管理值得注意的细节官方集成文档的「CLI」列标注为不可用是指 Adobe 不提供现成的命令行工具而本仓库在 tools/clis/ 中为它实现了一个单文件 Node.js CLI仅依赖 Node 18 原生fetch让 Agent 可以直接在终端中操作 Adobe Analytics无需安装任何第三方依赖。这是仓库对该集成的关键补充能力。二、认证方式OAuth 2.0Service Account JWTAdobe Analytics 的 API 认证采用OAuth 2.0 的 Service Account JWT 流程即服务器到服务器server-to-server模式不需要用户交互授权。认证要点类型OAuth 2.0Service Account JWT配置入口在 Adobe Developer Console 中创建集成Integration请求头Authorization: Bearer {access_token}同时必须携带x-api-key: {client_id}2.1 三步完成准备工作登录 Adobe Developer Console创建一个新项目并添加Adobe Analytics API服务使用 Service AccountJWT方式生成密钥对获取client_idAPI Key与client_secret通过 JWT 交换获得access_token与company_id组织 ID后续所有请求都以这三个值作为凭证。2.2 三个关键环境变量仓库的 CLI 实现 adobe-analytics.js 明确了运行所需的三个环境变量缺少任何一个都会直接报错退出环境变量含义ADOBE_ACCESS_TOKENOAuth 2.0 访问令牌Bearer TokenADOBE_CLIENT_IDAdobe Developer Console 中的 API Key即x-api-key请求头ADOBE_COMPANY_ID公司 ID用于拼接 API 基础路径https://analytics.adobe.io/api/{company_id}CLI 的请求封装函数adobe-analytics.js在每次调用时都会同时注入三个请求头Authorization: Bearer {access_token} x-api-key: {client_id} x-proxy-global-company-id: {company_id}其中x-proxy-global-company-id是 Adobe Analytics API 的全局公司级请求头用于在多组织场景下指明目标公司这是很多初次接入者容易遗漏的字段。三、常用 Agent 操作Reporting API 2.0Reporting API 2.0 是所有查询类操作的入口基础路径为https://analytics.adobe.io/api/{company_id}。以下操作均来自 集成文档 的「Common Agent Operations」章节并给出了仓库 CLI 的对应命令。3.1 获取报告套件信息Report SuitesGET https://analytics.adobe.io/api/{company_id}/reportsuites Authorization: Bearer {access_token} x-api-key: {client_id}对应 CLI 命令node tools/clis/adobe-analytics.js reportsuites list3.2 获取维度列表GET https://analytics.adobe.io/api/{company_id}/dimensions?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}rsid是报告套件 IDReport Suite ID用于限定查询范围。CLI 强制要求该参数adobe-analytics.jsnode tools/clis/adobe-analytics.js dimensions list --rsid {report_suite_id}3.3 获取指标列表GET https://analytics.adobe.io/api/{company_id}/metrics?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}CLI 同样要求--rsid参数node tools/clis/adobe-analytics.js metrics list --rsid {report_suite_id}3.4 获取分段列表SegmentsGET https://analytics.adobe.io/api/{company_id}/segments?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}分段在 CLI 中是可选的--rsid参数adobe-analytics.js不传则返回全公司分段node tools/clis/adobe-analytics.js segments list [--rsid {report_suite_id}]四、运行报表POST /reports 深入拆解运行报表是 Agent 最核心的操作通过POST /reports提交 JSON 请求体完成。原文档给出了一个完整示例这里逐字段拆解其含义POST https://analytics.adobe.io/api/{company_id}/reports { rsid: {report_suite_id}, globalFilters: [{ type: dateRange, dateRange: 2024-01-01T00:00:00/2024-01-31T23:59:59 }], metricContainer: { metrics: [ {id: metrics/visits}, {id: metrics/pageviews}, {id: metrics/orders} ] }, dimension: variables/evar1 }字段类型作用rsidstring报告套件 ID确定数据源globalFiltersarray全局过滤器最常见的type: dateRange用于限定时间范围格式为开始时间/结束时间ISO 8601metricContainer.metricsarray要返回的指标集合使用metrics/xxx形式的 IDdimensionstring报表的维度行维度使用variables/xxx形式的 ID4.1 与 CLIreports run的映射仓库 CLI 将上述请求体封装为易用的参数化命令adobe-analytics.jsnode tools/clis/adobe-analytics.js reports run \ --rsid {report_suite_id} \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/evar1从源码可以看出参数与请求体的对应关系--start-date/--end-date拼装为{start}T00:00:00/{end}T23:59:59的 dateRange 全局过滤器--metrics逗号分隔的指标 ID 列表内部按,拆分并trim后映射为{ id }对象数组--dimension可选参数传入后才会写入请求体的dimension字段--rsid必填缺失时报错退出。四个必需参数--rsid、--start-date、--end-date、--metrics缺一不可这是 CLI 对报表请求完整性的硬性校验。4.2 实战示例按营销渠道统计假设要分析 2024 年 1 月各营销渠道Marketing Channel的访问、页面浏览与订单node tools/clis/adobe-analytics.js reports run \ --rsid mycompany-global \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/marketingchannel五、Data Insertion API服务端数据接入当事件无法通过浏览器端的 JavaScript 采集时如服务器端支付回调、后端业务事件、数据迁移、无头浏览器环境使用Data Insertion API直接向 Adobe 的数据收集端点提交数据。POST https://{tracking_server}/b/ss/{report_suite_id}/0 ?xml version1.0 encodingUTF-8? request visitorIDuser_123/visitorID eventsevent1/events eVar1campaign_name/eVar1 prop1page_type/prop1 /request请求要点端点格式https://{tracking_server}/b/ss/{report_suite_id}/0其中{tracking_server}是您配置的跟踪服务器域名如metrics.example.com末尾的/0表示纯数据插入端点XML 结构以request为根节点字段与 AppMeasurement.js 中的变量一一对应核心字段visitorID访客标识、events成功事件、eVar1转化变量、prop1流量变量。Data Insertion 与客户端采集的区别在于它绕过了浏览器与 AppMeasurement.js由后端服务直接完成数据投递因此特别适合服务端归因、订单回传、离线事件补齐等场景。这也是集成文档将其列为与 Reporting API 并列的两大 API 能力之一的原因。六、AppMeasurement.js 客户端采集对于浏览器端页面使用 AppMeasurement.js 完成采集。原文档给出了最小可用的初始化与打点示例// Initialize var s s_gi(report_suite_id); s.trackingServer metrics.example.com; // Set variables s.pageName Home Page; s.channel Marketing; s.eVar1 campaign_name; s.events event1; // Track page view s.t(); // Track link s.tl(this, o, Button Click);6.1 关键 API 说明API / 属性作用s_gi(report_suite_id)实例化 AppMeasurement 对象参数为报告套件 IDs.trackingServer设置跟踪服务器域名与 Data Insertion 的{tracking_server}保持一致s.pageName页面名映射到维度variables/pages.channel站点渠道分类如 Marketing / Sales / Supports.eVar1自定义转化变量持久化跨页面保留s.events成功事件列表多个事件用逗号分隔如event1,event2s.t()发送页面浏览page view信标s.tl(this, o, Button Click)发送自定义链接跟踪信标第二参数o表示其他other链接类型第三参数为链接名6.2 与 analytics Skill 事件规范的映射在仓库的 analytics Skill 中事件命名遵循「对象-动作」规范如signup_completed、button_clicked、form_submitted而 Adobe Analytics 的事件体系使用数字型event1、event2及 eVar/prop 分类。接入时建议在 事件库参考 中先定义好业务事件清单如营销站点的cta_clicked、form_submitted、signup_completed将每个业务事件映射到一个 Adobeevent编号并建立映射文档使用 eVar 存放归因型属性如campaign_name、source、medium使用 prop 存放 hit 级别的即时属性如page_type。七、核心数据模型六大概念概念说明关键特性Report Suite报告套件数据的容器定义了数据的收集范围与配置所有报表查询都通过rsid指向某个套件eVars转化变量用于归因分析的自定义变量持久化persistent跨页面/会话保留适合承载营销活动、渠道来源等归因信息props流量变量用于流量分析的即时变量hit 级hit-level仅当前数据包有效适合页面类型等即时属性Events事件成功指标成功事件如订单、注册、下载数值型event1、event2… 可定义计数或数值类型Segments分段用户/访问级过滤器在报表中按条件圈定目标人群可复用、可共享Calculated Metrics计算指标由基础指标派生出的衍生指标如转化率 订单 / 访问支持公式与运算符记忆要点eVars 回答「谁带来的」归因props 回答「当时发生了什么」即时上下文Events 回答「完成了什么」转化结果Segments 负责「圈出哪群人」Calculated Metrics 负责「把指标算成比率」。八、常用维度与指标速查8.1 常用维度Dimensions维度 ID含义variables/page页面名称对应s.pageNamevariables/evar1自定义转化变量第 1 个variables/prop1自定义流量变量第 1 个variables/marketingchannel营销渠道由渠道处理规则自动归类variables/referringdomain引荐域名来源网站8.2 常用指标Metrics指标 ID含义metrics/visits访问次数metrics/pageviews页面浏览数metrics/uniquevisitors唯一访客数metrics/orders订单数metrics/revenue营收九、限流与合规提示限流Rate Limits——集成文档明确标注了如下阈值12 请求/秒/公司12 requests/second per company120 请求/分钟120 requests/minute这意味着 Agent 在批量拉取多个报表或并发执行多个维度/指标查询时需要自行控制请求节奏避免触发 429 限流。建议在自动化脚本中引入简单的速率控制如排队 间隔。合规提示——参照 analytics Skill 的隐私与合规章节遵守 EU/UK/CA 的 Cookie 同意要求不在 eVar/prop/事件属性中写入 PII个人身份信息配置合理的数据保留期与用户删除能力仅采集业务决策所需的最小数据集。十、何时选择 Adobe Analytics根据集成文档的「When to Use」清单以下场景适合将 Adobe Analytics 作为测量主平台企业级分析海量数据、多站点、多品牌场景下的规模化测量跨渠道归因将搜索、付费广告、邮件、社交等渠道的贡献统一归因Adobe Experience Cloud 生态集成与 Audience Manager、Target、Experience Platform 等协同高级分段基于访客、访问、事件的多层复杂分段分析数据仓库导出将分析数据导出到企业数据仓库做深加工。如果团队主要依赖 Google 生态GA4 集成文档 是更轻量的替代方案而当团队已经身处 Adobe 企业生态、需要跨渠道归因与数仓导出时Adobe Analytics 更为合适。两者在营销技能仓库中都属于 analytics Skill 的落地工具。十一、与相关 Skill 的联动集成文档末尾标注了三个关联技能Skill联动场景analytics设置跟踪方案、定义事件命名、落地埋点实现与数据质量校验ab-testing使用 Adobe Analytics 数据评估 A/B 实验的访问、转化与显著性ads结合广告投放数据做跨渠道效果分析与归因十二、端到端实战用仓库 CLI 快速接入仓库为 Adobe Analytics 提供了开箱即用的零依赖 CLI完整安装与使用说明见 tools/clis/README.md。12.1 安装方式三选一# 方式一直接运行 node tools/clis/adobe-analytics.js reportsuites list # 方式二符号链接到全局 bin便于直接使用命令名 ln -sf $(pwd)/tools/clis/adobe-analytics.js ~/.local/bin/adobe-analytics # 方式三将整个 tools/clis 目录加入 PATH export PATH$PATH:/path/to/marketingskills/tools/clis12.2 配置环境变量export ADOBE_ACCESS_TOKENyour_access_token export ADOBE_CLIENT_IDyour_client_id export ADOBE_COMPANY_IDyour_company_id三个变量缺一不可——adobe-analytics.js 在启动时会立即校验并输出 JSON 格式错误信息。12.3 完整操作序列# 1. 列出所有报告套件确认 rsid node tools/clis/adobe-analytics.js reportsuites list # 2. 查看某套件的可用维度 node tools/clis/adobe-analytics.js dimensions list --rsid mycompany-global # 3. 查看某套件的可用指标 node tools/clis/adobe-analytics.js metrics list --rsid mycompany-global # 4. 运行月度报表访问/浏览/订单按营销渠道分组 node tools/clis/adobe-analytics.js reports run \ --rsid mycompany-global \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/marketingchannel # 5. 列出分段用于后续圈定目标人群 node tools/clis/adobe-analytics.js segments list --rsid mycompany-global12.4 安全与输出特性凭证仅从环境变量读取严禁在脚本中硬编码令牌clis/README.mdJSON 输出所有命令输出均为 JSON可直接管道给jq解析或存入文件node tools/clis/adobe-analytics.js reports run --rsid mycompany-global \ --start-date 2024-01-01 --end-date 2024-01-31 \ --metrics visits,orders | jq .rows[0]--dry-run预演CLI 内置 dry-run 模式adobe-analytics.js可在不真正发送请求的前提下打印出将要调用的方法、URL 与请求头凭证以***掩码显示非常适合调试与审计。结语Adobe Analytics 作为企业级测量平台其接入路径可归纳为三层Reporting API 2.0 负责「读」报表、维度、指标、分段、Data Insertion API 负责「写」服务端事件投递、AppMeasurement.js 负责「采」浏览器端埋点。结合仓库提供的零依赖 CLI 与 analytics Skill 的跟踪方案框架AI Agent 可以低成本地完成从埋点设计、数据采集到自动化报表分析的全链路工作让企业级跨渠道数据真正服务于营销决策。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐VoiceCraft 入门指南三步跑通零样本语音编辑与文本转语音VoiceCraft 入门指南三步跑通零样本语音编辑与文本转语音 录音里读错一个词整段重来其实不必。VoiceCraft 是一个开源的零样本语音编辑与文本人工智能大模型语音音频Calypso 前端埋点实战Google Analytics 事件跟踪与页面浏览上报指南Calypso 前端埋点实战Google Analytics 事件跟踪与页面浏览上报指南 导读 本文以 wp calypso 仓库的 client/lib/前端CMSCAT 服务端 C 客户端 cppcat 接入指南编译、初始化与埋点 API 全解析CAT 服务端 C 客户端 cppcat 接入指南编译、初始化与埋点 API 全解析 CATCentral Application Tracking作可观测性指标监控告警APM后端链路追踪上一篇SwarmForge协作模式如何优化多代理工作流下一篇CKEditor 5架构深度解析现代富文本编辑器的技术演进与实践指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Adobe Analytics Agent 集成实战：Reporting API 2.0 报表、Data Insertion 服务端埋点与 AppMeasurement.js 接入指南
AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文以开源仓库 marketing skills 中的 Adobe Analytics 集成文档 为骨架完整讲解 AI Agent 如何通过 Reporting API 2.0 拉取企业级跨渠道分析数据、通过 Data Insertion API 完成服务端埋点、并通过 AppMeasurement.js 实现客户端采集。读完本文你将掌握 Adobe Analytics 的认证流程、核心数据模型Report Suite / eVars / props / Events、常用维度与指标以及如何在 adobe-analytics.js 零依赖 CLI 的辅助下让 Agent 直接执行报表查询、维度列举与分段筛选等自动化操作。一、Adobe Analytics 在 Marketing Skills 中的定位Adobe Analytics 是 Adobe Experience Cloud 的核心组件面向企业级跨渠道测量与归因。在 marketing skills 仓库中它被收录在 工具注册表 的Analytics分类下与 GA4、Mixpanel、Amplitude、PostHog、Segment、Plausible 并列定位为「企业级分析Enterprise analytics」。注册表对工具接入方式的标注如下来自 REGISTRY.md集成方式可用性说明API✓Reporting API 2.0、Data Insertion APIMCP-无原生 MCP ServerCLI-无官方 CLI但仓库提供了零依赖包装脚本 adobe-analytics.jsSDK✓AppMeasurement.js、Mobile SDKs、Launch标签管理值得注意的细节官方集成文档的「CLI」列标注为不可用是指 Adobe 不提供现成的命令行工具而本仓库在 tools/clis/ 中为它实现了一个单文件 Node.js CLI仅依赖 Node 18 原生fetch让 Agent 可以直接在终端中操作 Adobe Analytics无需安装任何第三方依赖。这是仓库对该集成的关键补充能力。二、认证方式OAuth 2.0Service Account JWTAdobe Analytics 的 API 认证采用OAuth 2.0 的 Service Account JWT 流程即服务器到服务器server-to-server模式不需要用户交互授权。认证要点类型OAuth 2.0Service Account JWT配置入口在 Adobe Developer Console 中创建集成Integration请求头Authorization: Bearer {access_token}同时必须携带x-api-key: {client_id}2.1 三步完成准备工作登录 Adobe Developer Console创建一个新项目并添加Adobe Analytics API服务使用 Service AccountJWT方式生成密钥对获取client_idAPI Key与client_secret通过 JWT 交换获得access_token与company_id组织 ID后续所有请求都以这三个值作为凭证。2.2 三个关键环境变量仓库的 CLI 实现 adobe-analytics.js 明确了运行所需的三个环境变量缺少任何一个都会直接报错退出环境变量含义ADOBE_ACCESS_TOKENOAuth 2.0 访问令牌Bearer TokenADOBE_CLIENT_IDAdobe Developer Console 中的 API Key即x-api-key请求头ADOBE_COMPANY_ID公司 ID用于拼接 API 基础路径https://analytics.adobe.io/api/{company_id}CLI 的请求封装函数adobe-analytics.js在每次调用时都会同时注入三个请求头Authorization: Bearer {access_token} x-api-key: {client_id} x-proxy-global-company-id: {company_id}其中x-proxy-global-company-id是 Adobe Analytics API 的全局公司级请求头用于在多组织场景下指明目标公司这是很多初次接入者容易遗漏的字段。三、常用 Agent 操作Reporting API 2.0Reporting API 2.0 是所有查询类操作的入口基础路径为https://analytics.adobe.io/api/{company_id}。以下操作均来自 集成文档 的「Common Agent Operations」章节并给出了仓库 CLI 的对应命令。3.1 获取报告套件信息Report SuitesGET https://analytics.adobe.io/api/{company_id}/reportsuites Authorization: Bearer {access_token} x-api-key: {client_id}对应 CLI 命令node tools/clis/adobe-analytics.js reportsuites list3.2 获取维度列表GET https://analytics.adobe.io/api/{company_id}/dimensions?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}rsid是报告套件 IDReport Suite ID用于限定查询范围。CLI 强制要求该参数adobe-analytics.jsnode tools/clis/adobe-analytics.js dimensions list --rsid {report_suite_id}3.3 获取指标列表GET https://analytics.adobe.io/api/{company_id}/metrics?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}CLI 同样要求--rsid参数node tools/clis/adobe-analytics.js metrics list --rsid {report_suite_id}3.4 获取分段列表SegmentsGET https://analytics.adobe.io/api/{company_id}/segments?rsid{report_suite_id} Authorization: Bearer {access_token} x-api-key: {client_id}分段在 CLI 中是可选的--rsid参数adobe-analytics.js不传则返回全公司分段node tools/clis/adobe-analytics.js segments list [--rsid {report_suite_id}]四、运行报表POST /reports 深入拆解运行报表是 Agent 最核心的操作通过POST /reports提交 JSON 请求体完成。原文档给出了一个完整示例这里逐字段拆解其含义POST https://analytics.adobe.io/api/{company_id}/reports { rsid: {report_suite_id}, globalFilters: [{ type: dateRange, dateRange: 2024-01-01T00:00:00/2024-01-31T23:59:59 }], metricContainer: { metrics: [ {id: metrics/visits}, {id: metrics/pageviews}, {id: metrics/orders} ] }, dimension: variables/evar1 }字段类型作用rsidstring报告套件 ID确定数据源globalFiltersarray全局过滤器最常见的type: dateRange用于限定时间范围格式为开始时间/结束时间ISO 8601metricContainer.metricsarray要返回的指标集合使用metrics/xxx形式的 IDdimensionstring报表的维度行维度使用variables/xxx形式的 ID4.1 与 CLIreports run的映射仓库 CLI 将上述请求体封装为易用的参数化命令adobe-analytics.jsnode tools/clis/adobe-analytics.js reports run \ --rsid {report_suite_id} \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/evar1从源码可以看出参数与请求体的对应关系--start-date/--end-date拼装为{start}T00:00:00/{end}T23:59:59的 dateRange 全局过滤器--metrics逗号分隔的指标 ID 列表内部按,拆分并trim后映射为{ id }对象数组--dimension可选参数传入后才会写入请求体的dimension字段--rsid必填缺失时报错退出。四个必需参数--rsid、--start-date、--end-date、--metrics缺一不可这是 CLI 对报表请求完整性的硬性校验。4.2 实战示例按营销渠道统计假设要分析 2024 年 1 月各营销渠道Marketing Channel的访问、页面浏览与订单node tools/clis/adobe-analytics.js reports run \ --rsid mycompany-global \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/marketingchannel五、Data Insertion API服务端数据接入当事件无法通过浏览器端的 JavaScript 采集时如服务器端支付回调、后端业务事件、数据迁移、无头浏览器环境使用Data Insertion API直接向 Adobe 的数据收集端点提交数据。POST https://{tracking_server}/b/ss/{report_suite_id}/0 ?xml version1.0 encodingUTF-8? request visitorIDuser_123/visitorID eventsevent1/events eVar1campaign_name/eVar1 prop1page_type/prop1 /request请求要点端点格式https://{tracking_server}/b/ss/{report_suite_id}/0其中{tracking_server}是您配置的跟踪服务器域名如metrics.example.com末尾的/0表示纯数据插入端点XML 结构以request为根节点字段与 AppMeasurement.js 中的变量一一对应核心字段visitorID访客标识、events成功事件、eVar1转化变量、prop1流量变量。Data Insertion 与客户端采集的区别在于它绕过了浏览器与 AppMeasurement.js由后端服务直接完成数据投递因此特别适合服务端归因、订单回传、离线事件补齐等场景。这也是集成文档将其列为与 Reporting API 并列的两大 API 能力之一的原因。六、AppMeasurement.js 客户端采集对于浏览器端页面使用 AppMeasurement.js 完成采集。原文档给出了最小可用的初始化与打点示例// Initialize var s s_gi(report_suite_id); s.trackingServer metrics.example.com; // Set variables s.pageName Home Page; s.channel Marketing; s.eVar1 campaign_name; s.events event1; // Track page view s.t(); // Track link s.tl(this, o, Button Click);6.1 关键 API 说明API / 属性作用s_gi(report_suite_id)实例化 AppMeasurement 对象参数为报告套件 IDs.trackingServer设置跟踪服务器域名与 Data Insertion 的{tracking_server}保持一致s.pageName页面名映射到维度variables/pages.channel站点渠道分类如 Marketing / Sales / Supports.eVar1自定义转化变量持久化跨页面保留s.events成功事件列表多个事件用逗号分隔如event1,event2s.t()发送页面浏览page view信标s.tl(this, o, Button Click)发送自定义链接跟踪信标第二参数o表示其他other链接类型第三参数为链接名6.2 与 analytics Skill 事件规范的映射在仓库的 analytics Skill 中事件命名遵循「对象-动作」规范如signup_completed、button_clicked、form_submitted而 Adobe Analytics 的事件体系使用数字型event1、event2及 eVar/prop 分类。接入时建议在 事件库参考 中先定义好业务事件清单如营销站点的cta_clicked、form_submitted、signup_completed将每个业务事件映射到一个 Adobeevent编号并建立映射文档使用 eVar 存放归因型属性如campaign_name、source、medium使用 prop 存放 hit 级别的即时属性如page_type。七、核心数据模型六大概念概念说明关键特性Report Suite报告套件数据的容器定义了数据的收集范围与配置所有报表查询都通过rsid指向某个套件eVars转化变量用于归因分析的自定义变量持久化persistent跨页面/会话保留适合承载营销活动、渠道来源等归因信息props流量变量用于流量分析的即时变量hit 级hit-level仅当前数据包有效适合页面类型等即时属性Events事件成功指标成功事件如订单、注册、下载数值型event1、event2… 可定义计数或数值类型Segments分段用户/访问级过滤器在报表中按条件圈定目标人群可复用、可共享Calculated Metrics计算指标由基础指标派生出的衍生指标如转化率 订单 / 访问支持公式与运算符记忆要点eVars 回答「谁带来的」归因props 回答「当时发生了什么」即时上下文Events 回答「完成了什么」转化结果Segments 负责「圈出哪群人」Calculated Metrics 负责「把指标算成比率」。八、常用维度与指标速查8.1 常用维度Dimensions维度 ID含义variables/page页面名称对应s.pageNamevariables/evar1自定义转化变量第 1 个variables/prop1自定义流量变量第 1 个variables/marketingchannel营销渠道由渠道处理规则自动归类variables/referringdomain引荐域名来源网站8.2 常用指标Metrics指标 ID含义metrics/visits访问次数metrics/pageviews页面浏览数metrics/uniquevisitors唯一访客数metrics/orders订单数metrics/revenue营收九、限流与合规提示限流Rate Limits——集成文档明确标注了如下阈值12 请求/秒/公司12 requests/second per company120 请求/分钟120 requests/minute这意味着 Agent 在批量拉取多个报表或并发执行多个维度/指标查询时需要自行控制请求节奏避免触发 429 限流。建议在自动化脚本中引入简单的速率控制如排队 间隔。合规提示——参照 analytics Skill 的隐私与合规章节遵守 EU/UK/CA 的 Cookie 同意要求不在 eVar/prop/事件属性中写入 PII个人身份信息配置合理的数据保留期与用户删除能力仅采集业务决策所需的最小数据集。十、何时选择 Adobe Analytics根据集成文档的「When to Use」清单以下场景适合将 Adobe Analytics 作为测量主平台企业级分析海量数据、多站点、多品牌场景下的规模化测量跨渠道归因将搜索、付费广告、邮件、社交等渠道的贡献统一归因Adobe Experience Cloud 生态集成与 Audience Manager、Target、Experience Platform 等协同高级分段基于访客、访问、事件的多层复杂分段分析数据仓库导出将分析数据导出到企业数据仓库做深加工。如果团队主要依赖 Google 生态GA4 集成文档 是更轻量的替代方案而当团队已经身处 Adobe 企业生态、需要跨渠道归因与数仓导出时Adobe Analytics 更为合适。两者在营销技能仓库中都属于 analytics Skill 的落地工具。十一、与相关 Skill 的联动集成文档末尾标注了三个关联技能Skill联动场景analytics设置跟踪方案、定义事件命名、落地埋点实现与数据质量校验ab-testing使用 Adobe Analytics 数据评估 A/B 实验的访问、转化与显著性ads结合广告投放数据做跨渠道效果分析与归因十二、端到端实战用仓库 CLI 快速接入仓库为 Adobe Analytics 提供了开箱即用的零依赖 CLI完整安装与使用说明见 tools/clis/README.md。12.1 安装方式三选一# 方式一直接运行 node tools/clis/adobe-analytics.js reportsuites list # 方式二符号链接到全局 bin便于直接使用命令名 ln -sf $(pwd)/tools/clis/adobe-analytics.js ~/.local/bin/adobe-analytics # 方式三将整个 tools/clis 目录加入 PATH export PATH$PATH:/path/to/marketingskills/tools/clis12.2 配置环境变量export ADOBE_ACCESS_TOKENyour_access_token export ADOBE_CLIENT_IDyour_client_id export ADOBE_COMPANY_IDyour_company_id三个变量缺一不可——adobe-analytics.js 在启动时会立即校验并输出 JSON 格式错误信息。12.3 完整操作序列# 1. 列出所有报告套件确认 rsid node tools/clis/adobe-analytics.js reportsuites list # 2. 查看某套件的可用维度 node tools/clis/adobe-analytics.js dimensions list --rsid mycompany-global # 3. 查看某套件的可用指标 node tools/clis/adobe-analytics.js metrics list --rsid mycompany-global # 4. 运行月度报表访问/浏览/订单按营销渠道分组 node tools/clis/adobe-analytics.js reports run \ --rsid mycompany-global \ --start-date 2024-01-01 \ --end-date 2024-01-31 \ --metrics visits,pageviews,orders \ --dimension variables/marketingchannel # 5. 列出分段用于后续圈定目标人群 node tools/clis/adobe-analytics.js segments list --rsid mycompany-global12.4 安全与输出特性凭证仅从环境变量读取严禁在脚本中硬编码令牌clis/README.mdJSON 输出所有命令输出均为 JSON可直接管道给jq解析或存入文件node tools/clis/adobe-analytics.js reports run --rsid mycompany-global \ --start-date 2024-01-01 --end-date 2024-01-31 \ --metrics visits,orders | jq .rows[0]--dry-run预演CLI 内置 dry-run 模式adobe-analytics.js可在不真正发送请求的前提下打印出将要调用的方法、URL 与请求头凭证以***掩码显示非常适合调试与审计。结语Adobe Analytics 作为企业级测量平台其接入路径可归纳为三层Reporting API 2.0 负责「读」报表、维度、指标、分段、Data Insertion API 负责「写」服务端事件投递、AppMeasurement.js 负责「采」浏览器端埋点。结合仓库提供的零依赖 CLI 与 analytics Skill 的跟踪方案框架AI Agent 可以低成本地完成从埋点设计、数据采集到自动化报表分析的全链路工作让企业级跨渠道数据真正服务于营销决策。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐VoiceCraft 入门指南三步跑通零样本语音编辑与文本转语音VoiceCraft 入门指南三步跑通零样本语音编辑与文本转语音 录音里读错一个词整段重来其实不必。VoiceCraft 是一个开源的零样本语音编辑与文本人工智能大模型语音音频Calypso 前端埋点实战Google Analytics 事件跟踪与页面浏览上报指南Calypso 前端埋点实战Google Analytics 事件跟踪与页面浏览上报指南 导读 本文以 wp calypso 仓库的 client/lib/前端CMSCAT 服务端 C 客户端 cppcat 接入指南编译、初始化与埋点 API 全解析CAT 服务端 C 客户端 cppcat 接入指南编译、初始化与埋点 API 全解析 CATCentral Application Tracking作可观测性指标监控告警APM后端链路追踪上一篇SwarmForge协作模式如何优化多代理工作流下一篇CKEditor 5架构深度解析现代富文本编辑器的技术演进与实践指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
