============================================================
巨量引擎创意分析处理 —— 适配清单（基于腾讯版模板改造）
============================================================
本模板包 = 腾讯「创意分析处理」(v20261106e) 的完整源码。
你只需改写【平台 API 层】与【配置/账户】，其余分析算法、UI、操作记录
全部可直接复用。下面按"改动量从大到小"列出必改项。

------------------------------------------------------------
一、必须重写：平台 API 层（index.php 内）
------------------------------------------------------------
1) 接口地址
   - 腾讯：$API_BASE = 'https://api.e.qq.com'
   - 巨量：$API_BASE = 'https://api.oceanengine.com/open_api'
     （OpenAPI v1.0 也可，注意 host 与路径前缀差异）

2) 鉴权方式（最大差异）
   - 腾讯：请求头 X-MKT-API-Key: <api_key>
   - 巨量：请求头 Authorization: Bearer <access_token>
   - 修改位置：httpPost() 里的 $headers 数组。
   - ⚠️ access_token 走 OAuth 授权码流程获取，会过期（注意刷新逻辑），
     比腾讯 API Key 复杂。config.php 里把 'api_key' 换成 'access_token'。

3) 读取接口拆分（腾讯是创意+报表合一，巨量要拆两个）
   - 创意维度：POST /2/creative/get
       返回 creative_id / creative_name / create_time(秒级时间戳) /
       status / operate_status / ad_id / ad_name / advertiser_id
   - 报表数据：POST /2/report/integrated/get
       维度 dimensions: ["creative_id","stat_time_day"]
       指标 metrics: ["cost","convert_cnt", ...]（转化指标见第四条）
   - 修改位置：scanCreatives() —— 先拉创意清单，再单独拉报表，按 creative_id 合并。

4) 字段映射（在 scanCreatives / fetchCreativeMetaByIds 内替换）
   腾讯字段                     → 巨量字段
   account_id（广告账户）        → advertiser_id（广告主）
   adgroup（单元）               → ad（广告）：ad_id / ad_name
   campaign（推广计划）          → campaign（广告组）
   dynamic_creative_id/name      → creative_id / creative_name
   created_time                  → create_time（tsVal() 已兼容时间戳，可直接用）
   configured_status（暂停）     → operate_status / status（CREATIVE_STATUS_*）
   report.cost                  → cost
   report.conversions_count     → convert_cnt（★需确认你们实际转化目标字段）
   report.effect_leads_purchase_count → 对应巨量深度转化/有效线索指标

5) 暂停 / 恢复创意（写接口）
   - 腾讯：/v3.0/dynamic_creatives/update 传 configured_status
   - 巨量：/2/creative/status/update
        body: { advertiser_id, creative_ids:[...], operate_status:"disable"|"enable" }
   - 修改位置：setCreativeStatus()

6) 按 id 点名补维度（操作记录回填用）
   - 腾讯：dynamic_creatives/get 按 dynamic_creative_id IN/EQUALS
   - 巨量：/2/creative/get 传 filtering（creative_ids）或 creative_ids 列表
   - 修改位置：fetchCreativeMetaByIds()

7) 分页
   - 巨量 creative/get、report/integrated/get 均为 page/page_size + data.page_info。
   - fetchAll() 里把 $totalPage 取值改成 $data['page_info']['total_page']（多数情况下与腾讯一致，核对一下即可）。

------------------------------------------------------------
二、必须改：config.php
------------------------------------------------------------
- 'api_key'      → 改名为 'access_token'（或保留键名但填 token，注释写清）
- 'accounts_*'   → 账户清单中间列从"账户ID"改为"广告主ID(advertiser_id)"
- 'data_dir'     → 指向新空间的可写目录
- 'password'     → 网页登录锁，建议改个新密码
- 阈值 days / max_cost / max_conv / days30 / max_batch / cache_ttl
  → 含义不变，可直接沿用，按巨量账户情况微调

------------------------------------------------------------
三、建议改：UI 列名（可选，按习惯）
------------------------------------------------------------
- 主表/操作记录的"单元"列 → 对应巨量的"广告(ad)"；
  可保留列名为"单元"或改成"广告"。内部取数改 $it['unit'] 来自 ad_name 即可。
- 其余列（账户/创意名/创意id/创建时间）概念一致，无需改。

------------------------------------------------------------
四、可直接复用（不用动）
------------------------------------------------------------
- analyzeDrop()  掉量分析（最后出单日 / 持续0转化天数 / 类型：
                  突然断·波动·一直不稳·压量）—— 纯算法，只吃逐日 conv/cost 序列
- sparkline()    逐日转化迷你柱图
- 僵尸判定 + 功勋创意逻辑（阈值体系）
- 操作记录模块（暂停日志 / 还原 / ✎补登 / 导出CSV / 清除）
- 表头排序、meta.json + cre_meta.json 回填机制
- config 框架、data 目录结构、部署说明结构

------------------------------------------------------------
五、关键提醒（踩过的坑）
------------------------------------------------------------
- 腾讯曾出现"已暂停创意不再返回维度 → 操作记录填不出单元/创建时间"。
  巨量报表对 disable 创意同样可能丢数据，所以 meta/cre_meta 回填 +
  手动"补登"机制【务必保留】，不要删。
- 巨量转化是多转化目标（表单/咨询/有效线索等），convert_cnt 只是通用占位，
  上线前务必和黄海程确认他们后台实际用的转化目标字段名，否则"有无出单"
  判断会失真。
- access_token 过期问题：若要做成长期运行的网页，记得加 token 刷新/缓存。

------------------------------------------------------------
六、本地语法自检（可选）
------------------------------------------------------------
模板包不含便携 PHP（88MB，太大）。如需在本地先 php -l 检查语法，
把腾讯版 web-dist/php/php.exe 拷到新空间同名目录即可：
  php.exe -l index.php
服务器运行只需 PHP ≥ 7.4 + curl 扩展，data 目录可写。

============================================================
交付文件清单（本模板包）：
  index.php              主程序（腾讯版源码，API 层待改写）
  config.php            配置模板（api_key→access_token、账户列→广告主ID）
  accounts.csv          账户清单模板（中间列改为广告主ID）
  部署说明-腾讯参考.txt  腾讯版部署说明（结构参考，按巨量改文案）
  data/index.html        data 目录占位（新空间需保持可写）
  巨量引擎适配清单.txt   本文件
============================================================
