Mitä Builder.io- ja Crowdin-integraatio tekee

Builder.io- ja Crowdin-integraatio kokoaa AI Commerce Cloud -verkkokaupan Builder.io-sisältöjen kääntämisen yhteen prosessiin. Lähdekieliset sisällöt synkronoidaan Crowdiniin, jossa ne voidaan esikääntää, tarkistaa ja hyväksyä ennen palauttamista Builder.iohon. Keskitetty työnkulku vähentää erillisiä käsin tehtäviä siirtoja ja auttaa pitämään monikielisen sisällön yhdenmukaisena.

Hyväksyntävaihe on tärkeä myös tekoälykäännöksiä käytettäessä. Käännöksiä ei pidä käsitellä julkaisuvalmiina pelkän esikäännöksen perusteella, vaan terminologia, linkit, muuttujat, tuotetiedot ja sisältöjen merkitys tarkistetaan kohdekielellä. Automaattista synkronointia kannattaa käyttää vasta, kun manuaalinen kierros on testattu yhdellä rajatulla sisällöllä.

Valmistele tilit, oikeudet ja lähdekieli

Builder.io–Crowdin-käännösprosessia varten Builder.io-tilin tulee olla Pro-tasoinen tai sitä laajempi, käyttäjällä pitää olla tarvittavat oikeudet molempien palveluiden projekteihin ja Builder.io-sisällöt pitää olla luotu yhdellä sovitulla lähdekielellä. Tarkista myös, kuka saa luoda integraation, käynnistää synkronoinnin ja hyväksyä käännöksiä.

Valitse lähdekieli ennen sisältöjen siirtämistä. Jos Builder.io-sisältö on suomeksi, Crowdinin lähdekieleksi valitaan suomi ja kohdekieliksi kaikki julkaistavat kielet. Älä vaihda lähdekieltä kesken käyttöönoton ilman erillistä migraatiosuunnitelmaa, koska kielikartoituksen on vastattava Builder.iohon määriteltyjä kieliä koko synkronointiketjussa.

1. Integroi Builder.io ja Crowdin

Builder.io–Crowdin-integraatio aloitetaan Builder.io-palvelun virallisesta Crowdin-ohjeesta: https://www.builder.io/c/docs/crowdin. Noudata ohjeen nykyisiä valtuutus- ja yhdistämisvaiheita, liitä oikea Builder.io-tila oikeaan Crowdin-projektiin ja rajaa integraation käyttöoikeudet vain työnkulun edellyttämään laajuuteen.

Kirjaa käyttöönottoa varten yhdistetyn Builder.io-tilan ja Crowdin-projektin nimet, vastuuhenkilöt sekä lähdekieli. Varmista ennen ensimmäistä synkronointia, ettei testiprojekti osoita tuotannon sisältöihin. Ulkoinen ohje ja palvelutasojen vaatimukset voivat muuttua, joten ne on tarkistettava palveluntarjoajilta ennen integraation käyttöönottoa.

2. Luo Crowdin-projekti ja määritä kielet

Builder.io-käännöksille luodaan Crowdinissa oma projekti. Avaa Crowdinin hallintapaneeli, luo projekti ja siirry projektin asetuksiin, joiden nimi on "Crowdin Settings". Valitse "Crowdin Source language" -kenttään "Finnish", jos Builder.io-sisällön lähdekieli on suomi, ja lisää "Crowdin Target language" -valintoihin yksi tai useampi julkaistava kohdekieli. Tallenna valinnat "Crowdin Save" -painikkeella.

Avaa seuraavaksi "Crowdin Integrations", valitse Builder.io-integraatio ja tarkista sen "Crowdin Settings" -asetuksista kielikartoitus eli "Crowdin Language mapping". Jokaisen Builder.io-kielen pitää vastata oikeaa Crowdin-kieltä. Virheellinen kartoitus voi siirtää hyväksytyn käännöksen väärälle kieliversiolle, joten tarkista sekä alkukielen että kohdekielten koodit ennen sisältösynkronointia.

3. Synkronoi Builder.io-sisällöt Crowdiniin

Builder.io-sisältöjen lähdesynkronointi käynnistetään Crowdinin "Crowdin Integrations" -näkymästä avaamalla Builder.io-integraatio ja synkronoimalla sisällöt valittuun projektiin. Tarkista synkronoinnin valmistuttua, että odotetut sisällöt näkyvät projektissa ja että lähdetekstit ovat oikealla lähdekielellä ennen kääntämisen aloittamista.

