Termékforrások | Yaplet HU

A források táblázata

A Márka → (a márkád) → Termékek → Források oldal minden katalógust felsorol, ami ezt a márkát táplálja.

Oszlop	Mit mutat
Név	A forrás neve, alatta a címe. Egy csak küldésre használt API forrás helyette a saját küldési címét mutatja.
Típus	CSV folyam vagy Termék API.
Állapot	Lásd a jelvényeket lentebb.
Frissítés	„Naponta", „3 naponta", „Csak küldés" vagy „3 hiba után leállt".
Utolsó sikeres letöltés vagy küldés	Az utolsó sikeres beolvasás dátuma. Egy csak küldésre használt forrásnál „Soha" helyett a „Küldve: …" felirat áll azzal a dátummal, amikor a webshopod utoljára küldött változásokat.
Termékek	Hány alapterméket tart jelenleg ez a forrás. A változatok itt nem számítanak bele.

Állapotjelvények

Jelvény	Jelentés
PENDING	Létrehoztad, de még semmit nem olvastunk be belőle. Egy csak küldésre használt forrás akkor lép ki ebből az állapotból, amint a webshopod első küldése sikerrel jár.
PROCESSING	Épp fut egy beolvasás vagy egy küldés.
ACTIVE	A legutóbbi beolvasás sikerült.
WARNING	A legutóbbi próbálkozás nem sikerült. Óránként újrapróbáljuk.
INACTIVE	Három egymás utáni hiba után leállt.

Vidd az egeret a jelvény melletti információs ikonra a közérthető magyarázatért, benne a nyers hibaüzenettel, ha van.

Amíg bármi PROCESSING állapotban van, a táblázat pár másodpercenként magától frissül — nyomj Beolvasás most gombot, és az oldal újratöltése nélkül végignézheted, ahogy a sor befejeződik.

Forrás hozzáadása

Nyomd meg a Forrás hozzáadása gombot. Az első választás a forrás típusa, és ez az egyetlen, amit később nem tudsz módosítani.

Minden forrás mezői

Név

kötelező

Ahogy ezt a forrást hívod. Legfeljebb 200 karakter.

Cím

kötelező

Ahonnan a termékeidet beolvassuk. Egy Termék API címének https://-sel kell kezdődnie; egy CSV folyam sima http-t is használhat. Ha egy Termék API forrásnál üresen hagyod, a forrás csak küldésre fog működni: az ütemezés kapcsolója magától kikapcsol, és nem is lehet bekapcsolni, nem indul első beolvasás, a forrás pedig egyszerűen megvárja, amíg a webshopod küld neki termékeket.

Beolvasás … naponta

1 és 30 között. Alapértelmezés: naponta.

Ha a forrás tartósan hibázik

Mi történjen a termékeiddel, ha a beolvasás leállt. Lásd lentebb.

Olvasd be azonnal

Alapból bekapcsolva. Mentés után rögtön elindítja az első beolvasást.

További mezők Termék API forrásnál

Megosztott titok

16 és 256 karakter között. Hagyd üresen, és generálunk egyet. Minden beolvasásnál elküldjük ennek a titoknak a SHA-256 lenyomatát egy Signature fejlécben, így a webshopod ellenőrizni tudja, hogy a kérés tényleg a Yaplettől jött. Maga a titok soha nem utazik.

További fejlécek

Legfeljebb 20 név/érték pár, amit minden beolvasással elküldünk — például egy API token, amit a webshopod elvár. A Signature, a Host és a Content-Length nem írható felül.

Mezők, amikből kulcs lesz

Azok a termékmezők, amelyek értékeiből a termék kulcsai lesznek — például egy összetevő mező. Lásd lentebb.

Ütemezett beolvasás

Állítsd Csak küldés állásba, és soha nem olvasunk be magunktól; helyette a webshopod küldi el a változásokat.

Mezők, amikből kulcs lesz

Ez az a beállítás, ami összeköti a katalógusodat a termékszabályaiddal.

Egy szabály akkor vonatkozik egy termékre, ha közös kulcsuk van. Egy termék két helyről kap kulcsokat: a rule_keys listából, amit a webshopod küld vele, és azoknak a termékmezőknek az értékeiből, amiket itt megnevezel.

Tehát ha a webshopod küld egy Összetevők mezőt, és felveszed ide az Összetevők-et, akkor minden összetevőből kulcs lesz azon a terméken — és minden szabály, ami az adott összetevő nevét hordozza, automatikusan vonatkozni fog rá.

