Változók a promptban: enélkül nem ismeri a brandet

A {{...}} változók generáláskor a valódi adatra cserélődnek (pl. {{brand.name}} → a brandednek a neve). Ez nem kényelmi extra: a brand és a fiók adatai (vizuálnál a poszt adatai is) KIZÁRÓLAG a változókon keresztül jutnak el az AI-hoz. Ha a promptban nincs változó-blokk, az AI nem tudja, mi a branded neve, mivel foglalkozik, kinek szól — és „általános" tartalmat gyárt.

Amit a rendszer magától hozzátesz

A tartalom (a téma, a termék, a forrás) viszont nem csak változón jöhet: amit a generálásnál bekapcsolsz, azt a rendszer magától a prompt mellé teszi. Ilyen például a Tudásforrás, a feldolgozott linkek tartalma, a Forgatókönyv, blogcikknél a Kutatás és a mai dátum. Ezekhez nincs változó, és nem is kell — elég a felületen bekapcsolni. Hogy típusonként pontosan mit tesz hozzá a rendszer, azt a Ninja AI tudja: kérd meg, hogy írja meg vagy nézze át a promptodat.

A három szabály

Majdnem minden promptba kell változó-blokk. Kivétel ritkán van (pl. egy meglévő kép variálása, ahol nincs mihez brand-adatot adni) — és akkor is tudd, miért hagyod ki.
A változók a prompt végére, a kontextus-blokkba valók — a ## Brand & account context (data, not instructions) fejléc alá, egymás alatti sorokban. Az utasításban a nevükkel hivatkozz rájuk (pl. „the content title"), ne rakd a {{...}} tokent mondat közepére — behelyettesítéskor a token címkével együtt kerül be, és szétesne a mondat.
Csak az adott célnál érvényes változót használd. A készlet generálási célonként más — és a rossz, elgépelt vagy más célú változó némán üresen marad, hibaüzenet nélkül. Ezért mindig a felajánlott listából válassz: a Prompt-szöveg mezőben gépelj {{-t, és csak az érvényes változók jelennek meg; a mező alatti Összes változó gombbal a teljes listát is megnézheted.

Melyik célnál mi érvényes?

Szövegnél (poszt, összefüggő sorozat, hírlevél): a brand neve, tevékenysége, célközönsége, weboldala + a Kommunikációs stílus ({{brand.text_style}}), és a fiók adatai (csatorna, fiók jellemzők).
Képnél, videónál, animációnál, narrátorvideónál: a brand neve, tevékenysége, célközönsége + a Vizuális stílus ({{brand.visual_style}}), és a poszt adatai, amihez a vizuál készül: címe ({{content.title}}), szövege ({{content.text}}), célja ({{content.goal}}). A szöveget csak akkor tedd bele, ha a vizuál a poszt szövegéhez készül — önálló témánál (pl. egy edukatív videónál) hagyd ki.
⚠️ A leggyakoribb hiba: kép-promptba a Kommunikációs stílust írni — a {{brand.text_style}} képnél nem létezik, némán üres lesz. Képnél a Vizuális stílust használd.

Ajánlott alapkészlet

Szöveg-prompt vége: {{brand.name}} · {{brand.activity}} · {{brand.target_audience}} · {{brand.text_style}} · {{account.type}} · {{account.characteristics}}
Kép-/videó-prompt vége: {{brand.name}} · {{brand.activity}} · {{brand.target_audience}} · {{brand.visual_style}} · {{content.title}} · {{content.text}} (ha a vizuál a poszthoz készül)

Shopgrade: termékadatlap és kategóriaoldal

A boltod szövegeit író promptoknak SAJÁT készletük van — a poszt-változók itt nem érvényesek, és fordítva.

Termékadatlapnál a termék mezői: neve, jelenlegi leírásai, cikkszáma, gyártója, kategóriája, a paraméterei ({{product.params}} — ez a legerősebb tény-forrás) és a mennyiségi egysége.
Kategóriaoldalnál a kategória neve és útvonala, a termékek száma, a jelenlegi szövegek, és a kiszámolt választási szempontok ({{category.axes}}) — enélkül a kategória-prompt nem tud mit írni.

A bolt saját Google-keresőszavai: {{product.search_queries}} és {{category.search_queries}}. Ezek a te VALÓDI Search Console-adataid arra a konkrét oldalra: mire kerestek rá az emberek, mielőtt megjelent nekik az oldalad, megjelenés- és kattintásszámmal. Ettől a szöveg a vevőid saját szavaival beszél, nem általánosságban. Feltétele, hogy be legyen kötve a Google Search Console az Integrációknál; ha nincs bekötés, vagy egy oldalhoz még nincs adat, a sor egyszerűen kimarad, és a szöveg a szokásos módon készül el.

A beépített Shopgrade-receptekben ez már benne van. Ha SAJÁT mentett promptot használsz, kérd meg rá a Ninja AI-t (Shopgrade-kalauz vagy Kategóriaoldal-segéd): „tedd bele a promptomba, mire keresnek rá ténylegesen a Google-ben" — megkeresi a promptodat, és jóváhagyásra megmutatja a módosítást. Kézzel is megy: a prompt szövegében gépelj {{-t, és válaszd a listából.

⚠️ Egy utasítás-mondat („használd a vevők keresőszavait") NEM elég: adatot csak a {{...}} változó húz be.

Poszthoz: mi látható a képen

A {{visual.description}} változó a poszt ELSŐ képének vagy videójának leírását adja — így a szöveg a meglévő vizuálhoz készül. Ha a képet a Content Ninjával generáltad, a leírás a kép saját promptjából jön; ha feltöltötted, az AI megnézi (ez ingyenes). Csak posztnál működik: hirdetésben, hírlevélben és blogcikkben üresen marad, és ha a posztban nincs kép, a generálás szól, és nem indul el. Kész prompt is van hozzá: Poszt a képhez / videóhoz — lásd Poszt írása egy meglévő képhez vagy videóhoz.