Quick start

use RoundlyConsulting\Advertisements\DataTransferObjects\AdvertisementData;
use RoundlyConsulting\Advertisements\DataTransferObjects\ImpressionData;
use RoundlyConsulting\Advertisements\Facades\Advertisements;
use RoundlyConsulting\Advertisements\Models\Placement;

// 1. A zone to serve ads in (once — e.g. in a seeder)
Placement::query()->create([
    'name' => ['en' => 'Sidebar'],
    'slug' => 'sidebar',
    'width' => 300,
    'height' => 250,
]);

// 2. Create, place and publish an ad
$ad = Advertisements::create(AdvertisementData::fromDecimal(
    name: 'Vintage road bike',
    amount: '250.00',                 // in default_currency (EUR)
    author: $user,                    // any Eloquent model (polymorphic author)
));

Advertisements::for($ad)->placements()->attach(['sidebar']);
Advertisements::publish($ad);         // → AdvertisementPublished

// 3. Serve it: one random active ad for the zone, rendered and counted
$ad = Advertisements::random('sidebar');

if ($ad !== null) {
    echo $ad->renderCreative('sidebar');   // <img> creative, or the text-ad fallback

    Advertisements::for($ad)->track('sidebar')->impression(new ImpressionData(ip: request()->ip()));
}