Miután egy forrás egyszer lefutott, az űrlap egy sor címkét mutat minden mezőnévvel, amit a webshopod ténylegesen küldött. Kattints egyre a használatához, kattints rá újra az eltávolításához — nem kell gépelni, és nem kell a helyesíráson gondolkodni.

Ennek a beállításnak a módosítása azonnal újraszámolja a forrás minden termékének kulcsait. Nem kell frissítésre várni, és semmit nem olvasunk be újra.

Ha a forrás tartósan hibázik

Ez a választás csak akkor lép életbe, ha a beolvasás három egymás utáni hiba után leállt.

Szolgáld ki a legutóbb beolvasott termékeket

alapértelmezett

Az AI-od továbbra is azt ajánlja, amit már ismer — ami közben elavulhatott.

Rejtsd el a termékeket, amíg újra nem működik

A termékek eltűnnek az AI-od elől és a termékkártyákról, és a következő sikeres beolvasáskor vagy küldéskor visszatérnek.

Azokat a termékeket, amiket kézzel kapcsoltál ki, ez soha nem kapcsolja vissza.

Mi történik, ha egy beolvasás hibázik

Egy beolvasáson belül háromszor próbálkozunk — 30 másodpercenként, 5, majd 15 másodperc várakozással —, de csak akkor, ha a hiba átmenetinek tűnik (időtúllépés, hálózati hiba vagy szerverhiba a te oldaladon). Egy „nem található" vagy „tiltott" típusú elutasítás azonnal hibára fut.

Utána:

	Mi történik
1. és 2. hiba egymás után	WARNING állapot. Óránként újrapróbáljuk. Senkit nem értesítünk.
3. hiba egymás után	INACTIVE állapot. Az ütemezett beolvasás leáll. A szervezeted tulajdonosa értesítést és e-mailt kap.

Az a beolvasás, ami egyetlen terméket sem hoz vissza, hibának számít, nem annak, hogy „törölj mindent". Egy elromlott forrás soha nem ürítheti ki észrevétlenül a katalógusodat.

Két dolog szándékosan nem számít hibapontnak: a Beolvasás most, amit te indítottál (csak WARNING lesz belőle, és senki nem kap e-mailt), és a webshopod sikertelen küldése (ez csak a futásjelentésben jelenik meg).

Az e-mail, amit kapsz

Szervezetenként óránként egy e-mail, akárhány forrásról is van szó — nem tud zaklatni. Leírja, mi történt, miért, hogyan javítsd, és mi lesz, ha nem csinálsz semmit, egy gombbal egyenesen erre az oldalra.

Egy sikeres küldés nem indítja újra a leállt ütemezést. Ha egy forrás INACTIVE lett, csak a Beolvasás most indítja el újra a beolvasást.

Beolvasás most

A körkörös nyíl gomb azonnal, a háttérben beolvassa a forrást.

Forrásonként ötperces várakozási idő van. Ezen belül a gomb megmondja, mennyi van hátra.
Ez az a gomb is, amivel újraindítasz egy leállt forrást: egy sikeres kézi beolvasás nullázza a hibapontokat, ACTIVE állapotba állítja a forrást, és visszahozza az elrejtett termékeket.

A legutóbbi futás jelentése

A diagram ikon megnyitja a legutóbbi futás jelentését. Forrásonként csak a legutóbbi futás marad meg — olvasd el, mielőtt elindítod a következőt.

Megmutatja, hogy a futás ütemezett, kézi vagy küldés volt-e; hogy teljes pillanatkép volt-e vagy csak változások; és egy számlálórácsot.

Amiket érdemes ismerni:

Számláló	Mit jelent
Beérkezett elemek / Felhasznált elemek	Hány termék érkezett, és hány élte túl az ellenőrzést.
Hozzáadott / frissített / változatlan / eltávolított termékek	Mi változott alaptermék szinten.
Eltárolt változatok / Eltávolított változatok	Ugyanez, változatokra. Egy egészséges futásnál ez legalább akkora, mint a termékek száma.
Indexelt keresőkártya-darabok	Mennyi kereshető szöveget olvasott újra az AI. Egy termékből egy vagy néhány darab lesz attól függően, mennyit hordoz.
Újraírt áttekintő oldalak	Az újraépített katalógusoldalak — egy az egész katalógusnak, plusz kategóriánként egy.
Érvénytelenként kihagyva	A kimaradt elemek. Az okok alatta vannak felsorolva.
Terméket megállító változatok	Egy ellenőrzésen elbukott változat az egész termékét kiveszi a futásból, így ha ez nem nulla, az megmagyaráz egy hiányzó terméket.
Figyelmen kívül hagyott termékárak (változatokat küldtél)	Árat küldtél a terméken és változatokat is alá. A változatok nyernek, a termékszintű árat pedig figyelmen kívül hagyjuk — lásd a Termék API leírását.
Hossz miatt levágott keresőkifejezések	A termék több keresőkifejezést küldött, mint amennyit egy termék hordozhat; a többi kimaradt.

