Om te beginnen met het verkopen van je producten op Miravia, is het noodzakelijk om een Miravia verkopersaccount te hebben. Als je nog geen Miravia verkopersaccount hebt, raden wij je aan contact met Miravia op te nemen om deze te verkrijgen. Zodra je een Miravia verkopersaccount hebt ingesteld, kun je beginnen met de koppeling via Channable.
Stap 1 - Een nieuwe koppeling aanmaken
Ga naar het project waarin je werkt en navigeer naar het tabje APIs. Klik op '+API koppeling toevoegen' en vervolgens op '+Koppeling toevoegen'. Selecteer in dit scherm de Miravia koppeling
Stap 2 - Inloggen op Miravia
Je wordt vervolgens automatisch doorgestuurd naar je Miravia omgeving. Hier moet je inloggen met je accountgegevens en het land selecteren dat je met Channable wilt koppelen.
Na het autoriseren van de koppeling wordt je naar Channable teruggeleid. Hier kun je het aanmaken van de koppeling met Miravia afronden door op 'Koppel met Miravia' te klikken.
Stap 3 - Opzetten van de Miravia API
Vervolgens kun je in de API stap je nieuw aangemaakte Miravia koppeling selecteren
En geef de API koppeling een duidelijke naam. Het is ook belangrijk om het juiste veld te selecteren als "Unieke ID per item". Als je hierover twijfelt, raden wij je aan dit veld op "ID" te laten staan.
Stap 4 - Het aanmaken van productvermeldingen in Channable
Het bouwen van productvermeldingen gaat simpel en snel met ons standaard template. Je kunt een productvermelding aanmaken door de volgende vier stappen in de Miravia API te volgen.
- Categorieën
Nu je de API hebt aangemaakt, is het tijd om de categorieën in te stellen. Om de productvermeldingen te kunnen aanmaken hebben je producten een categorie nodig. Dit kun je doen met behulp van de functie categorieën genereren, of door handmatig de categorieën in te vullen. - Regels
Maak verschillende regels aan om je productvermeldingen te optimaliseren. Voor voorbeelden kun je naar ons helpcenter artikel over veelvoorkomende regels gaan. - Opbouw
Hier kun je het standaard template vinden voor het aanmaken van productvermeldingen. Het enige wat je hoeft te doen is op de velden klikken en de juiste selecteren. Het veld 'Title' moet bijvoorbeeld de titel van het product weergeven enzovoort. Wanneer je klaar bent met het opzetten van je productvermeldingen kun je deze opslaan door onderaan op ''Opslaan'' te klikken.
Het 'Item group ID' veld wordt gebruikt om meerdere varianten te combineren tot een gegroepeerde listing. Als je geen meerdere varianten voor je producten hebt, kun je voor het 'item_group_id' veld het unieke ID per item selecteren. Deze staat meestal in het veld "id".
Tip! Hover over the question marks next to the fields to see a description of the field and suggestions for possible values.
In de volgende stap moet je ook je verzendinformatie instellen, bijvoorbeeld gewicht, lengte, hoogte, breedte en de inhoud van je product.
De laatste stap van de opbouw stap is de tab afbeeldingen. Hier kun je de velden koppelen die jouw afbeeldingen bevatten.
Miravia hanteert een aantal strenge eisen voor zowel de URL van de afbeelding als voor de afbeelding zelf. Als je niet aan deze eisen voldoet, krijgt het product een 302-fout in de stap 'Resultaat" (Scroll naar beneden voor een voorbeeld van deze Resultaat stap). Het onderstaande screenshot toont alle vereisten: - Attributes
Je bent er bijna! De volgende stap is om de velden in Attributen te optimaliseren. Een voorbeeld van wat je in Attributen zou kunnen vinden, zie je in de afbeelding hieronder. Voor een uitgebreide uitleg over hoe je de Attributen kunt optimaliseren, kun je ons attributen support artikel doorlezen.
Stap 5 - Stuur je advertenties naar Miravia
Zorg ervoor dat je je project hebt geactiveerd in Channable door in de tool naar Setup > Projectconfiguratie te gaan en daarna op "Activeer project" te klikken. Ga daarna naar APIs > "Je Miravia API Naam" > Instellen en klik daarna op "Activeer API". Nadat je deze stap hebt voltooid, ga je terug naar het APIs-overzicht en klik je op de blauwe knop "uitvoeren" om de productvermeldingen naar Miravia te sturen.
Stap 6 - Resultaten
Wanneer de advertenties naar Miravia zijn verstuurd, kun je bij Resultaat de voorvertoning van je productvermeldingen zien. Klik op de tab 'Fouten'. Hier zie je welke advertenties fouten bevatten en niet geplaatst zullen worden op Miravia. Klik op een specifieke fout om meer informatie te zien over de oorzaak van de fout.
Bijvoorbeeld, als je afbeelding niet voldoen aan de eisen van Miravia, kun je de volgende foutmelding zien:
Als dit gebeurt, moet je de afbeelding controleren en ervoor zorgen dat deze aan de juiste eisen voldoet. Nadat je de afbeelding hebt aangepast, voer je de API opnieuw uit en kijk je of de fout is opgelost.
Vernieuwen van de koppeling
De token van de Miravia koppeling vervalt elke 2 jaar. Wanneer dit gebeurt, moet je de koppeling tussen Channable en Miravia vernieuwen. Dit doe je door in het tabblad 'Instellen' van de Miravia API naar de koppeling te navigeren en vervolgens op de koppeling te klikken. Je kunt hier nu klikken op 'koppeling vernieuwen'.
Je wordt doorgestuurd naar de login pagina van Miravia en er wordt gevraagd om Channable opnieuw te autoriseren om een koppeling te maken met je Miravia account.