Stap 1: Genereer je API credentials in VidaXL
De VidaXL API maakt gebruik van het Mirakl platform, wat betekent dat je een Mirakl-account nodig hebt om je producten naar VidaXL te sturen.
Voor het maken van de verbinding heb je een API-sleutel en een shop ID nodig. Login op je VidaXL account en navigeer naar My user settings door op het e-mailadres rechts bovenin te klikken. Ga naar de API sleutel tab en klik op "Genereer een nieuwe sleutel", mits er nog geen API sleutel automatisch is verschenen. Als er wel al een sleutel automatisch is verschenen, hoef je geen nieuwe aan te maken. Kopieer de API key, deze zul je in de volgende stap nodig hebben.
Vervolgens kan je de Shop ID van jouw shop vinden onder My Account > Settings. Selecteer de shop waar je de VidaXL producten naartoe wilt sturen en kopieer de Shop ID, je zult deze in de volgende stap nodig hebben.
Stap 2: Maak een nieuwe VidaXL API in Channable
Om een nieuwe VidaXL API aan te maken dien je eerst een koppeling tussen je VidaXL account en Channable aan te maken. Hiervoor ga je naar [je naam rechtsboven] > Koppelingen > Koppeling toevoegen. Wanneer je klikt op ''Koppeling toevoegen+'' krijg je dit scherm te zien, waar je VidaXL kunt selecteren:
Wanneer je hebt geklikt op VidaXL krijg je het scherm zoals hieronder te zien. Vul hier onder ''Label'' een naam in voor de koppeling; we raden je aan de naam VidaXL Nederland of VidaXL België te geven, afhankelijk van het land waar je de koppeling mee wilt maken. Vul de API sleutel en Shop ID die je in de vorige stap hebt gekopieerd in onder "API key" en "Shop ID", en klik op de "Maak aan"-knop om de koppeling op te slaan.
Nu je de koppeling met VidaXL hebt aangemaakt in Channable ga je naar jouw project in Channable en klik je op APIs in de linkermenubalk. Klik vervolgens op ''+ API koppeling toevoegen'' en dan zie je de net aangemaakte koppeling met VidaXL staan. Klik op de koppeling en het volgende scherm zal verschijnen:
De volgende stap is om een naam in te vullen en uit het dropdownmenu een 'unieke ID per item' en 'Land' te kiezen. Het unieke ID is de code die uniek (verschillend) is voor elk afzonderlijk item. Zorg ervoor dat de code die je kiest echt een unieke code is: anders zal er een fout optreden. Wanneer je gebruik maakt van master regel groepen kan je ook deze alvast selecteren. Wanneer je de instellingen hebt ingevuld klik je op ''Volgende''.
Stap 3: Bouw je productvermeldingen!
Het bouwen van product vermeldingen gaat simpel en snel met onze standaard-template. Je kunt een productvermelding aanmaken door de volgende vier stappen in de VidaXL API te volgen.
- Categorieën
Nu je de API hebt aangemaakt, is het tijd om de categorieën in te stellen. Hierdoor kun je jouw eigen categorisatie converteren naar die van VidaXL. Dit kan met behulp van de functie Categorieën genereren, of door handmatig de categorieën in te vullen. - Regels
Maak verschillende regels aan om je productdata te optimaliseren. Voor voorbeelden kan je naar ons helpcenter artikel gaan over veel voorkomende regels. - Opbouw
Hier kan je standaard template vinden voor het aanmaken van productvermeldingen. Het enige wat je hoeft te doen is op de velden te klikken en de juiste te selecteren. Het veld 'Title' moet bijvoorbeeld de titel van het product weergeven enzovoort.
Tip! Let op het vraagteken achter elk veld. Wanneer je je muis op het vraagteken plaatst, zie je de beschrijving van het veld en suggesties voor mogelijke waarden.
Wanneer je klaar bent met het opzetten van je productvermeldingen kan je deze opslaan door te klikken op ''Opslaan'' onderaan het scherm.
- Attributen
Je bent er bijna! De volgende stap is om de velden in Attributen te optimaliseren. Een voorbeeld van wat je in Attributen zou moeten vinden zie je in de afbeelding hieronder. Voor een uitgebreide uitleg van hoe je de Attributen kan optimaliseren kan je ons Attributen support artikel doorlezen.
Opmerking: Voor VidaXL België en Zwitserland wil VidaXL alleen de offer informatie van Channable ontvangen, en geen content informatie. Sla de Categorieën en Attributen stappen over om alleen de offers vanuit Channable te sturen. Vul alleen de Opbouw stap van de API in. Voor meer informatie, zie de VidaXL pagina over cross-border sales in landen met dezelfde taal.
Stap 4: Stuur je advertenties naar VidaXL
Bijna klaar, je kunt nu je producten naar VidaXL sturen. Zorg ervoor dat je je project hebt geactiveerd in Channable door in de tool naar Configuratie te gaan en daarna op "Activeer project" te klikken. Ga daarna naar APIs > "VidaXL API Naam" > Instellen en daarna op "Activeren". Nadat je deze stap hebt voltooid, ga je terug naar het API's-overzicht en klik je op de blauwe knop "uitvoeren" om de productvermeldingen naar VidaXL te versturen.
Stap 5: Controleer je productvermeldingen op fouten
Wanneer de advertenties naar VidaXL zijn verstuurd, kan je bij Bekijk de voorvertoning van je VidaXL-productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet geplaatst zullen worden op VidaXL.
Belangrijk: Bij het versturen van nieuwe producten (d.w.z. onbekende EAN's) naar VidaXL, moeten zij de content die je voor deze nieuwe producten verstuurt goedkeuren. Naast de standaard content check van het Mirakl Marketplace platform heeft VidaXL ook een eigen goedkeuringstool. Je producten kunnen als 'succesvol' worden getoond in de Resultaat stap in Channable (omdat wij ze met succes naar VidaXL hebben gestuurd), maar nog niet live staan op VidaXL. Dit kan komen doordat het goedkeuringsproces nog niet is afgerond, of doordat er contentfouten uit het goedkeuringsproces van VidaXL zijn gekomen. Je kunt inloggen in je VidaXL account om dit te controleren. Voor meer informatie kun je dit artikel raadplegen.