Rajaa ensimmäinen kierros pieneen sisältöjoukkoon. Jos sisältöjä puuttuu, kieli on väärä tai rakenne ei vastaa Builder.io-sisältöä, älä jatka massakäännökseen. Tarkista integraation projekti-, sisältö- ja kielikartoitus. Näin virhe ei monistu kaikkiin kohdekieliin eikä hyväksyttyä sisältöä synkronoida takaisin väärään Builder.io-kohteeseen.

4. Esikäännä valitun kielen sisällöt

Crowdin-käännöstyö aloitetaan projektin "Crowdin Dashboard" -näkymästä valitsemalla käännettävä kieli ja avaamalla sen käännösnäkymä. Kun haluat käsitellä koko valitun sisältöjoukon kerralla, käytä "Crowdin Translate all" -toimintoa, valitse "Crowdin Pre translate with" ja sen jälkeen haluttu esikäännöstapa.

Esikäännös tuottaa tarkistettavan ehdotuksen, ei automaattisesti hyväksyttyä lopputulosta. Tarkista etenkin otsikot, painiketekstit, linkit, muuttujat, tuotenimet ja AI Commerce -terminologia. Jos sama lähdesana tarvitsee eri vastineen eri yhteydessä, korjaa käännökset ennen hyväksyntää sen sijaan, että käyttäisit yhtä koneellista vastinetta kaikkialla.

5. Tarkista ja hyväksy käännökset

Crowdinin esikäännetyt Builder.io-sisällöt tarkistetaan kohdekielellä ennen takaisin synkronointia. Vertaa käännöstä lähdetekstiin, varmista sisältörakenne ja tarkista, etteivät muuttujat, linkit tai muotoilumerkinnät ole muuttuneet. Hyväksy valmis käännös "Crowdin Approve" -toiminnolla vasta, kun se täyttää verkkokaupan kieli- ja sisältövaatimukset.

Sovi hyväksyjät ja tarkistusvastuu jokaiselle kohdekielelle. Jos käännös vaatii korjauksen, tee se Crowdinin käännösnäkymässä ja hyväksy vasta korjattu versio. Hyväksyntävaiheen käyttäminen vähentää riskiä, että tekoälyn väärä termi, puuttuva tieto tai kielioppivirhe siirtyy Builder.io-sisältöön ja edelleen verkkokaupan näkyvälle sivulle.

6. Synkronoi hyväksytyt käännökset Builder.iohon

Hyväksytyt Crowdin-käännökset palautetaan Builder.iohon palaamalla "Crowdin Integrations" -näkymään ja käynnistämällä Builder.io-integraation synkronointi. Tarkista synkronoinnin jälkeen Builder.io-sisällöistä, että oikea käännös on siirtynyt oikealle kieliversiolle eikä lähdekielinen sisältö ole muuttunut.

Tarkista lopputulos vielä verkkokaupan esikatselussa ennen julkaisua. Varmista otsikot, tekstiosiot, painikkeet, linkit ja asettelu jokaisella kohdekielellä. Jos Builder.io-sisällöt päivittyvät synkronoinnin jälkeen automaattisesti, pidä hyväksyntä- ja esikatseluvaiheet pakollisina, jotta teknisesti onnistunut siirto ei yksin riitä julkaisupäätökseksi.

7. Ota ajastettu synkronointi käyttöön hallitusti

Builder.io–Crowdin-integraation "Crowdin Scheduled Sync" voidaan määrittää ajamaan päivittäin, viikoittain tai kuukausittain. Ota ajastus käyttöön vasta, kun lähdesynkronointi, käännös, hyväksyntä ja paluusynkronointi on testattu manuaalisesti. Valitse rytmi sisältöjen päivitystiheyden ja tarkistusresurssien mukaan, jotta uusia käännöksiä ei siirry nopeammin kuin ne ehditään hyväksyä.

Seuraa ensimmäisiä ajoja Crowdinin "Crowdin Integrations" -näkymästä ja tarkista Builder.iohon siirtyneet sisällöt. Dokumentoi virhetilanteen omistaja ja tapa pysäyttää automaatio. Crowdinissa hallitaan integraatiota, kieliä, käännöksiä ja hyväksyntöjä; Builder.iohon siirtynyt lopputulos tarkistetaan sisältönäkymässä ja verkkokaupan esikatselussa.