PHPackages furic/house-ads - 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. furic/house-ads ActiveLibrary furic/house-ads =============== RESTful API serving the house ads to your client app. 1.0.4(4y ago)411MITPHPPHP ^7.2CI passing Since Nov 2Pushed 1y ago1 watchersCompare [ Source](https://github.com/furic/laravel-house-ads)[ Packagist](https://packagist.org/packages/furic/house-ads)[ Docs](https://github.com/furic/laravel-house-ads)[ Fund](https://paypal.me/furic)[ GitHub Sponsors](https://github.com/furic)[ RSS](/packages/furic-house-ads/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (2)Versions (7)Used By (0) laravel-house-ads ================= [](#laravel-house-ads) [![Packagist](https://camo.githubusercontent.com/7eb12257734a238b066184a745bf5e178b8f0d766d14ee6cfc52a771018d40a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66757269632f686f7573652d616473)](https://packagist.org/packages/furic/house-ads)[![Packagist](https://camo.githubusercontent.com/944896752db572a1712fa4d83884a1ba3b9d9ae03da47a557c09a80d135aa02a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66757269632f686f7573652d616473)](https://packagist.org/packages/furic/house-ads)[![License](https://camo.githubusercontent.com/9cb1f989d01919125e2bec043c93650bf1ef4564562569362722fcb6d6043f34/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66757269632f6c61726176656c2d686f7573652d616473)](https://packagist.org/packages/furic/house-ads)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/f49fa76b9a1c710274f11dafeeb4d3552bc762eafcf2dff9a6d6d314d04c42d5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66757269632f6c61726176656c2d686f7573652d6164732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/furic/laravel-house-ads/?branch=main)[![Build Status](https://camo.githubusercontent.com/74bf8bcf8b27124b326e92339398b4389825c4d4ae2ff770e91739a623bdb821/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f66757269632f6c61726176656c2d686f7573652d6164732f6261646765732f6275696c642e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/furic/laravel-house-ads/build-status/main) > A simple house ads / cross-promo API package for [Laravel 5.\*](https://laravel.com/). > Developed from the internal house ads system at [Sweaty Chair Studio](https://www.sweatychair.com), this package serves interstitial images or videos to users, enabling cross-promotion or event ads within apps. > This package includes an API to fetch ads, and a (coming soon) web console to create and manage them. The system is designed for plug-and-play use — whether you're showing ads on app launch or embedding them into your UI. > Ads are served to the client, which can decide how and when to show them — e.g., show one ad on each launch or all sequentially. Click tracking and analytics support included. [![Interstitial popup example - Sweaty Chair](https://camo.githubusercontent.com/8a30a56f582850ef4690556f9ce95d85bc3e87e4ca1547f9232081a6bd089c66/68747470733a2f2f69302e77702e636f6d2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f696e2d686f7573652d61642d696e2d696e7465727374697469616c2d706f7075702d73776561747963686169722e6a7067)](https://camo.githubusercontent.com/8a30a56f582850ef4690556f9ce95d85bc3e87e4ca1547f9232081a6bd089c66/68747470733a2f2f69302e77702e636f6d2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f696e2d686f7573652d61642d696e2d696e7465727374697469616c2d706f7075702d73776561747963686169722e6a7067)[![UI box video ad example - Voodoo](https://camo.githubusercontent.com/ef0d1ff1e222feb7754206d918ded07b6493f08921800125a4c65c5e6494cb0c/68747470733a2f2f69322e77702e636f6d2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f696e2d686f7573652d61642d696e2d75692d626f782d766f6f646f6f2e6a7067)](https://camo.githubusercontent.com/ef0d1ff1e222feb7754206d918ded07b6493f08921800125a4c65c5e6494cb0c/68747470733a2f2f69322e77702e636f6d2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f696e2d686f7573652d61642d696e2d75692d626f782d766f6f646f6f2e6a7067) > Currently, ads must be added manually to the database. > A full walkthrough is available [here](https://www.richardfu.net/develop-house-ads-api-with-laravel-for-mobile-app-game). --- Table of Contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [House Ads Table](#house-ads-table) - [API URLs](#api-urls) - [Unity Client Repo](#unity-client-repo) - [TODO](#todo) - [License](#license) --- Installation ------------ [](#installation) Install via Composer: ``` composer require furic/house-ads ``` If you're using Laravel 5.5 or later, that's all. Otherwise, manually register the provider in `config/app.php`: ``` 'providers' => [ // ... Furic\HouseAds\HouseAdsServiceProvider::class, ], ``` --- Configuration ------------- [](#configuration) Run migrations to create the necessary database table: ``` php artisan migrate ``` --- Usage ----- [](#usage) ### House Ads Table [](#house-ads-table) Column NameTypeRequiredDescriptionidinteger✓Auto-incremented IDgame\_idinteger✓Game ID the ad promotesmedia\_portraitvarcharPortrait image/video filenamemedia\_landscapevarcharLandscape image/video filenameopen\_urltinyint✓Whether the ad opens a URLurl\_iosvarchariOS redirect URLurl\_androidvarcharAndroid redirect URLrepeat\_counttinyint✓How many launches to wait before repeatprioritytinyint✓Priority value for sortingstart\_atdate✓Ad start dateend\_atdate✓Ad end dateconfirmed\_countmediumint✓Clicked countcancelled\_countmediumint✓Cancelled (failed) attemptscreated\_atdatetimeTimestampupdated\_atdatetimeTimestamp> Media files should be stored in the `/media` folder under your Laravel root. ### API URLs [](#api-urls) - **GET** `/api/house-ads` Returns all currently valid house ads as a JSON array. - **GET** `/api/house-ads/{id}` Returns a specific house ad entry (for debugging). - **PUT** `/api/house-ads/{id}` Updates a house ad's view/click/cancel count. Postman API documentation: [View here](https://documenter.getpostman.com/view/2560814/TVmV6tm8#01c3056b-47d9-44d2-ac7e-e0b84a1799c0) ### Unity Client Repo [](#unity-client-repo) > A Unity integration repo is coming soon. Stay tuned! --- TODO ---- [](#todo) - Build web console to create/edit ads and upload media - Add admin authentication for the web console - Add test coverage and factories --- License ------- [](#license) This package is open-sourced under the [MIT License](https://github.com/furic/laravel-house-ads/blob/main/LICENSE). ### Health Score 29 — LowBetter than 59% of packages Maintenance36 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~53 days Recently: every ~65 days Total 6 Last Release 1753d ago Major Versions 0.1.0 → 1.0.02020-11-08 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/44884321?v=4)[Richard Fu](/maintainers/furic)[@furic](https://github.com/furic) --- Top Contributors [![furic](https://avatars.githubusercontent.com/u/44884321?v=4)](https://github.com/furic "furic (19 commits)") --- Tags phplaravelhouse adsin-house adscross promo ### Embed Badge ![Health badge](/badges/furic-house-ads/health.svg) ``` [![Health](https://phpackages.com/badges/furic-house-ads/health.svg)](https://phpackages.com/packages/furic-house-ads) ``` ### Alternatives [laracraft-tech/laravel-xhprof Easy XHProf setup to profile your laravel application! 235321.4k](/packages/laracraft-tech-laravel-xhprof)[mozex/anthropic-laravel Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API 71226.4k1](/packages/mozex-anthropic-laravel)[kompo/kompo Laravel & Vue.js FullStack Components for Rapid Application Development 11812.4k21](/packages/kompo-kompo)[bavix/laravel-xhprof Quick profiling of your code for Laravel 22156.6k](/packages/bavix-laravel-xhprof) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)