Koppeling Sooqr – CCV Shop Deze handleiding beschrijft hoe je Sooqr zoekmachine optimalisatie kan integreren in je CCV Shop webwinkel. Deze integratie is ontwikkeld door Webshop-koppelingen.nl. Handleiding versie 1.0, laatste wijziging op 26-01-2019.

Inhoud

Koppeling Sooqr – CCV Shop ................................................................................................................ 1

Inhoud ..................................................................................................................................................... 2

1. Inleiding ............................................................................................................................................... 3

2. App installatie ...................................................................................................................................... 4

3. Webshop-koppelingen.nl Dashboard .................................................................................................. 7

4. Aanmaken Sooqr account ................................................................................................................... 8

5. My Sooqr dashboard ......................................................................................................................... 11

Inladen product feed in Sooqr ........................................................................................................... 11

Identificatie feed ............................................................................................................................... 11

Indexatie instellingen ........................................................................................................................ 12

6 Trefwoorden groepen maken............................................................................................................. 14

7 Sooqr filters activeren ........................................................................................................................ 15

1. Inleiding Om Sooqr te integreren in je webshop is het benodigd om een aantal stappen op de juiste manier te volgen. Het is namelijk niet mogelijk om je bij Sooqr aan te melden zonder dat je een product feed hebt welke Sooqr kan inlezen. Daarom dien je eerst de app te installeren op je webshop, de instellingen goed te zetten in het dashboard van Webshop-koppelingen.nl en daarna jezelf registreren bij Sooqr. Zodra de app is geïnstalleerd worden ook de trefwoorden geïnventariseerd en dien je deze te groeperen in het Webshop-koppelingen.nl dashboard. Heb je al een Sooqr account, dan kan je na de installatie van de app direct de feed URL’s gebruiken om deze toe te voegen in Sooqr. Indien je vragen hebt over Sooqr, wat Sooqr is en wat het kan, dan kan je deze het beste stellen bij Sooqr. Ze hebben een Engelse website, maar een prima Nederlandse support desk.

Disclaimer

Ondanks dat we de app, app installatie, de werking van de app binnen Sooqr en de

werking van Sooqr op je webshop uitvoerig hebben getest kan het voorkomen dat er

problemen optreden. Er zijn ontzettend veel verschillende instellingen die fouten op

jou specifieke webshop kunnen veroorzaken.

We willen je vragen om contact op te nemen en het probleem zo goed mogelijk

proberen uit te leggen. Het helpt om je webwinkel URL te benoemen en indien

mogelijk printscreens te maken van eventuele foutmeldingen welke je ziet. We

doen, zowel bij Sooqr als bij Webshop-koppelingen.nl onze uiterste best om

problemen zo spoedig mogelijk op te lossen.

2. App installatie Om de Sooqr functionaliteit toe te voegen aan je webwinkel is het vereist om de Sooqr app te installeren. Deze zorgt voor een aantal belangrijke punten:

1. Genereert een data feed van je producten 2. Installeert het Sooqr zoek widget in je webshop

Begin allereerst met het inloggen op het Onderhoudspanel van je webwinkel. Daar vindt je in het linker menu de optie ‘App Store’

Figuur 1 - CCV Shop App Store

Zoek in de App Store naar de Sooqr app en open de app door op de App te klikken

Figuur 2 - Zoeken naar de Sooqr app

In het Sooqr app scherm klik je op de knop ‘Installeren’ om de app te installeren op jou webwinkel.

Klik in het vervolg scherm op de knop ‘Volgende’ om de rechten te accorderen welke de app nodig heeft.

De volgende stap is dat je inlogt op het dashboard van webshop-koppelingen.nl. Hiermee koppel je je webwinkel aan een account van webshop-koppelingen.nl. In dit dashboard krijg je belangrijke informatie beschikbaar om de Sooqr zoek widget op je webwinkel in te stellen. Indien je nog geen account hebt voor webshop-koppelingen.nl dan kan je je registreren door op de link ‘registeren voor een account’ te klikken.

Indien je succesvol bent ingelogd dan krijg je een bevestiging van installatie te zien.

Sluit na de installatie het scherm af met de ‘Sluiten’ knop. De app is nu geïnstalleerd. Wat rest is het instellen van de instellingen in zowel het MySooqr dashboard, als ook instellingen in het dashboard van webshop-koppelingen.nl.

3. Webshop-koppelingen.nl Dashboard Login op het dashboard van webshop-koppelingen.nl. Je kan dit doen op de volgende pagina: https://ccvshop.webshop-koppelingen.nl/Apps/ Nadat je bent ingelogd zie je aan de linkerzijde in het menu de Sooqr app staan

