1.8.x Tính Năng: Rotating Ads

Preview

Tác giả: SickProdigy

Phiên bản: v1.0.0

Gửi lúc: 4 giờ trước

Cập nhật lúc: 4 giờ trước

Admin Control Panel Forum Display Index Page Show Thread
Mô tả
Rotating Ads

A flexible advertisement manager for MyBB 1.8

Rotating Ads provides a native MyBB advertisement manager for displaying and rotating square or banner advertisements throughout your forum.

Advertisements are managed individually through the Admin CP. Each advertisement can have its own delivery rules, targeting, limits, and performance totals.

Features
  • Separate square and banner advertisement slots
  • Native MyBB Admin CP advertisement manager
  • Random server-side advertisement selection
  • Optional JavaScript rotation while viewing a page
  • Configurable minimum and maximum rotation intervals
  • Weighted delivery for prioritizing advertisements
  • Start and end date scheduling
  • Maximum impression and click limits
  • Automatic removal from rotation when a limit is reached
  • Country allowlist and blocklist targeting
  • Primary and additional usergroup exclusions
  • Impression, click, and CTR tracking
  • Optional destination hostname in tracked links
  • Configurable sponsor label
  • Configurable same-tab or new-tab behavior
  • Support for HTTP(S) URLs and local image paths
  • MyBB-managed theme stylesheet
  • Responsive square and banner output
  • No visitor identity storage

Advertisement Placement

The plugin provides two template variables:

Code: 
{$rotating_ads_square}
{$rotating_ads_banner}

Place either variable in any compatible MyBB template where you want that advertisement format to appear.

Rotating Ads does not automatically modify your page layout or force advertisements into predefined locations.

In-Page Rotation

By default, one weighted random advertisement is selected on every page request.

Administrators can optionally enable in-page rotation, allowing advertisements to change while a visitor remains on the same page. The minimum and maximum time between rotations can be configured.

In-page rotation requires JavaScript. Visitors without JavaScript will still receive the initial server-selected advertisement.

Campaign Controls

Each advertisement can be configured with:
  • Delivery weight from 1 to 100
  • Optional UTC start date
  • Optional UTC end date
  • Maximum impressions
  • Maximum clicks
  • Enabled or disabled status
  • Country targeting rules

A value of 0 disables the corresponding impression or click limit.

Higher delivery weights make an advertisement more likely to be selected. For example, an advertisement with a weight of 5 will be selected approximately five times as often as one with a weight of 1 in the same eligible pool.

Country Targeting

Advertisements can be displayed to:
  • All countries
  • Only selected countries
  • All countries except selected countries

Country codes use the standard two-letter format, such as:

Code: 
US, CA, GB

Country detection requires the server or reverse proxy to provide one of the following:

Code: 
CF-IPCountry
GEOIP_COUNTRY_CODE
X-AppEngine-Country

The plugin does not send visitor IP addresses to an external geolocation service.

Performance Tracking

The Admin CP advertisement manager displays lifetime:
  • Impressions
  • Clicks
  • Click-through rate
  • Delivery limits and current progress

Tracked click URLs can optionally reveal the destination hostname:

Code: 
misc.php?action=ra_click&to=example.com&aid=1

The displayed hostname is informational. The redirect is always resolved from the advertisement’s saved database record, preventing URL parameter tampering.

Metrics are intended as lightweight operational statistics. They do not store visitor identities and should not be considered billing-grade or bot-filtered analytics.

Local Images

Full HTTP(S) image URLs and site-relative paths are supported:

Code: 
https://example.com/images/sponsor.jpg
/images/sponsored/ad-hostpro.jpg

Installation

Upload the contents of the Upload directory into your MyBB installation root.

Install and activate the plugin from:

Code: 
Admin CP > Configuration > Plugins

Manage individual advertisements from:

Code: 
Admin CP > Configuration > Rotating Ads

General display and rotation options are available from:

Code: 
Admin CP > Configuration > Settings > Rotating Ads

Compatibility
  • MyBB 1.8.x
  • MySQL
  • PostgreSQL
  • SQLite
Quảng cáo luân phiên

Trình quản lý quảng cáo linh hoạt cho MyBB 1.8

Rotating Ads cung cấp một trình quản lý quảng cáo MyBB gốc để hiển thị và xoay các quảng cáo hình vuông hoặc banner trong toàn bộ diễn đàn của bạn.

Quảng cáo được quản lý riêng lẻ thông qua Admin CP. Mỗi quảng cáo có thể có quy tắc phân phối, mục tiêu, giới hạn và tổng hiệu suất riêng.

Tính năng

  • Khe quảng cáo hình vuông và banner riêng biệt
  • Trình quản lý quảng cáo CP MyBB Admin gốc
  • Chọn quảng cáo ngẫu nhiên phía máy chủ
  • Xoay JavaScript tùy chọn khi xem trang
  • Khoảng thời gian quay tối thiểu và tối đa có thể cấu hình
  • Giao hàng có trọng số để ưu tiên quảng cáo
  • Lập lịch ngày bắt đầu và kết thúc
  • Giới hạn số lần hiển thị và nhấp chuột tối đa
  • Tự động loại bỏ khỏi vòng quay khi đạt giới hạn
  • Danh sách cho phép theo quốc gia và nhắm mục tiêu danh sách chặn
  • Loại trừ nhóm người dùng chính và bổ sung
  • Theo dõi lượt hiển thị, nhấp chuột và CTR
  • Tên máy chủ đích tùy chọn trong các liên kết được theo dõi
  • Nhãn nhà tài trợ có thể cấu hình
  • Hành vi có thể cấu hình cho cùng tab hoặc mới
  • Hỗ trợ URL HTTP(S) và đường dẫn hình ảnh cục bộ
  • Bảng kiểu chủ đề do MyBB quản lý
  • Đầu ra hình vuông và banner phản hồi nhanh
  • Không lưu trữ danh tính khách truy cập

