Miten tuotekuvat tuodaan CSV:llä Akeneoon?
Opit tuomaan tuotekuvat Akeneo PIMiin CSV+ZIP-menetelmällä luotettavasti: nopea massatuonti, SKU-tarkka kohdistus.
Written by Petro Mäntylä
Updated at August 22nd, 2025
Sisällysluettelo
Tämä ohje kuvaa, miten viet (tuot) tuotekuvat Akeneo PIMiin käyttämällä CSV-tiedostoa ja ZIP-pakettia. Menetelmä kohdistaa kuvat tarkasti SKU-koodeihin, mikä vähentää virheitä ja nopeuttaa massapäivityksiä. Ohje sisältää edellytykset, CSV-rakenteen, tiedoston pakkaamisen sekä tuonnin ajon.
Edellytykset
- Tuotteet on luotu Akeneoon etukäteen, jotta kuvat voidaan kohdistaa SKU-koodeille.
- Sinulla on valmiina tuontiprofiili tuotteiden tuontiin.
- CSV sisältää täsmälleen kaksi saraketta: sku ja image (huom. ei “imagd”).
- Ei ylimääräisiä sarakkeita, ei tyhjiä sarakkeita, ei tyhjiä rivejä.
Mistä editoidaan: tuontiprofiilin luonti
- Siirry Akeneossa kohtaan “Imports”.
- Valitse “Create import profile” ja pohjaksi “CSV Product” (tuotteiden CSV-tuonti).
- Nimeä profiili, tallenna. Profiilia käytetään myöhemmin ZIP-paketin lataamiseen.
CSV-tiedoston rakenne
Luo CSV, jossa on vain otsikkorivi ja kuvien rivit:
sku,image SKU-001,tuotteen-nimi-1.jpg SKU-002,tuotteen-nimi-2.jpg
- sku: tuotteen SKU täsmälleen kuten Akeneossa.
- image: kuvatiedoston nimi täsmälleen samassa muodossa kuin tiedostonimi.
Nimeämissuositus kuville
- Käytä pieniä kirjaimia ja korvaa välilyönnit viivoilla, esim. tuotteen-nimi-1.jpg.
- Nimeäminen kuvaavasti auttaa hakukoneoptimoinnissa, mutta ei ole Akeneolle pakollista. a.jpg toimii teknisesti, muttei ole SEO-ystävällinen.
Voiko lisäkuvat tuoda CSV:llä?
Kyllä — voit tuoda lisäkuvia hyödyntämällä omat image-tyyppiset attribuutit (extra_image_1, extra_image_2, jne) ja tuomalla ne omissa sarakkeissaan. Ehto: attribuuttien on oltava luotu Akeneoon ja lisätty tuotteen perheeseen (ja oikealle varianttitasolle, jos kyseessä on variantti). Kuvien numerointi toimii samalla kuvien järjestysnumerona. Alla esimerkkirakenne CSV:lle. Pääkuvana on aina image. Varianttikohtainen lisäkuva on oletuksena attribuuttina variant_image.sku,image,extra_image_1,extra_image_2SKU-001,paakuva.jpg,sivu.jpg,detail.jpg
Tiedostojen sijoittelu ja pakkaus
- Laita CSV ja kuvat samaan kansioon omalla koneellasi.
- Valitse CSV ja kaikki kuvat ja pakkaa ne ZIP-muotoon.
- ZIP-tiedoston nimellä ei ole väliä, esim. images.zip tai images.csv.zip. Myöskään CSV:n nimellä ei ole merkitystä, esim. images.csv.
Tuonnin ajaminen Akeneossa
- Avaa aiemmin luotu tuontiprofiili kohdasta “Imports”.
- Valitse “Upload files” ja raahaa ZIP-tiedosto näkymään.
- Paina “Upload and Import now” käynnistääksesi tuonnin.
- Valmistauduttuasi näet, että tuotteille on muodostunut kuvat image-attribuuttiin.
Kuvaformaatit ja laatu
- Suositus: tallenna kuvat Akeneoon JPG-muodossa riittävän suurikokoisina (laadukas lähde).
- AI Commerce jakelee kuvat asiakkaille automaattisen kuvaskaalaimen kautta optimoiduissa formaateissa ja ko’oissa.
Lisävinkit
- Jos käytät eri attribuuttikoodia kuin image, nimeä CSV-sarakkeesi vastaamaan omaa attribuuttikoodiasi.
- Varmista, että SKU-tunnukset ovat yksikäsitteiset ja identtiset PIMissä sekä CSV:ssä.
- Käytä UTF-8-koodausta, pilkkua erottimena, eikä rivien lopussa ole ylimääräisiä erotinmerkkejä.
Vianmääritys
- Kuva ei näy tuotteella: tarkista, että SKU täsmää ja kuvan tiedostonimi on täsmälleen sama kuin CSV:ssä.
- Tuonti epäonnistuu heti: varmista, ettei CSV:ssä ole tyhjiä rivejä tai ylimääräisiä sarakkeita.
- Useita kuvia per SKU: lisää samalle SKU:lle useita rivejä, yksi rivi per kuva (ellei prosessisi käytä moniarvoista attribuuttia).
Yhteenveto
Kun tuotteet on luotu ja CSV+ZIP on oikein rakennettu, kuvien tuonti Akeneoon sujuu muutamalla klikkauksella. Suosittelemme kuvaavaa, hakukoneystävällistä nimeämistä ja JPG-muotoa laadukkaana lähteenä. Seuraavaksi voit tarkistaa tuonnin jälkeen satunnaisia tuotteita ja varmistaa, että kuvat näkyvät oikein tuotesivujen image-attribuutissa.