In de rechterzijde van je scherm heb je enkele instellingen tot je beschikking. Hier kan je o.a. je Account nummer (per taal) invullen en de links vinden waarop de Sooqr product feed (per taal) wordt gegenereerd. De beschikbare talen worden opgehaald uit je webwinkel. Deze worden niet automatisch ververst. Indien je andere of nieuwe talen in je webwinkel activeert dien je de Sooqr app opnieuw te installeren.

Vul per taal je accountnummer in. Laat je een accountnummer leeg in een taal, dan zal voor die taal Sooqr niet geladen worden. Indien je wil terugvallen naar je Nederlandse account dan kies je bij de instelling ‘Terugval naar NL accountnummer’ op ‘Ja’. Sla de instellingen op met de ‘Opslaan’ knop. Kopieer vervolgens de export feed url van de Nederlandse taal naar het klembord (Ctrl + C). Deze lijkt op; https://ccvshop.webshop-koppelingen.nl/Files/?Hash=......

4. Aanmaken Sooqr account Om de integratie te kunnen installeren is het vereist om een Sooqr account te hebben. Aanmelden bij Sooqr kan op deze pagina: https://signup.sooqr.com/ Stap 1: vul je gegevens in

Stap 2: Kies voor “I have my own custom data feed”

In het vervolg scherm plak je de URL welke je hebt gekopieerd. Sooqr zal direct valideren of de feed toegankelijk is en zal je een groen vinkje geven.

Klik op ‘Continue’ en Sooqr zal je feed direct gaan identificeren. Dit proces kan enkele minuten duren. Stap 3 Bij stap 3 dien je op te geven welke informatie waar staat. Sooqr doet hier al een poging om automatisch velden te mappen uit de feed.

Neem de instellingen over zoals in onderstaande tabel:

Unique identifier UniqueId

Displayed title Title

Indexed title Title

Detail URL FullUrl

Image URL FullImageUrl

Price Price

Normal Price NormalPrice

Description Description

Klik op ‘Done’. Sooqr gaat de feed daadwerkelijk inlezen en proberen om ook de specificatie filters zo goed mogelijk in te stellen. Je krijgt direct een demo te zien. Klik op ‘start optimizing’ om daadwerkelijk in te loggen op het MySooqr gedeelte. Zie je in de demo daadwerkelijk producten, dan kan je hoofdstuk 5 overslaan en naar hoofdstuk 6.

Let op: Sooqr zal een e-mail bevestiging sturen met daarin een code welke in je webshop

geplaatst moet worden. Door het installeren van de app is dit deel reeds voorzien. De e-mail

mag je daarom verder negeren.

5. My Sooqr dashboard

Inladen product feed in Sooqr Als volgende stap is het belangrijk dat Sooqr de feed gaat ophalen. Hierdoor worden o.a. de producten opgehaald en een lijst gemaakt van alle trefwoorden welke nog niet gegroepeerd zijn. In hoofdstuk 6 volgt hier een stappenplan voor. Open een nieuw browser scherm of een nieuw tabblad in je huidige browser. Login op je My Sooqr account op: https://my.sooqr.com/user/login Ga naar My Data => My Data Feeds;

Kies de volgende instellingen

Basic options

Feed Type XML

URL to feed Plak de download URL uit het webshop-koppelingen.nl dashboard

Username Leeg laten

Password Leeg laten

Synchronisation

Sync. Interval Daily

Preferred hour for synchronisation

Tussen 0 en 6

Preferred minute for synchronisation

Eigen keuze

In Sooqr kan je kiezen om je feed vaker te verversen echter wordt slechts éénmaal per dag de feed ververst. Vaker ophalen en verwerken heeft daarom geen toegevoegde waarde. Is dit voor jou webshop een probleem? Neem dan contact met ons op en beargumenteer waarom dit vaker moet. We gaan dan kijken naar een oplossing. Klik vervolgens op ‘Add feed’.

Identificatie feed Nadat de feed is toegevoegd in Sooqr is het nodig om deze te identificeren. Ga naar My Data => My Data Feeds;

Klik op het i-icoon om de datafeed te identificeren.

Indexatie instellingen Als de feed correct is geïdentificeerd dan worden de producten ingelezen in Sooqr. Wel moet aan Sooqr verteld worden welke informatie waar staat in de feed, oftewel: welk veld is de product naam, welke is de prijs en welke is de Product deeplink (URL)? Ga naar My Data => Indexation;

