From c1970ab478e761552921fbdaf04c4fda84587bf4 Mon Sep 17 00:00:00 2001 From: liyanchao Date: Fri, 10 May 2024 15:21:56 +0800 Subject: [PATCH] update: uni-ad-admin --- docs/uni-ad-admin.md | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/docs/uni-ad-admin.md b/docs/uni-ad-admin.md index e531945..be00a43 100644 --- a/docs/uni-ad-admin.md +++ b/docs/uni-ad-admin.md @@ -17,7 +17,7 @@ 前往[插件市场](https://ext.dcloud.net.cn)， 找到 [uni-ad-admin](https://ext.dcloud.net.cn/plugin?name=uni-ad-admin)插件，点击 `下载插件并导入HBuilderX` ，在 HBuilderX 中选择对应的 `uni-admin`项目，HBuilderX会自动完成插件下载及文件合并。 `uni-ad-admin` 插件新增的文件主要包括： -- 云函数：`uni_modules/uni-ad-admin/uniCloud/cloudfunctions/uni-ad-admin-receiver` 接收推送数据云函数 +- 云函数：`uni_modules/uni-ad-admin/uniCloud/cloudfunctions/uni-ad-admin-receiver` 接收同步数据云函数 - 数据表：`uni_modules/uni-ad-admin/uniCloud/database`目录下 `uni-ad` 开头的 `schema` 文件 - 统计页面：`uni_modules/uni-ad-admin/pages` 文件夹下面的若干页面 @@ -84,26 +84,25 @@ schema 位于 uniCloud/database 目录下，在 `database` 目录右键点击 ` ## 收益数据同步 -登录[uniAd控制台](https://uniad.dcloud.net.cn)，在右上角点击 `收益数据同步` 按钮，在弹出框中选择已部署含`uni-ad-admin`插件的`uni-admin`项目空间： +登录[uniAd控制台](https://uniad.dcloud.net.cn)，在右上角点击 `uni-ad-admin` 按钮，在弹出框中选择已部署含`uni-ad-admin`插件的`uni-admin`项目空间： -![](https://img-cdn-tx.dcloud.net.cn/doc/uni-ad-admin/new-shengqing.png) +![](https://web-ext-storage.dcloud.net.cn/doc/uniadmin/shengqing.png) 注意：`secret`是数据同步过程中的加密秘钥，务必和`uniCloud/cloudfunctions/uni-ad-admin-receiver/config/config.json`文件中配置的`scrert`保持一致。 :::warning 注意 -- 推送说明：如你在下午3点后申请，数据在次日下午3点开始推送。 -- 数据推送：每日下午3点开始推送昨日收益数据。如需历史数据推送请发邮件到 `service@dcloud.io` 申请。 -- 由于网络或数据库无读、写次数等原因推送后，服务器会有重试推送机制，每日重试5次，5次都失败后不再推送。如你确认服务空间无问题后可以应用收益详情的 `推送日志` 中点击重新推送。 +- 数据同步：每日下午3点开始同步昨日收益数据。如需历史数据同步请发邮件到 `service@dcloud.io` 申请。 +- 由于网络或数据库无读、写次数等原因同步失败后，服务器会有重试同步机制，每日重试5次，5次都失败后不再同步。如你确认服务空间无问题后可以应用收益详情的 `同步日志` 中点击重新同步。 - `云函数` 接收到同步后首先会按 `收益日期` 删除已存在数据，防止数据重复。不使用循环查询是否存在以减少读、写次数。 ::: -如果你的原服务空间过期或其它原因需要变更收益数据的服务空间，则需再次登录[uniAd控制台](https://uniad.dcloud.net.cn)，点击右上角 `收益数据同步` 按钮，在弹出对话框中选择新的服务空间即可。 +如果你的原服务空间过期或其它原因需要变更收益数据的服务空间，则需再次登录[uniAd控制台](https://uniad.dcloud.net.cn)，点击右上角 `uni-ad-admin` 按钮，在弹出对话框中选择新的服务空间即可。 你也可以在该弹出框中，点击左下角的`关闭收益同步`按钮，关闭该项功能。 -在[uniAd控制台](https://uniad.dcloud.net.cn)的应用收益详情中，可查看数据推送日志。如有推送失败的，可点击重新推送。 +在`uni-ad-admin`的应用收益详情中，可查看数据同步日志。如有同步失败的，可点击重新同步。 -![](https://img-cdn-tx.dcloud.net.cn/doc/uni-ad-admin/user-repush.png) +![](https://web-ext-storage.dcloud.net.cn/doc/uniadmin/user-repush.png) ## 插件源码解读 @@ -156,26 +155,26 @@ schema 位于 uniCloud/database 目录下，在 `database` 目录右键点击 ` |revenue|int|0|-|预估收益，单位：厘| |create_time| timestamp| -|-|创建时间| -**uni-ad-sync-logs数据推送日志表** +**uni-ad-sync-logs数据同步日志表** |字段|类型|默认值|可选值|说明| |:-:|:-:|:-:|:-:|:-:| -|sync_date | int | - | - | 收益推送日期，格式：yyyymmdd，例：20240415 | +|sync_date | int | - | - | 收益同步日期，格式：yyyymmdd，例：20240415 | |appid | string | | | 应用appid，对应opendb-app-list.appid| |ad_region | int| 1 | 1,2 | 数据源| -|status | int | 0 | 0,1,2,3 | 推送状态 | +|status | int | 0 | 0,1,2,3 | 同步状态 | |create_time| timestamp| -|-|创建时间| |update_time| timestamp| -|-|更新时间| ### 表字段说明 -**`status`：推送状态** +**`status`：同步状态** |值|说明| |:-:|:-:| -|0|未推送| -|1|推送完成| -|2|正在推送| -|3|推送失败| +|0|未同步| +|1|同步完成| +|2|正在同步| +|3|同步失败| **`ad_region`：数据源** @@ -254,13 +253,13 @@ schema 位于 uniCloud/database 目录下，在 `database` 目录右键点击 ` ## 常见问题 -**1. 申请数据推送后，何时可以查看报表数据 ？** +**1. 申请数据同步后，何时可以查看报表数据 ？** -答：数据推送服务每日下午3点启动，如您在下午3点后申请，在次日下午3点才会启动推送。 +答：数据同步服务每日下午3点启动，如您在下午3点后申请，在次日下午3点才会启动同步。 **2. 数据报表可查看当日数据吗？** -答：数据推送和 `uni-ad` 后台一样，今日出昨日的预估收益。 +答：数据同步和 `uni-ad` 后台一样，今日出昨日的预估收益。 **3. 子账号需要赋予哪些表的权限才能正常查看uni-ad统计？** -- GitLab