Tootevoo vead ja diagnostika
ChatGPT Ads tootevoog ei tööta: vead ja parandused
Kui ChatGPT Ads tootevoog ei tööta, ära laadi sama faili pimesi uuesti. Kõigepealt erista viis kontrollpunkti: kas fail jõudis SFTP-sse, kas OpenAI töötles selle, mitu rida võeti vastu, kas soovitud tooted on reklaamikõlblikud ning kas reklaamirühma filtrid valivad neist midagi. Edukas failiedastus ei võrdu eduka impordiga ja staatus completed ei garanteeri tarnet. Allpool on kindel veaotsingu järjekord, mis aitab leida vea enne eelarve, pakkumise või reklaami muutmist.
Miks ChatGPT Ads tootevoog ei tööta?
Kõige tavalisem põhjus on see, et üht ahelat käsitletakse ühe olekuna. Tootevoo edastamine, andmete töötlemine, ridade vastuvõtmine, reklaamikõlblikkus, filtritele vastamine ja kampaania tarne on eri etapid. Ühe etapi õnnestumine ei kinnita järgmise õnnestumist.
Alusta Upload History vaatest või Advertiser API lõpp-punktist /v1/feeds/uploads. Vaata viimase üleslaadimise staatust, rows_accepted, rows_rejected, rows_ads_eligible ja diagnostics kirjeid. Need näitavad, kas probleem on failis, mõnes reas või alles kampaania valikus.
Kui voog on alles scanning, received või processing olekus, oota terminalstaatust. OpenAI dokumentatsiooni järgi toimub töötlemine asünkroonselt ja product_count võib esialgu olla null. Kui olek on completed_with_errors, said mõned read läbi, kuid tagasilükatud read vajavad parandamist.
Millises järjekorras tootevoo viga kontrollida?
Kasuta sama järjekorda iga vea puhul. Nii ei muuda sa kampaaniat ajal, mil tegelik takistus asub failis, ega ekspordi uut faili ajal, mil nulltulemuse põhjustab liiga kitsas tootevalik.
Salvesta iga kontrolli juurde kellaaeg, feed ID, upload ID ja leitud staatus. Kui probleem tuleb hiljem OpenAI toele eskaleerida, on ühest tõendipakist rohkem kasu kui kümnest järjestikusest üleslaadimisest.
- 1. kinnita, et fail on SFTP juurkataloogis, mitte alamkaustas
- 2. oota üleslaadimisel terminalstaatust: completed, completed_with_errors, skipped või failed
- 3. võrdle vastuvõetud, tagasilükatud ja reklaamikõlblike ridade arvu
- 4. paranda diagnostics koodide järgi lähteandmed
- 5. kontrolli voo praegust product_count väärtust ja üksikuid tooteid
- 6. eelvaata reklaamirühma filtreid ning matched_count tulemust
- 7. kontrolli kampaania, reklaamirühma, reklaamimalli, ülevaatuse ja eelarve olekut
Mida tootevoo staatus tegelikult tähendab?
scanning, received ja processing tähendavad, et töötlemine pole lõppenud. completed tähendab, et töötlemine lõppes, kuid kontrollida tuleb ikkagi ridu, tooteid ja kampaania sobivust. completed_with_errors tähendab osalist õnnestumist: osa ridu võeti vastu, osa lükati tagasi.
skipped tähendab, et üleslaadimist ei töödeldud. failed tähendab, et töötlemine ebaõnnestus. Mõlemal juhul loe diagnostika enne uut katset läbi ning paranda algallikas, mitte ainult üks ekspordifail.
OpenAI rõhutab, et lõpetatud üleslaadimine ei tõenda iga toote tarnimisvõimet. Toote andmed, saadavus, ülevaatus, tootevaliku filtrid ja kampaania enda kõlblikkus võivad toodet endiselt piirata.
- processing – oota ja kontrolli uuesti, ära tee järeldust null product_count põhjal
- completed – kontrolli ridu, reklaamikõlblikkust ja valitud tooteid
- completed_with_errors – paranda tagasilükatud read diagnostika järgi
- skipped – kontrolli lähtefaile ja üleslaadimise ajalugu
- failed – lahenda raporteeritud viga enne uut üleslaadimist
Kuidas parandada levinud diagnostikakoode?
missing_required_column tähendab, et failist puudub nõutud veerg või selle nimi ei vasta skeemile. OpenAI stabiilne tooteskeem nõuab vähemalt item_id, title, description, url, brand, seller_name, image_url, availability ja price välju. Reklaamide jaoks kontrolli lisaks is_ads_eligible väärtust.
invalid_value tähendab, et välja väärtus ei vasta oodatud kujule või lubatud väärtustele. Hind kirjutatakse CSV-s põhivaluuta ühikutes kujul 79.99 USD, laoseis peab kasutama lubatud väärtust, näiteks in_stock või out_of_stock, ning URL peab olema avalikult avatav. Veateate field väärtus ütleb, millisest veerust alustada.
unsupported_file_type tähendab sobimatut failitüüpi. invalid_sftp_directory_layout tähendab, et fail asub vales kataloogistruktuuris: Product Feeds juhend nõuab failide paigutamist otse SFTP juurkataloogi. Alamkausta loomine ei organiseeri importi, vaid võib selle katkestada.
- missing_required_column – lisa puuduv nõutud veerg täpse nimega
- invalid_value – paranda raporteeritud välja vorming või lubatud väärtus
- unsupported_file_type – kasuta toetatud failiformaati; juhendi näide kasutab CSV-d
- invalid_sftp_directory_layout – tõsta failid SFTP juurkataloogi ja eemalda alamkaustad
Miks on product_count null, kuigi fail laaditi üles?
Esimene põhjus võib olla lihtsalt töötlemine. OpenAI ütleb, et voo product_count võib algse üleslaadimise ajal jääda nulliks. Seetõttu kontrolli enne terminalstaatust ning üleslaadimise ridade arve, mitte ainult voo üldnumbrit.
Teine põhjus on see, et product_count kirjeldab voos praegu reklaamikõlblikuna ingesteeritud toodete arvu, samal ajal kui Upload History arvud kirjeldavad konkreetset üleslaadimist. Need arvud ei pea samal hetkel võrdsed olema.
Ads Manageri Ingested, Processed, Not approved ja Ready loendurid kirjeldavad eri populatsioone. Neid ei saa tingimata üksteisest lahutada, et saada puuduvate toodete arvu. Products vaade on omakorda aruandlusvaade: toode võib sinna ilmuda alles pärast aktiivse kampaania tarnet ja aruandluse uuenemist.
Miks on voog korras, kuid reklaamirühm leiab null toodet?
Kui voog sisaldab tooteid, kuid reklaamirühma valik on tühi, kontrolli product_set filtreid. OpenAI soovitab pärida esmalt tühja filtriloendiga. Kui tooted ilmuvad, lisa filtrid ükshaaval tagasi, kuni leiad tingimuse, mis soovitud tooted välja jätab.
Tüüpiline viga on see, et bränd, kategooria, hinnapiir või ads_metadata väärtus on failis teistsugune kui filtris. Ka kataloogi uuendus võib varem töötanud valiku tühjaks muuta, näiteks kui hind ületab ülempiiri või kategooria nimi muutub.
Ära eelda, et product_set uuendamine liidab uue tingimuse vanadele. Developer-juhend ütleb, et uuenduses tuleb saata kogu soovitud filtriloend. Filtrite eemaldamiseks tuleb saata sama product_feed_id ja tühi filters massiiv ning seejärel salvestatud valik uuesti üle lugeda.
Kuidas eristada CSV, Delta API ja kampaania hinnavorminguid?
Hind on sage invalid_value põhjus, sest kolmes pinnas kasutatakse erinevat kuju. CSV price kasutab põhivaluuta ühikuid koos valuutakoodiga, näiteks 79.99 USD. Delta API price.amount kasutab täisarvulisi väiksemaid valuutaühikuid, seega 7999 tähendab 79,99 dollarit.
Kampaania eelarved ja pakkumised kasutavad micros ühikuid. Neid ei tohi kopeerida Delta API tootehinda. Näiteks 50 põhivaluuta ühikut võib kampaania väljal olla 50000000 micros, kuid sama arv product price.amount väljal oleks täiesti vale.
Delta API vastus accepted: true kinnitab, et värskendus võeti töötlemisse. See ei kinnita, et indekseerimine, reklaamikõlblikkus või tarne on juba uuenenud. Pärast hinnamuutust kontrolli päris toodet ja sobivust uuesti.
- CSV price: 79.99 USD – põhivaluuta ühikud ja valuutakood
- Delta API price.amount: 7999 – väiksemad valuutaühikud
- kampaania micros: 50000000 – 50 põhivaluuta ühikut eelarve või pakkumise väljal
- accepted: true – päring võeti vastu, kuid tulemus rakendub asünkroonselt
Praktiline näide: kolm viga ühe üleslaadimise järel
Eesti e-pood laadib üles 2500 tootega CSV. SFTP klient teatab õnnestumisest, kuid Ads Manager näitab completed_with_errors. Upload History ütleb, et 2470 rida võeti vastu, 30 lükati tagasi ning invalid_value puudutab price välja.
Kontroll näitab, et 30 real on hind kujul 1 299,00 EUR. E-pood parandab ekspordi kujule 1299.00 EUR, mitte üksikuid ridu käsitsi. Uue üleslaadimise järel on vead kadunud, kuid reklaamirühma tootearv on endiselt null.
Tühja filters loendiga ilmuvad tooted. Ükshaaval lisades selgub, et filtri brand väärtus on „Näidisbränd”, kuid voos on „Näidisbränd OÜ”. Pärast täieliku õige filtriloendi salvestamist ja salvestatud reklaamirühma üle lugemist vastab tootearv plaanile. Alles siis kontrollitakse reklaamimalli, ülevaatust ja kampaania tarnet.
20 minuti kontrollnimekiri enne uut üleslaadimist
Kontrolli esmalt väikest esinduslikku valimit: üks tavatoode, üks variant, üks soodushinnaga toode ja üks laost otsas toode. See paljastab struktuursed vead kiiremini kui kogu kataloogi korduv käsitsi vaatamine.
- fail on UTF-8 kodeeringus ja nõutud veerunimed vastavad stabiilsele skeemile
- item_id on stabiilne, kordumatu ja käsitletud tekstina
- hind on kujul 79.99 EUR, mitte koma, tuhanderühma ega micros-väärtusega
- availability kasutab lubatud väärtust ning vastab e-poe laoseisule
- is_ads_eligible on true ainult toodetel, mida soovid reklaamiks töödelda
- toote- ja pildi-URL-id avanevad avalikult HTTPS-i kaudu ilma sisselogimiseta
- fail asub SFTP juurkataloogis ja sama toode ei kordu mitmes failis
- Upload History staatus on terminalolekus ning tagasilükatud read on läbi vaadatud
- filtrita päring leiab tooted ja filtrid lisatakse tagasi ükshaaval
- reklaamirühma tootearv, mall, kampaania olek ja eelarve vastavad plaanile
Millal on vaja tehnilist parandust ja millal kampaaniaauditit?
Kui rows_rejected on suurem kui null või diagnostics näitab välja- või failiviga, alusta ekspordi tehnilisest parandusest. Kui voog töötleb kõik soovitud read, kuid matched_count on null, lahenda tootevaliku filtrid. Kui voog ja valik on korras, kuid näitamisi ei tule, liigu kampaania, ülevaatuse, eelarve, pakkumise ja maandumislehe kontrolli juurde.
Kõiki kolme probleemi ei tasu lahendada sama töövõtjaga pimesi. E-poe arendaja tunneb lähteandmeid ja eksporti, kampaaniaspetsialist Ads Manageri valikut ning analüütik tarne ja müügi mõõtmist. Üks vastutaja peab siiski hoidma kontrollahela tervikuna koos.
Kulutegurid sõltuvad parandatavate allikate arvust, variantide loogikast, vigaste ridade mahust, uuendussagedusest, filtrite arvust ja sellest, kas vaja on ainult auditit või ka püsivat automatiseerimist. Mõistlik esimene samm on fikseeritud ulatusega diagnostika, mitte kogu kataloogi ümberehitus.
Kuidas Kala Ruudus tootevoo vea lahendab?
Kala Ruudus kaardistab voo vea kihthaaval: edastus, töötlemine, skeem, reklaamikõlblikkus, tootevalik, reklaamimall ja kampaania tarne. Tulemuseks on prioriteetne parandusnimekiri koos tõendiga, milline viga millist toodet või kampaaniat mõjutab.
Vajaduse korral teeme arendajale väljade vastenduse, kontrollime näidisfaili, aitame product_set filtrid üles ehitada ning seome valmis voo mõõdetava pilootkampaaniaga. Me ei nimeta edukat üleslaadimist edukaks reklaamiks ega luba tulemust enne päris tarne- ja müügiandmeid.
Päringu saatmisel lisa e-poe platvorm, feed ID, viimase upload ID, staatus, rows_accepted ja rows_rejected arvud, diagnostikakoodid, soovitud tooterühm ning kampaania olek. Ära saada SFTP parooli, API võtit ega muid mandaate. Vastame, milline kontroll tuleb teha esimesena ja kas vajatakse tehnilist või kampaaniapoolset parandust.
Korduma kippuvad küsimused
Kas successful SFTP upload tähendab, et ChatGPT Ads tootevoog töötab?
Ei. Edukas failiedastus kinnitab ainult faili jõudmist serverisse. Töötlemine on asünkroonne ning Upload History kaudu tuleb kontrollida staatust, vastuvõetud ja tagasilükatud ridu, reklaamikõlblikke ridu ning diagnostikat.
Mida tähendab completed_with_errors?
Osa failist töödeldi, kuid osa ridu või väärtusi lükati tagasi. Vaata rows_rejected arvu ja diagnostics kirjeid, paranda viga algses ekspordis ning laadi parandatud kataloog uuesti üles.
Miks on ChatGPT Ads product_count null?
Algne üleslaadimine võib veel töötlemises olla. product_count kirjeldab praegu reklaamikõlblikuna ingesteeritud tooteid, mitte tingimata viimase üleslaadimise kõiki ridu. Kontrolli terminalstaatust, loendureid ja diagnostikat.
Miks ei leia reklaamirühma filter ühtegi toodet?
Päri esmalt tooteid tühja filtriloendiga. Kui tooted ilmuvad, lisa brändi-, kategooria-, hinna- või ads_metadata filtrid ükshaaval tagasi. Nii leiad tingimuse, mis tooted valikust eemaldab.
Kas Delta API accepted true tähendab, et hind on juba uuendatud?
Ei. accepted true tähendab, et värskendus võeti asünkroonsesse töötlemisse. Kontrolli pärast töötlemist toote tegelikku hinda, reklaamikõlblikkust ja filtritele vastamist.
Millal tasub pöörduda Kala Ruuduse poole?
Kui diagnostika on ebaselge, vead korduvad järgmise ekspordiga, filtrid ei vali õigeid tooteid või tehniliselt korras voog ei jõua tarneni. Saada staatuste ja loendurite tõend, kuid mitte salasõnu ega API võtmeid.
Loe edasi
Kontrollitud allikad
Artikli tootefaktid kontrolliti 23. oktoobril 2026.
Platvormi võimalused, saadavus ja hinnastus võivad muutuda. Kontrollime kampaania planeerimisel alati konto hetkeolukorda ning OpenAI ametlikku dokumentatsiooni.