PHPackages                             lazyexe/openads - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. lazyexe/openads

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

lazyexe/openads
===============

Lightweight Ads Engine for Laravel

0.0.1(3mo ago)21MITPHPPHP ^8.2

Since Feb 2Pushed 3mo agoCompare

[ Source](https://github.com/lazyexe/openads)[ Packagist](https://packagist.org/packages/lazyexe/openads)[ RSS](/packages/lazyexe-openads/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

OpenAds [ID](./README-ID.md)
============================

[](#openads-id)

Lightweight &amp; extensible OpenAds for Laravel, suitable for internal ads, marketplaces, CMS, or monetization platforms. All metrics (CTR, relevance, landing score) and click/view costs are automatically calculated based on ad performance.

---

✨ Key Features
--------------

[](#-key-features)

- 🔍 Search Ads (keyword-based)
- 🖼️ Image &amp; 🎥 Video Ads (URL / local / CDN)
- 🎯 Campaign → Ad Group → Ads → Keywords → Assets
- ⏰ Display based on time (start\_time &amp; end\_time, default 24 hours)
- 🌍 Target locations: country / city (multi, default all)
- 📱 Target devices: android / ios / desktop (multi, default all)
- 🏆 Auction &amp; ranking (bid × quality score)
- 📊 Automatic impression &amp; click tracking
- 💰 Click cost = bid, view cost = bid × 20% (configurable)
- 🔄 CTR, relevance, landing score &amp; campaign balance calculated automatically

---

📦 Installation
--------------

[](#-installation)

```
composer require lazyexe/openads
```

Or Manual / Local Development

```
"require": {
	"lazyexe/openads": "*"
},
"repositories": [
	{
		"type": "path",
		"url": "OpenAds"
	}
],

```

Publish config &amp; migrations:

```
php artisan vendor:publish --tag=ads-config
php artisan vendor:publish --tag=ads-migrations
php artisan migrate
```

---

🚀 Usage
-------

[](#-usage)

### Routes

[](#routes)

```
