© 2026 Performax · v1.0
Sticky
Vyjížděcí a overlay reklamy mimo layout stránky
Implementace
<script async src="https://cdn.performax.cz/yi/adsbypx/px_autoads.js?aab=ulite"></script>Různé technologie
Co dodá Performax:
- všechny požadované reklamní formáty
- požadované velikosti
- logiku zobrazování reklamy
Display pozice
Statické bannery přímo v layoutu webu
Typické formáty
Implementace
Co dodá Performax:
- Všechny reklamní tagy pro požadované reklamní pozice
- Požadované velikosti reklamních bannerů
- Logiku zobrazování reklamy pro danou pozici
import { useEffect, useRef } from 'react';
interface PXAdSlotProps {
slotId: number;
className?: string;
dataSmart?: boolean;
dataTheme?: 'dark' | 'light';
dataLabel?: boolean;
dataHeight?: number;
}
// TypeScript typy pro window.px2 (volitelné, pouze pro TypeScript projekty)
declare global {
interface Window {
px2?: {
conf: Record<string, any>;
queue: Array<() => void>;
render?: (options: { slot: { id: number }; elem: string }) => void;
};
}
}
export const PXAdSlot = ({
slotId,
className,
dataSmart,
dataTheme,
dataLabel,
dataHeight
}: PXAdSlotProps) => {
const elemId = useRef(`PX_${slotId}_${Date.now()}`);
useEffect(() => {
if (!document.querySelector('script[src*="flexo.js"]')) {
const script = document.createElement('script');
script.src = 'https://cdn.performax.cz/px2/flexo.js?1';
script.async = true;
document.head.appendChild(script);
}
if (!window.px2) {
window.px2 = { conf: {}, queue: [] };
}
window.px2.queue.push(() => {
window.px2?.render?.({ slot: { id: slotId }, elem: elemId.current });
});
}, [slotId]);
const dataAttributes: Record<string, string> = {};
if (dataSmart !== undefined) {
dataAttributes['data-smart'] = dataSmart.toString();
}
if (dataTheme) {
dataAttributes['data-theme'] = dataTheme;
}
if (dataLabel !== undefined) {
dataAttributes['data-label'] = dataLabel.toString();
}
if (dataHeight !== undefined) {
dataAttributes['data-height'] = dataHeight.toString();
}
return (
<div
id={elemId.current}
className={className}
{...dataAttributes}
/>
);
};
<PXAdSlot slotId={23039} className="h-[250px] w-full" />Příkladný placeholder pro mobilní pozice
Pro pokročilejší případy, kdy potřebujete přesnější kontrolu nad zobrazením placeholderu (např. full-width reklamy přes celou šířku obrazovky), můžete použít tento vylepšený příklad s CSS styly.
// CSS styly (přidejte do vašeho globálního CSS souboru nebo CSS modulu)
// .px-wrap {
// height: 400px;
// clip-path: inset(0);
// width: 100dvw;
// position: relative;
// margin-left: calc(50% - 50dvw);
// margin-right: calc(50% - 50dvw);
// }
<PXAdSlot
slotId={23039}
className="px-wrap"
dataSmart={true}
dataTheme="dark"
dataLabel={false}
/>Data atributy pro ovládání reklamy
Pomocí data atributů můžete ovládat chování a vzhled reklamní pozice. Tyto atributy lze přidat jako props do PXAdSlot komponenty.
data-heightMaximální výška dostupného prostoru. ⚠️ Pozor: může kazit CLS, nedoporučuje se používat. Doporučujeme výšku placeholderu definovat ještě před výdejem reklamy pomocí CSS height. Hodnoty: číslo v pixelech (např. 600).
data-smartZapíná full-width zobrazení reklamy přes celou šířku viewportu (100dvw) s automatickým centrováním. Pokud je nastaveno na "true", umožňuje také použití atributů data-theme a data-label pro další úpravy vzhledu. Hodnoty: true / false.
data-themeMění barvu pozadí a textu labelu reklamy. Funguje pouze v kombinaci s data-smart="true". Hodnoty: dark (černé pozadí, bílý text) / light (výchozí světlý vzhled - bílé pozadí, černý text).
data-labelZapíná nebo vypíná zobrazení labelu "reklama" v horní části reklamní pozice. Funguje pouze v kombinaci s data-smart="true". Pokud je zapnutý, přidá se padding-top pro odsazení obsahu pod label. Hodnoty: true (zobrazí label) / false (label se nezobrazí).
Branding
Celostránkový formát pro desktop
Základní informace
- • Zařízení: Desktop
- • Typ výdeje: Standardní (ihned po zavolání zobrazovacího skriptu)
Rozměry
Vlastnosti
- • Formát Branding se vydává ze stejné pozice na webu jako formát Leaderboard
- • Formát Branding se vydává pouze pokud je šířka viewportu větší nebo rovna 1366px
- • Formát Branding je fixně pozicován k hornímu okraji obrazovky - boční části s reklamním sdělením jsou vidět i při scrollování
Dva implementační modely
Implementační modely
1. Umístění formátu za obsah zajišťuje Publisher
Vydavatel vytvoří na webu globální funkci, která se jmenuje __placePXBranding a která zajišťuje správné umístění formátu. Tu pak Performax volá v případě, že mu z aukce pro danou pozici vypadne brandingový formát.
// Publisher vytvoří globální funkci __placePXBranding
// Performax ji zavolá, když branding formát vyhraje aukci pro danou pozici
window.__placePXBranding = function() {
// Vlastní implementace — jiná pro každý web
};Preferujeme tento model, protože dává vydavateli plnou kontrolu nad umístěním brandingu a zároveň je jednodušší na implementaci.
2. Umístění formátu za obsah zajišťuje Performax
Aby Performax byl schopný formát správně umisťovat, je nutné, aby web splňoval technické specifikace Performaxu na layout webu (šířka webu, umístění leaderboardové pozice nad hlavní obsah a dodržování class u klíčových elementů). Současně v hlavičce stránky musí načítat následující skript a CSS:
// Layout.tsx - hlavní layout komponenta
import { PXAdSlot } from './PXAdSlot';
import Script from 'next/script';
export const Layout = ({ children }) => {
return (
<>
{/* Načíst AutoAds v hlavičce */}
<Script
src="https://cdn.performax.cz/yi/adsbypx/px_autoads.js"
strategy="afterInteractive"
/>
<link
rel="stylesheet"
href="https://cdn.performax.cz/yi/adsbypx/px_autoads.css"
/>
{/* Leaderboard/Branding pozice - MUSÍ mít tyto třídy */}
{/* Element musí být v DOMu umístěn nad hlavním obsahem */}
<div className="px-ads px-ads-leaderboard min-h-[210px]">
<PXAdSlot slotId={XXXXX} />
</div>
{/* Hlavní obsah - MUSÍ být obalen touto třídou */}
{/* Hlavní obsah musí mít šířku v požadovaném rozmezí */}
<main className="px-main-content">
{children}
</main>
</>
);
};Požadavky na vydavatele:
- Celý hlavní obsah musí být obalen elementem s class="px-main-content"
- Hlavní obsah musí mít šířku v požadovaném rozmezí
- Div element, ve kterém se volá reklamní pozice Leaderboard / Branding je v DOMu umístěn nad hlavním obsahem a má atribut class="px-ads px-ads-leaderboard"
- Element s class="px-ads px-ads-leaderboard" musí také splňovat podmínku minimálně výšky 210px (ideálně 250px)
Kdy zvolit tento model?
Model 2 je vhodný pokud nemáte možnost implementovat vlastní funkci __placePXBranding nebo pokud váš web již splňuje technické specifikace Performaxu na layout (správné CSS třídy a struktura DOMu).