Ha a termékek elmentődtek, de a katalógusoldalak nem, a jelentés ezt írja ki: „A termékek elmentődtek, de a katalógus áttekintő oldalait nem sikerült frissíteni. A következő futás újraépíti őket." A termékeiddel minden rendben, és a válaszok is működnek — de a következő futásig az AI képe a katalógusod szerkezetéről egy futással elavult.

Alatta legfeljebb három lista:

Kihagyott elemek — mely elemek maradtak ki és miért (az első 50).
Hossz miatt levágott termékek — azok a termékek, amelyek több kulcsot vagy több keresőkifejezést küldtek, mint amennyit egy termék hordozhat.
A webshop által küldött mezők — minden mezőnév, amit ebben a futásban láttunk. Ugyanez a lista adja a „mezők, amikből kulcs lesz" címkéit.

Sorműveletek

Beolvasás most, Legutóbbi futás jelentése, Szerkesztés, Törlés — Termék API forrásoknál pedig még kettő: Küldési cím másolása, és egy gyorslink az API fülre az adott forrással kiválasztva, hogy a kódpéldák a valódi címét tartalmazzák.

Egy forrás törlése törli a termékeit is, mindennel együtt, amit az AI megtanult róluk. A megerősítés pontosan megmondja, hányról van szó. Egy forrás nem törölhető, amíg beolvasás vagy küldés fut.

Érdemes ismerni ezeket a korlátokat

Korlát	Érték	Mit látsz, ha eléred
Termék forrásonként	20 000	A beolvasás hibára fut, és megkér, hogy oszd szét a katalógust több forrás között
Termék szervezetenként	20 000	A beolvasás hibára fut; írj az ügyfélszolgálatnak a megemeléséért
Változat szervezetenként	100 000	A beolvasás hibára fut, és megnevezi a számot, amit elért volna
Változat termékenként	500	A termék érvénytelenként kimarad
Forrás szervezetenként	100	A forrás mentése nem sikerül
Válasz mérete	50 MB	„A válasz nagyobb, mint 50 MB"
Beolvasási időtúllépés	Próbálkozásonként 30 másodperc	„A kérés 30 másodperc után túllépte az időkeretet"
További fejlécek	Forrásonként 20	A Fejléc hozzáadása gomb leáll
Mezők, amikből kulcs lesz	Forrásonként 20	A mező nem fogad többet
Kulcs termékenként	500	A jelentésben „Hossz miatt levágott kulcsok"
Keresőkifejezés termékenként	100 szó, a változatokkal együtt	A jelentésben „Hossz miatt levágott keresőkifejezések"
Kategória mélysége	6 szint, szintenként 100 karakter	Az elem érvénytelenként kimarad
Leírás termékenként	20 000 karakter	Az elem érvénytelenként kimarad

Az egyedi mezőszövegre már nincs korlát. A termék saját mezőit korábban 4000 karakternél levágtuk; most mindent megtartunk és indexelünk, amit küldesz, a háttérben keresődarabokra bontva. A régi „Hossz miatt levágott mezők" számláló csak a változás előtti jelentéseken jelenik meg.

Kisebb korlátok, amíg senki nem fizet

Egy aktív előfizetés és egyenleg nélküli szervezet szándékosan kisebb feed-korlátokat kap, mert egy ekkora katalógust amúgy sem tudna eltárolni:

Korlát	Amíg senkit nem terhelünk	Fizetős csomagon vagy egyenleggel
Válasz vagy küldés mérete	5 MB	50 MB beolvasás / 25 MB küldés
Termék egy beolvasásban vagy küldésben	1000	20 000
Küldés percenként	6	60

Egyenleg feltöltése vagy előfizetés indítása azonnal megemeli ezeket — nincs mit bekapcsolni és nincs mire várni.

Az API fül azokat a számokat írja ki, amik a te szervezetedre érvényesek, nem a fizetősöket — így egy ingyenes szervezeten dolgozó fejlesztő a valódi korlátokat látja. Amikor a kisebb készlet van érvényben, a fül ezt ki is írja, és megnevezi, mivé válnak a korlátok, ha feltöltesz egyenleget.