--- title: "Advertisements for Laravel — dokumentácia | Roundly" description: "Dokumentácia Advertisements for Laravel: životný cyklus reklám, presné ceny, umiestnenia, meranie zobrazení a klikov, kreatívy a geografické cielenie." url: https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Advertisements for Laravel Inštalácia `composer require roundly-consulting/advertisements-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/advertisements-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/advertisements-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Natívny reklamný engine pre Laravel. Obsahuje model Advertisement so životným cyklom koncept → naplánovaná → zverejnená → expirovaná → archivovaná, vnorené kategórie a umiestnenia (reklamné zóny), názvy pre každý jazyk a meranie zobrazení a klikov s mierou prekliku — zapisované priamo alebo cez frontu. Zvyšok dodávajú štyri sesterské balíky Roundly: obrázkové kreatívy pre každé umiestnenie so záložnou textovou reklamou, geografické cielenie a reporty podľa krajín, slugy pre každý jazyk s históriou a presmerovaniami 301 a presné ceny Money. Licencia MIT a žiadne externé závislosti okrem Laravelu a vlastných balíkov Roundly. ### Čo získate #### Celý životný cyklus reklamy Koncept, naplánovanie, zverejnenie, expirácia a archivácia jedným volaním — každý prechod spustí udalosť a stav sa pri každom čítaní prepočíta z dátumov. #### Umiestnenia a servírovanie Modelujte reklamné zóny, priraďujte reklamy cez model, id alebo slug a získajte aktívnu či náhodnú reklamu pre zónu jedným volaním. #### Meranie zobrazení a klikov Denormalizované počítadlá a miera prekliku, kontext požiadavky v každom zázname, zápis priamo alebo cez frontu. #### Kreatívy so záložnou textovou reklamou Responzívny obrázok v rozmeroch každého umiestnenia; ak chýba, vykreslí sa upraviteľná textová reklama, takže žiadny slot nezostane prázdny. #### Geografické cielenie a reporty Povoľte alebo zablokujte krajiny, cieľte na okruh okolo bodu a rozdeľte zobrazenia a kliky podľa krajín. #### Presné ceny v Money Money v najmenších jednotkách meny v stĺpci decimal(38,0) — žiadne floaty, zápisy chránené pred miešaním mien a číselné radenie. #### Fasáda, DI alebo akcie Jedna fasáda Advertisements, injektovateľný manažér a jednoúčelové akcie — plus zaznamenávajúci fake s asertom pre každú operáciu. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/instalacia.md) Inštalácia cez Composer, publikovanie a spustenie migrácií (plus vždy media-library a pre históriu slugov aj sluggable), voliteľne konfigurácia a view. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/konfiguracia.md) Každý konfiguračný kľúč s predvolenou hodnotou a env premennou — modely, typ kľúča autora, mena, jazyk, história slugov, meranie, kreatívy a geo. #### [Rýchly štart](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/rychly-start.md) Vytvorte reklamu, priraďte ju k umiestneniu, zverejnite ju a potom ju servírujte, vykreslite a merajte — celý postup cez fasádu Advertisements. #### [Fasáda Advertisements](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/fasada.md) Celé API na jednej fasáde — prechody životného cyklu, servírovanie, vykreslenie a handle for($ad) pre umiestnenia a meranie. #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/bez-fasady.md) Injektujte AdvertisementManager s rovnakým API bez statických volaní alebo volajte jednoúčelovú akciu za každou metódou fasády. #### [Vytváranie a úprava reklám](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/vytvaranie-reklam.md) Vytvárajte reklamy z DTO AdvertisementData alebo presných tovární fromMinor() / fromDecimal(), priamo z požiadaviek, a upravujte len zadané polia. #### [Životný cyklus a stav](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/zivotny-cyklus.md) Zverejnenie hneď či naplánované, stiahnutie, expirácia, archivácia a soft delete — každý prechod spustí udalosť a stav sa prepočíta pri čítaní. #### [Dopytové scopy](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/dopytove-scopy.md) Reťazte scopy published, active, scheduled, expired, draft, archived, autora, umiestnenia, kategórie a geo — alebo začnite z fasády. #### [Ceny](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/ceny.md) Ceny sú presné hodnoty Money v stĺpci decimal(38,0) v najmenších jednotkách — žiadne floaty, bezpečné zápisy mien, číselné radenie a API resources. #### [Umiestnenia](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/umiestnenia.md) Modelujte reklamné zóny ako bočný panel či slot vo feede, priraďujte reklamy cez model, id alebo slug a získajte aktívnu či náhodnú reklamu. #### [Meranie zobrazení a klikov](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/zobrazenia-a-kliky.md) Zaznamenávajte zobrazenia a kliky živých reklám priamo alebo cez frontu, s transakčnými počítadlami, CTR, kontextom a reportmi podľa krajín. #### [Kreatívy](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/kreativy.md) Priraďte obrázkovú kreatívu ku každému umiestneniu, získajte variant display v rozmeroch zóny a vykreslite responzívny alebo textovú reklamu. #### [Geografické cielenie](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/geograficke-cielenie.md) Obmedzte reklamy na povolené či zablokované krajiny alebo okruh okolo bodu a každému divákovi servírujte len reklamy zodpovedajúce jeho polohe. #### [Preklady](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/preklady.md) Názov, popis a slug sú JSON mapy podľa jazykov s čítaním v aktívnom jazyku, nastaviteľným záložným jazykom a bez externej závislosti. #### [Kategórie](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/kategorie.md) Usporiadajte reklamy do stromu vnorených kategórií a filtrujte podľa jednej kategórie samostatne alebo spolu so všetkými vnorenými. #### [Slugy a routovanie](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/slugy-a-routovanie.md) Slugy reklám pre každý jazyk s jedinečnosťou vynútenou databázou, route binding v akomkoľvek jazyku, voliteľné 301 zo starých slugov a validácia. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/udalosti.md) Každé vytvorenie, úprava a prechod životného cyklu spustí udalosť s reklamou; zobrazenia a kliky spustia udalosť so záznamom merania. #### [Vlastné modely](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/vlastne-modely.md) Nasmerujte štyri konfiguračné kľúče modelov na vlastné podtriedy a pridajte polia či logiku so zachovaním všetkých scopov, relácií a castov. #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/prikazy.md) Prerezávajte expirované reklamy cez model:prune, skontrolujte nastavenie cez about a pridajte indexy slugov pre jazyk cez sluggable:indexes. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/testovanie.md) Advertisements::fake() zaznamená každý prechod, zmenu umiestnení aj meranie s assertom pre každé, plus továrne a simulácia geolokácie. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/vynimky.md) Základná výnimka balíka, InvalidTargeting, AdvertisementNotActive a AdvertisementNotInPlacement, plus výnimky z balíkov money, sluggable a toolkit. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/advertisements-for-laravel/poziadavky.md) PHP 8.4+ s ext-bcmath, Laravel 12 alebo 13 a šesť balíkov Roundly, ktoré nainštaluje Composer; gd alebo imagick pre varianty kreatív. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)