README

Advertising是一个无依赖的本地TYPO3扩展。为您的客户或自己创建广告活动，并在TYPO3页面上发布它们。它就像发布一个图片元素一样简单。

1 功能

• 本地TYPO3扩展，无需外部服务
• 100% GDPR合规（无cookies、无用户画像、不跟踪或处理个人数据）
• 以后台模块查看统计指标（已投递、已点击、点击率）
• 嵌入单个横幅
• 嵌入一个显示分配横幅的随机区域的区域
• 设置活动的开始和结束日期和时间

2 使用方法

2.1 安装

从TYPO3扩展存储库（TER）作为扩展安装

下载并使用扩展管理模块安装扩展。

2.2 最小设置

1. 创建一个新的文件夹，并按您希望的名称命名
2. 编辑此sys文件夹，转到行为并选择广告插件
3. 转到资源选项卡并选择页面TSConfig: EXT:advertising并保存文件夹
4. 编辑您的根页面模板，转到包含选项卡并选择EXT:advertising静态文件。
5. 转到管理员工具：设置并单击配置扩展。在此处编辑扩展的存储页面：advertising
6. 现在您已准备好在步骤1中创建的客户文件夹内创建客户、活动、区域和横幅

2.3 推荐设置

路由增强器

为步骤5中设置的typeNum值设置自定义路由。我推荐以下设置：routeEnhancers: PageTypeSuffix: type: PageType [...] map: [...] '/clicktracking': 28062019 '/deliveredtracking': 28062020

3 如何使用此扩展

在您创建第一个横幅之前，转到创建的sys文件夹，并创建至少一个客户和活动。每个横幅都需要分配给一个客户和一个活动。如果您没有客户，则为自己创建一个客户实体。

区域是可选的，因为您也可以在TYPO3页面上创建单个横幅。您将在内容元素浏览器中找到横幅和区域。

3.1 活动

活动包含决定是否在前端显示广告材料的信息。目前您可以设置开始和结束时间。您也可以留空，这样您的活动就始终处于活动状态。

3.2 客户

客户只是一个名称，将活动和横幅分组到个人或组织。它用于为您提供在您的网站上为您的客户出售广告位置的机会。

3.3 区域

区域是一个只显示一个横幅的内容元素。如果有多个横幅分配给此区域并且有活动，则它将从列表中随机选择一个横幅。目前没有优先级，但它们将在未来的版本中提供。

3.4 横幅

横幅是目前您可以获取的唯一广告材料，但它们将在未来的版本中提供更多。横幅只是一个带链接的图片。网站上的每次出现和点击都将通过异步JavaScript进行跟踪。

4 显示统计

为管理员提供了一个新的后端模块：广告。此模块显示所有可用统计数据的仪表板，包括活动和它们的横幅。目前扩展程序只显示以下数据：

• 已投递（当横幅在前端显示时递增）
• 已点击（当用户点击横幅时递增）
• 点击率（CTR）。点击次数/投递次数的比率。

5 跟踪

跟踪是通过异步JavaScript完成的。它不是完美的，但这是最好的解决方案。在不同的情况下可能会发生广告遗漏了投递或点击事件的情况。这通常发生在以下情况下：

• 用户离开页面比脚本加载快
• 用户点击广告材料比脚本加载快

这就是为什么数据不是100%准确的，但它是一个非常好的估计。

6 更新日志

更新日志可以在CHANGES.md文件中找到。

6.1 版本管理

广告使用语义版本控制，这意味着：

• 错误修复更新（例如，1.0.0 => 1.0.1）仅包括小错误修复或安全相关内容，没有破坏性更改，
• 次要更新（例如，1.0.0 => 1.1.0）包括新功能和较小的任务，没有破坏性更改，
• 以及 主要更新（例如，1.0.0 => 2.0.0）破坏性更改，可能是重构、功能或错误修复。

基于以上说明，我 强烈建议在升级广告到任何版本之前，更新整个网页。

感谢我的贡献者

• Dmitry Dulepov

探索更多

如果您正在寻找出色且易于使用的TYPO3模板和扩展，请访问：T3 Templates

7 最后的话

我将尽我所能使此扩展尽可能准确和可靠。不幸的是，我无法保证跟踪始终有效。此外，还有许多外部潜在因素可能导致此扩展无法工作。例如，JavaScript可能会停止工作，以及某些错误类型。

因此，我无法承担因扩展性能不佳或生成错误数据而遇到的问题的责任。

我能做的只是尽我所能使此扩展尽可能好。