Download the PHP package lazyexe/openads without Composer
On this page you can find all versions of the php package lazyexe/openads. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package openads
OpenAds ID
Lightweight & 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
- đ Search Ads (keyword-based)
- đŧī¸ Image & đĨ Video Ads (URL / local / CDN)
- đ¯ Campaign â Ad Group â Ads â Keywords â Assets
- â° Display based on time (start_time & end_time, default 24 hours)
- đ Target locations: country / city (multi, default all)
- đą Target devices: android / ios / desktop (multi, default all)
- đ Auction & ranking (bid à quality score)
- đ Automatic impression & click tracking
- đ° Click cost = bid, view cost = bid à 20% (configurable)
- đ CTR, relevance, landing score & campaign balance calculated automatically
đĻ Installation
Or Manual / Local Development
Publish config & migrations:
đ Usage
Routes
HomeController
AdsClickController
index.blade
đ§ API Reference
| Method | Description | Return | |
|---|---|---|---|
Ads::search(string $query) |
Retrieve ads by keyword query, automatically logs impressions & charges views | AdCollection |
|
AdCollection->all() |
Get all ads | array of AdDTO |
|
AdCollection->limit(int $n) |
Get top n ads by score | AdCollection |
|
Ads::logClick(int $adId) |
Log click & charge campaign according to bid | string | null (landing URL) |
âī¸ Configuration
config/ads.php
đĄ Notes
- Ads only display if campaign & ad group are active, budget > 0, and within date range (start_date & end_date).
- CTR, relevance, and landing score are calculated automatically from impressions & clicks when a query runs.
- All costs and performance updates occur immediately at query time, keeping data dynamic and accurate.
đī¸ Database Structure
Main Tables
| Table | Purpose |
|---|---|
ads_campaigns |
Store campaigns & budgets |
ads_ad_groups |
Group keywords & ads |
ads_ads |
Ad unit (text / image / video) |
ads_keywords |
Keyword targeting |
ads_assets |
Ad assets (image / video) |
ads_impressions |
Ad impression log |
ads_clicks |
Ad click log |
Campaign
| Field | Description |
|---|---|
name |
Campaign name |
daily_budget |
Daily budget |
status |
active / paused |
start_date |
Campaign start date |
end_date |
Campaign end date |
start_time |
Start time (nullable = runs 24 hours) |
end_time |
End time (nullable = runs 24 hours) |
target_locations |
JSON: target countries/cities, null = all locations |
target_devices |
JSON: target devices (android/ios/desktop), null = all devices |
Ad Group
| Field | Description |
|---|---|
campaign_id |
Related campaign |
name |
Ad group name |
default_bid |
Default bid |
status |
active / paused |
Ads
| Field | Description |
|---|---|
ad_group_id |
Related ad group |
title |
Ad title |
url |
Landing page URL |
bid |
Bid price |
ctr |
Click-through rate |
relevance |
Relevance score |
landing_score |
Landing score |
status |
active / paused |
âšī¸ Ads can be text-only or include image / video assets.
Keywords
| Field | Description |
|---|---|
ad_group_id |
Related ad group |
keyword |
Target keyword |
match_type |
exact / phrase / broad |
negative |
Exclude keyword |
Assets (Image / Video)
| Field | Description |
|---|---|
ad_id |
Related ad |
type |
image / video |
source |
URL or local path |
is_primary |
Primary asset |
Source can be:
- CDN / external URL
- Local upload (
storage/ads/...) - S3 / object storage
All versions of openads with dependencies
PHP Build Version
Package Version
The package lazyexe/openads contains the following files
Loading the files please wait ...