Vị trí quảng cáo

Plugin cung cấp hai biến mẫu:

Mã nguồn:
{$rotating_ads_square}
{$rotating_ads_banner}

Đặt bất kỳ biến nào trong bất kỳ mẫu MyBB tương thích nào ở vị trí bạn muốn định dạng quảng cáo đó xuất hiện.

Xoay quảng cáo không tự động thay đổi bố cục trang của bạn hoặc ép quảng cáo vào các vị trí đã định sẵn.

Xoay trang trong trang

Theo mặc định, mỗi yêu cầu trang sẽ chọn một quảng cáo ngẫu nhiên có trọng số.

Quản trị viên có thể tùy chọn bật luân phiên trong trang, cho phép quảng cáo thay đổi trong khi khách truy cập vẫn ở cùng trang. Thời gian tối thiểu và tối đa giữa các lần luân phiên có thể được cấu hình.

Xoay trang trong trang yêu cầu JavaScript. Khách truy cập không có JavaScript vẫn sẽ nhận được quảng cáo được chọn ban đầu do máy chủ chọn.

Kiểm soát Chiến dịch

Mỗi quảng cáo có thể được cấu hình với:

  • Trọng lượng giao hàng từ 1 đến 100
  • Ngày bắt đầu UTC tùy chọn
  • Ngày kết thúc UTC tùy chọn
  • Số lần hiển thị tối đa
  • Số lần nhấp chuột tối đa
  • Trạng thái bật hoặc tắt
  • Quy tắc nhắm mục tiêu quốc gia

Một giá trị của0Vô hiệu hóa giới hạn hiển thị hoặc nhấp tương ứng.

Trọng số giao hàng cao hơn làm cho quảng cáo có khả năng được chọn cao hơn. Ví dụ, một quảng cáo có trọng số 5 sẽ được chọn khoảng năm lần tần suất so với quảng cáo có trọng số 1 trong cùng nhóm đủ điều kiện.

Nhắm mục tiêu quốc gia

Quảng cáo có thể được hiển thị đến:

  • Tất cả các quốc gia
  • Chỉ một số quốc gia được chọn
  • Tất cả các quốc gia ngoại trừ một số quốc gia được chọn

Mã quốc gia sử dụng định dạng tiêu chuẩn hai chữ cái, chẳng hạn như:

Mã nguồn:
Mỹ, CA, Anh

Phát hiện quốc gia yêu cầu máy chủ hoặc proxy ngược cung cấp một trong các điều sau:

Mã nguồn:
CF-IPCountry
GEOIP_COUNTRY_CODE
X-AppEngine-Quốc gia

Plugin không gửi địa chỉ IP của khách đến dịch vụ định vị địa lý bên ngoài.

Theo dõi hiệu suất

Trình quản lý quảng cáo Admin CP hiển thị thời gian sử dụng:

  • Ấn tượng
  • Nhấp chuột
  • Tỷ lệ nhấp chuột
  • Giới hạn giao hàng và tiến độ hiện tại

URL nhấp chuột theo dõi có thể tùy chọn tiết lộ tên máy chủ đích:

Mã nguồn:
misc.php?action=ra_click&to=example.com&aid=1

Tên máy chủ hiển thị là thông tin. Chuyển hướng luôn được giải quyết từ bản ghi cơ sở dữ liệu đã lưu của quảng cáo, ngăn chặn việc thay đổi tham số URL.

Các chỉ số được thiết kế như các thống kê vận hành nhẹ nhàng. Chúng không lưu trữ danh tính khách truy cập và không nên được coi là phân tích đạt chuẩn hóa đơn hoặc lọc bot.

Hình ảnh cục bộ

Các URL hình ảnh HTTP(S) đầy đủ và đường dẫn tương đối trang web được hỗ trợ:

Mã nguồn:
https://example.com/images/sponsor.jpg
/hình ảnh/tài trợ/ad-hostpro.jpg

Lắp đặt

Tải lên nội dung củaTải lênthư mục vào thư mục gốc cài đặt MyBB của bạn.

Cài đặt và kích hoạt plugin từ:

Mã nguồn:
Admin CP > Cấu hình > Plugin

Quản lý quảng cáo riêng lẻ từ:

Mã nguồn:
Quản trị viên CP > Cấu hình > Quảng cáo luân phiên

Các tùy chọn hiển thị và xoay chung có sẵn từ:

Mã nguồn:
Cài đặt cấu hình > > CP quản trị viên > Quảng cáo luân phiên

Tương thích
  • MyBB 1.8.x
  • MySQL
  • PostgreSQL
  • SQLite