City Ads

The city ads system displays advertisements within real estate listings on city pages, mixed organically with search results.

File Naming

Create a JSON file named after the city slug in site/ads/:

garopaba.json — Ads for Garopaba city page
rio-de-janeiro.json — Ads for Rio de Janeiro city page
sao-paulo.json — Ads for São Paulo city page

Ad Format

Each JSON file contains an array of ad objects:

[
  {
    "title": "Ad Title",
    "link": "https://example.com",
    "snippet": "Ad description text",
    "featured": true,
    "adType": "premium",
    "imageUrl": "/static/images/ad-image.webp",
    "phone": "5548999999999",
    "buttonText": "Ver Mais",
    "position": 2,
    "background": "#f0f9ff",
    "borderColor": "#3b82f6"
  }
]

Field Descriptions

Field	Type	Description
`title`	string	Required. The ad headline
`link`	string	Required. URL to redirect when clicked
`snippet`	string	Required. Description text
`featured`	boolean	Show “DESTAQUE” badge with orange styling
`adType`	string	Visual style: `premium`, `featured`, or `standard`
`imageUrl`	string	Optional image URL
`phone`	string	Optional WhatsApp number (with country code)
`buttonText`	string	Custom CTA button text
`position`	number	Fixed position in list (1-based). 0 = random
`background`	string	Custom background color (hex)
`borderColor`	string	Custom border color (hex)

Ad Types

Premium

Purple gradient border
Enhanced shadow
Hover lift effect

Featured

Orange border
Good visibility

Standard

Subtle gray styling
Blends naturally

Tips

Limit ad count: 2-3 ads per city page
Use images: Ads with images get more clicks
WhatsApp button: Enables direct contact
Position strategically: Position 1 gets most visibility