AdMonitoring — Deklarace

out/ - je adresář pro výstupy (logy, XML, stavové soubory, nahrané CSV). Ujistěte se, že má práva pro zápis webovým serverem (např. chmod 0777 pro testování).

Batch size:
Udává, kolik Flight ID se zpracuje v jedné dávce. V každé dávce aplikace: odešle publishPlan pro všechny plány v dávce (pokud není zapnuté Perf only), hned nato odešle publishPerformance jen pro tyto stejné Flight ID. Prakticky: větší batch = méně volání (rychlejší), ale větší payloady; menší batch = opatrnější provoz (nižší riziko timeoutů). Výchozí je 50.

Perf scope
Určuje, pro které flighty se vezmou výkony (performance): filtered (default) Pošle výkony pro všechny flighty, které prošly filtrem (např. --flight-prefix), bez ohledu na to, jestli se jejich plán v tom běhu posílá (třeba už byl poslaný dřív). plans Omezí výkony jen na flighty, které jsou součástí aktuální sady plánů v běhu (po zohlednění max-plans, stavu atd.). Hodí se, když chcete mít v běhu striktně „Plan → Performance“ jen pro stejné položky. Pozn.: V obou případech platí, že ve stavovém režimu (state) se u výkonů posílají jen nové dny (už odeslané datumy se přeskočí). V režimu Perf only se plány neodesílají, ale perf scope stále řídí, pro které flighty se výkony zahrnou.

Include PRG
Kromě modelu CPT přidá do XML i se stejnou cenou. Hodí se, pokud chcete nabízet oba nákupní modely současně.

Valid from (ISO, např. 2025-09-01+02:00)
Hodnota jde do a také do každé pozice position/validity/dateFrom. Musí být v ISO formátu s offsetem (+01:00, +02:00 apod.). Když pole necháte prázdné, dosadí se dnešní datum s offsetem serveru.

Description column (default: Product Description)
Ze zvoleného sloupce vytahujeme: placement (např. nahoře/nahore, dole, vlevo, vpravo, střed/stred) → … velikosti WxH (např. 2000x393, 300 × 250) → s páry lowerBound/upperBound token pro sekci média medium|{název}|{sekce} → {sekce} se vloží do (název média u nás bere Product Name) token pro formát %%format|{název} → jde do

URL masks (comma separated)
Čárkou oddělený seznam, který se vloží do …. Když necháte prázdné, blok urlmasks se negeneruje. (Pozn.: v backendu převádíme tento vstup na pole; proto už přímo funguje i ve web UI.) Společné (platí pro Pricelist i Plans/Performance)

Save XML
Uloží odeslané požadavky (a odpovědi) do out/ – tedy log request/response. Publikace běží normálně.

Save XML only
Nevyvolá žádné volání na API. Jen vygeneruje a uloží XML do out/. (V kódu to odpovídá exportOnly = true ⇒ dry-run + save-xml.)

Dry run
Provede načtení CSV, generování XML a logiku dávkování, ale nic nepublikuje. S Save XML ho můžete použít pro „co by se odeslalo“.


No state
Nepoužije a neuloží state.json. Vše se bere, jako by se posílalo poprvé (tj. žádná deduplikace už poslaných plánů či dnů výkonu).

Reset state
Před během smaže/ignoruje současný stav a začne nanovo (vhodné, když chcete znovu poslat plány nebo dny výkonu). Pozor: Po resetu a bez dalších filtrů se může poslat hodně dat.

mode dev