Neem de instellingen over zoals in onderstaande tabel:

Unique identifier UniqueId

Displayed title Title

Indexed title Title

Detail URL FullUrl

Image URL FullImageUrl

Price Price

Normal Price NormalPrice

Description Description

Klik vervolgens op ‘Save changes’. Ga daarna naar het tabblad ‘Custom fields’. Hier dien je de volgende velden in te schakelen per type field:

Field name Use field Use for auto correct

Category 1 YES YES

Category 2 YES YES

ContentType YES NO

Description YES YES

FullImageUrl NO NO

FullUrl NO NO

Keywords NO NO

MPN YES NO

NormalPrice NO NO

Price NO NO

Title YES YES

UniqueId NO NO

Het is mogelijk dat in deze lijst onder het veld Keywords meerdere sub waarden voorkomen, deze

dienen later ingesteld te worden in hoofdstuk 7.

6 Trefwoorden groepen maken Nadat je de app hebt geïnstalleerd op je webwinkel zal het platform van webshop-koppelingen.nl op de achtergrond de Sooqr product feed gaan maken. Dit proces controleert ook welke trefwoorden je per product hebt ingevuld in je webwinkel. Deze trefwoorden worden ook opgehaald en opgeslagen in het dashboard van webshop-koppelingen.nl Dit wordt gedaan met als doel dat je deze onder een groep kan hangen, waarbij de trefwoorden groep gebruikt kan worden als filter in Sooqr. Stel je hebt een product (Handshoen met een combinatiekleur van rood en zwart) waar je de trefwoorden ‘Rood’, ‘Zwart’ en ‘XL’ bij hebt gekoppeld. Je dient dan de Kleur en Maat trefwoord groep te maken. Ga in het webshop-koppelingen.nl naar de Sooqr app. Onderaan de pagina vindt je de sectie ‘Trefwoorden’:

Geef hier per trefwoord op in welke groep deze moet vallen. Klik per trefwoord op de knop ‘Opslaan’ om deze op te slaan. Het achtergrond proces welke de feed bouwt zal de volgende keer trefwoorden gaan groeperen en in de feed meegeven aan Sooqr.

7 Sooqr filters activeren Om optimaal van Sooqr gebruik te maken dien je de filters in te stellen. Deze maken het zoeken krachtig en beter dan je standaard zoeksysteem van de webwinkel. Bij de registratie kan het zijn dat Sooqr al filters heeft gevonden, maar je kan deze aanpassen met de instellingen hieronder beschreven. Ga naar het MySooqr dashboard en login. Vervolgens ga je naar My data => Indexation

Ga daarna naar het tabblad ‘Custom fields’. Hier vindt je onder het veld Keywords verschillende sub velden.

In dit voorbeeld staan de trefwoord groepen ‘Kleur’ en ‘Maat’ in Sooqr. Zet in de kolom ‘Use field’ het veld op YES. De regels met Kleur/Value dien je niet in te schakelen. De volgende keer dat Sooqr de feed verwerkt zullen deze gegevens ook verwerkt worden. Staan hier nog geen velden onder, dan kan het zijn dat de feed nog niet ververst is. Wacht 24 uur tot de feed opnieuw is verwerkt. Ook kan je groepering van trefwoorden niet goed opgeslagen zijn. Controleer hiervoor de instellingen op je dashboard van webshop-koppelingen.nl. Vervolgens ga je naar Frontend en daaronder naar Filters

Hier kan je de filters toevoegen uit de lijst met mogelijke gegevens. Vergeet niet alles op te slaan met de knop ‘Save changes’. Staan de Keywords subvelden hier nog niet bij, wacht dan tot Sooqr de feed ververst heeft.

Sooqr activeren Sooqr is op dit punt klaar om geactiveerd te worden in je webshop. Allereerst moeten we het Sooqr Accountnummer zoeken in het Sooqr dashboard. Je kan deze vinden door te klikken op de ‘Download the Sooqr snippet’ knop aan de rechterzijde van de pagina.

Je browser komt met een downloadbaar tekst bestand met daarin het Sooqr accountnummer. Het bestand heet ‘SQ-123456-1.txt’, waarbij ‘SQ-123456-1’ uit dit voorbeeld je Sooqr accountnummer is. Login op het dashboard van webshop-koppelingen.nl en vul daar in de instellingen bij ‘Accountnummer’ dit nummer in. Let op dat je per taal een Sooqr account dient te hebben. Als laatste stap dien je het widget te activeren op je webshop. Bij de Widget sectie kan je klikken op ‘Activeer’ om het widget op je webshop te installeren.