Readme for AOHs – Chinese Version

Posted on by

This a Chinese version of Readme for AOHs.

For English version please click HERE.

*********************************************

名称：自动优化助手
英文名称：AutomaticOptimizationHelper
英文简称：AOH
版本: 15.0

硬件要求:
1. 内存：512M+
2. PHP版本：5.6-7.4
3. 数据库：无
一般5刀的VPS就够用了，管理面板选宝塔即可。

硬件要求:
1. 内存：512M+
2. PHP版本：5.6-7.4
3. 数据库：无
一般5刀的VPS就够用了，管理面板选宝塔即可。

功能简介：
1. 定时检测流量源端/追踪端符合预设条件的website/zone/source等子渠道，自动生成黑名单列表和白名单列表，然后同步到流量源。
2. 自动从外部campaign提取黑白名单，添加到当前campaign的黑白名单列表。
3. 解放您的双手，全自动优化，减少不必要的预算花费，进而提高campaign的ROI。

使用方法：
0. 把转化回传至流量源端（推荐）。
1. 把程序上传到网站的根目录或者子目录。
https://www.mysite.com/
https://www.mysite.com/PopAdsHelper/
2. 到config.php文件中修改后台登录密码和流量源ApiKey。
3. 到config2.php文件中修改追踪器的apikey（如果使用）。
4. 把获得的授权文件放入程序根目录，然后重命名为license.php。
5. 登录后台。
https://www.mysite.com/PopAdsHelper/admin.php
admin.php可以重命名为其他名称。
6. 进行campaigns设置。
Campaigns->Settings->Campaign Settings
7. 开启自动优化。
Operation->Start

Global Settings（全局设置）：
1. Auto Optimize: 开启/禁用自动优化（全局级）。
2. Interval: 执行自动优化的时间间隔（建议10分钟起）。
3. Eye Protection: 开启豆沙绿背景色，以保护眼睛。
4. Timezone: 时区。
5. Miscellaneous：杂项
Rest xxx seconds after one campaign finished：在执行完一个campaign后休息xxx秒。
6. Trackers: 追踪器
如果需要使用追踪端的数据来进行优化，请勾选。
（此功能仅专业版可以使用）

Campaign Settings（Campaign设置）：
1. ID: 流量源端的Campaign ID。
2. Name: 流量源端的Campaign Name。
3. Auto Optimize: 启用/禁用自动优化（Campaign级）。
4. Date Range: 报表数据的时间段。
5. Payout: 任务的佣金，占位符”Payout”的真实值, 可以用于规则中的某些数值计算。
6. Max Loss Per Website: 一个website/zone/source等子渠道的最大亏损，大于这个值的将会被拉黑，优先级较高。
7. Blacklist Source: 黑名单来源。
8. Extract Blacklist Type: 黑名单来源子类型。
Extracted: 从外部Campaign提取的。
Generated: 由规则生成的。
Whiteblacked: 放入白名单后拉黑的。
Sticky: 置顶的。
9. Whitelist Source: 白名单来源。
10. Extract Whitelist Type：白名单来源子类型。
Extracted: 从外部Campaign提取的。
Generated: 由规则生成的。
Whiteblacked: 放入白名单后拉黑的。
Sticky: 置顶的。
11. Blacklist Source2：黑名单来源2。
12. Extract Blacklist Type：黑名单来源2子类型。
Extracted: 从外部Campaign提取的。
Generated: 由规则生成的。
Whiteblacked: 放入白名单后拉黑的。
Sticky: 置顶的。
13. Whitelist Source2：白名单来源2。
14. Extract Whitelist Type：白名单来源2子类型。
Extracted: 从外部Campaign提取的。
Generated: 由规则生成的。
Whiteblacked: 放入白名单后拉黑的。
Sticky: 置顶的。
15. Blacklist Source3 Url：黑名单来源3（URL）。
16. Blacklist Source3 Enabled：是否启用。
17. Whitelist Source3 Url：白名单来源3（URL）。
18. Whitelist Source3 Enabled：是否启用。
19. Website Skipped: 跳过的Website(s) （不进行判断和处理）。
20. Miscellaneous: 杂项。
Blacklist Website(s) after adding to Whitelist：放入白名单后拉黑。
Auto add $xxx WHEN budget < $yyy：当预算小于yyy自动增加xxx的预算。（某些流量源的Helper没有此功能）
21. Note: 笔记/备注。
22. Template: 规则模板。
23. Rules: 8大规则。
Rule11+12-TrafficSource-Ctr
Rule13+14-TrafficSource-Roi
Rule15+16-TrafficSource-eCPA
Rule17+18-TrafficSource-Cpc
Rule21+22-Tracker-LpCtr
Rule23+24-Tracker-Roi
Rule25+26-Tracker-Cv
Rule27+28-Tracker-Epv

Buttons（Campaigns页面底部的按钮）:
1. Bulk Yes: 批量开启所勾选Campaigns的自动优化。
2. Bulk No: 批量关闭所勾选Campaigns的自动优化。
3. Refresh: 刷新。
4. Bulk Purge: 批量删除所勾选的Campaigns的除campaignSettings.txt外的其他文件，即净化/重置campaign数据。 PS: 文件campaignInfo.txt file可能会被自动生成，无影响。
5. Bulk Edit: 批量修改所勾选Campaigns的设置。 必须勾选所要修改的内容前的复选框，否则不会修改。注：需谨慎操作，以免造成不必要的麻烦。

Templates（模板）:
提前配置campaign设置和规则。
可以在campaign设置页面手动加载此页面的规则模板，减少重复操作步骤。
Default: 默认规则。新增加的campaign将使用这个模板里面的规则。

Update（升级）:
1. 选择admin.php文件。
2. 上传到程序目录，覆盖旧的admin.php文件。
3. 重启软件。
这样操作，以前的设置都会保留下来，无需再次配置。
注：某些情况下，需要安装全新的版本才能使全部功能生效。

Apikeys:
1. 流量源
https://www.trafficsource.com/apikeys
2. BeMob追踪器
https://panel.bemob.com/app/profile/security
3. Binom追踪器
https://trk.yourbinomtracker.com/index.php?page=settings#tab=api

注意：
1. 在服务器重启后（手动或者异常），软件的运行将会中断，需要手动启动一下。
2. 部分数据有10分钟的缓存，耐心等待一会即可正常显示。
3. Website/Zone/Source等子渠道参数需要放在追踪参数第一个位置，否则容易导致数据异常。
4. AOH为各个Helper的合称，此说明为通用版本，具体到每个流量源的Helper会有一些差异和变化。

扩展阅读：
Sub Domains for AOH
https://blog.xindonglabs.com/sub-domains-for-aoh/
Readme for AOHs
https://blog.xindonglabs.com/readme-for-aohs/
How to Use Color in AOHs
https://blog.xindonglabs.com/how-to-use-color-in-aohs/
Rules Templates for AOHs
https://blog.xindonglabs.com/rules-templates-for-aohs/
How to modify PHP memory limit in aaPanel
https://blog.xindonglabs.com/how-to-modify-php-memory-limit-in-aapanel/
How to build blacklist and whitelist ring in AOH
https://blog.xindonglabs.com/how-to-build-blacklist-and-whitelist-ring-in-aoh/
Demo
https://demo.xindonglabs.com/