AdOps Report Helper

一个用于支付宝广告运营平台的浏览器插件，可以快速设置报告页面的常用参数并直接生成报告。

功能特性

• 📊 一键生成报告：直接生成报告（自动设置参数）
• 🎯 智能参数设置：自动设置归因方式、时间单位、周期等参数
• 🔧 异步报告下载：支持异步报告生成和下载

设置内容

插件会自动设置以下参数：

1. 归因方式：按计费时间归因
2. 时间单位：分天
3. 周期：昨日

安装方法

方法一：开发者模式安装

1. 打开 Chrome 浏览器
2. 访问 chrome://extensions/
3. 开启右上角的"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择本项目的根目录
6. 插件安装完成

方法二：打包安装

1. 在 chrome://extensions/ 页面点击"打包扩展程序"
2. 选择本项目的根目录
3. 生成 .crx 文件
4. 将 .crx 文件拖拽到扩展程序页面进行安装

使用方法

一键生成报告

1. 访问 支付宝广告运营平台报告页面
2. 点击浏览器工具栏中的插件图标
3. 在弹出的窗口中点击"生成报告"按钮
4. 插件会自动设置参数并发送报告生成请求
5. 显示报告生成结果和任务信息

页面刷新

1. 点击插件图标
2. 在弹出的窗口中点击"刷新页面"按钮
3. 页面将重新加载

故障排除

如果插件显示"报告生成失败: 登录已过期，请重新登录后再试"

原因: 插件发送的请求缺少必要的认证信息

解决方法:

1. 确保在正确的页面使用插件
2. 确保页面已完全加载
3. 尝试刷新页面后重新使用插件
4. 如果问题持续，请使用页面按钮触发下载

验证步骤:

1. 访问 https://adops.alipay.com/report/agent/
2. 确保页面正常加载且已登录
3. 运行认证信息检查工具

认证信息检查工具:

// 复制以下代码到控制台中运行
console.log('=== 检查认证信息 ===');
console.log('Cookies:', document.cookie);
console.log('LocalStorage:', Object.keys(localStorage).map(k => `${k}: ${localStorage.getItem(k)}`));
console.log('SessionStorage:', Object.keys(sessionStorage).map(k => `${k}: ${sessionStorage.getItem(k)}`));

如果插件显示"已经创建过相同任务,可移步任务中心下载"

原因: 相同的报告任务已经存在，支付宝系统不允许重复创建

解决方法:

1. 等待3秒后再试（插件有防抖保护）
2. 前往任务中心查看已存在的任务
3. 如果确实需要新报告，请等待当前任务完成后再试

注意事项:

• 插件已添加防抖保护，3秒内只能点击一次
• 按钮在生成过程中会显示"生成中..."状态
• 重复任务错误会显示为警告（黄色）而非错误（红色）

如果插件显示"设置失败，请重试"

1. 打开浏览器开发者工具（按F12）
2. 切换到Console标签
3. 使用插件并查看详细错误信息
4. 根据错误信息诊断问题

常见问题解决

1. 页面未完全加载

   • 等待页面完全加载后再使用插件
   • 刷新页面后重试

2. 元素未找到

   • 检查页面结构是否发生变化
   • 确认在正确的页面使用插件

3. 权限问题

   • 确保插件有访问页面的权限
   • 重新安装插件

调试信息说明

插件会输出详细的调试信息，包括：

• 页面结构分析
• 找到的按钮和下拉框
• 元素查找过程
• 设置结果统计
• 错误详情

详细调试信息请查看浏览器控制台输出

文件结构

adops_report_helper/
├── manifest.json          # 插件配置文件
├── popup.html            # 弹窗界面
├── popup.js              # 弹窗逻辑
├── popup.css             # 弹窗样式
├── content.js            # 内容脚本
├── content.css           # 内容脚本样式
├── background.js         # 后台脚本
├── icons/                # 插件图标
│   ├── icon16.png
│   ├── icon48.png
│   ├── icon128.png
│   └── icon.svg
└── README.md             # 说明文档

技术栈

• Manifest V3：使用最新的浏览器插件标准
• Vanilla JavaScript：无依赖的纯 JavaScript 实现
• CSS3：现代化的样式设计
• Chrome Extension API：使用官方 API 进行页面交互

兼容性

• Chrome 88+
• Edge 88+
• 其他基于 Chromium 的浏览器

开发说明

修改参数设置

如需修改自动设置的参数，请编辑 content.js 文件中的 setReportParameters 函数。

添加新功能

1. 在 content.js 中添加新的功能函数
2. 在 popup.js 中添加对应的按钮和事件处理
3. 在 popup.html 中添加相应的 UI 元素
4. 在 popup.css 中添加样式

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。