Op https://developers.tweakwise.com/api vind je alle informatie die je nodig hebt om deze feature te implementeren onder Guided Selling. Binnen de Guided Selling zijn er twee verschillende calls beschikbaar:

• Advisor: Deze call haalt de ingerichte Compare op uit Navigator. Bij de Compare worden er vragen ingericht die door de consument beantwoord moeten worden. Als de consument alle vragen doorlopen heeft, dan worden de producten die het beste matchen als eerste getoond. De antwoorden hoeven niet 100% te matchen. Daarom is er altijd resultaat.
• Filterwizard: Deze call haalt de ingerichte Funnel op uit Navigator. De Funnel wordt ingericht op basis van een filtertemplate. Binnen de funnel wordt er dus als het ware gefilterd, alleen wordt de klant er al vragend doorheen geleid. De producten moeten voldoen aan de eigenschap. Op de resultatenpagina worden er naast de producten ook de gebruikte filters geselecteerd terug gegeven.

Advisor

De volgende parameters kunnen worden meegegeven aan de request:

instancekey*	Deze instance key is een unieke identificatie voor een Tweakwise Navigator instantie. Je kan deze key vinden in Navigator op https://navigator.tweakwise.com/endpoint
code*	Deze code is de unieke code om te bepalen welke Guided Selling regel opgehaald moet worden. Je kan deze code vinden in Navigator op: https://navigator.tweakwise.com/nl/guidedselling. Bij de Advisor gaat het om de Compare.
tn_qs	Met behulp van qs kunnen de beantwoordde vragen meegestuurd worden. Meerdere antwoorden moeten komma gescheiden meegestuurd worden, URL encoded. Voorbeeld: qs1=1%2C2&qs2=3
tn_skip_qs	Sommige vragen kunnen ook overgeslagen worden door middel van skip_qs. Voorbeeld: skip_qs=2%2C4%2C6 OR ?skip_qs=2&skip_qs=4&skip_qs=6
ps	Het aantal producten dat op de pagina wordt teruggeven. Het standaard aantal is 12 en er kunnen maximaal 100 producten teruggegeven worden.

 

De response

<advisor xmlns:i="http://www.w3.org/2001/XMLSchema-instance">

  <advisorid>compare id</advisorid>

  <title>compare naam</title>

  <code>compare code</code>

  <questions>

    <question>

      <questionid>vraag id</questionid>

      <question>vraag</question>

      <attributeid>eigenschap id</attributeid>

      <explanation>uitleg of samenvatting van de vraag</explanation>

      <ismultiselect>true/false om aan te geven of multiselect mogelijk moet zijn</ismultiselect>

      <imageurl>url van afbeeling bij de vraag</imageurl>

      <current>true/false om aan te geven of dit de volgende vraag moet zijn<current>

      <skippable>true/false om aan te geven of deze vraag overgeslagen mag worden</skippable>

      <skiplabel>label voor de button om de vraag over te slaan</skiplabel>

      <answers>

        <answer>

          <answerid>antwoord id</answerid>

          <answer>antwoord</answer>

          <caption>antwoord subtext</caption>

          <summary>uitleg of samenvatting voor het antwoord</summary>

          <imageurl>url naar afbeelding</imageurl>

          <isselected>true/false om aan te geven of dit antwoord geselecteerd is</isselected>

          <nextquestionid>id van de volgende vraag als dit antwoord is gekozen</nextquestionid>

        </answer>

      </answers>

    </question>

  </questions>

  <items>

    <item>

      <itemno>productnummer</itemno>

      <title>productnaam</title>

      <price>prijs</price>

      <properties>

        <property>

          <propertyid>eigenschap id</propertyid>

          <title>eigenschapsnaam</title>

          <attributes>

            <attribute>eigenschapswaarde</attrubute>

          </attributes>

        <ismatch>true/false</ismatch>

        <isfiltered>true/false</isfiltered>

        </property>

      </properties>

    </item>

  </items>

</compare>

 

Filterwizard

De volgende parameters kunnen worden meegegeven aan de request:

instancekey*	Deze instance key is een unieke identificatie voor een Tweakwise Navigator instantie. Je kan deze key vinden in Navigator op https://navigator.tweakwise.com/endpoint
code*	Deze code is de unieke code om te bepalen welke Guided Selling regel opgehaald moet worden. Je kan deze code vinden in Navigator op: https://navigator.tweakwise.com/nl/guidedselling. Bij de Filterwizard gaat het om de Funnel.
catid	Wanneer de Guided Selling alleen producten uit een specifieke storeview moet tonen, kan het categorieID toegevoegd worden. Voorbeeld: catid=100
qs	Met behulp van qs kunnen de beantwoordde vragen meegestuurd worden. Meerdere antwoorden moeten komma gescheiden meegestuurd worden, URL encoded. Voorbeeld: qs1=1%2C2&qs2=3
skip_qs	Sommige vragen kunnen ook overgeslagen worden door middel van skip_qs. Voorbeeld: skip_qs=2%2C4%2C6 OR ?skip_qs=2&skip_qs=4&skip_qs=6

 

De response

 

<filterwizard xmlns:i="http://www.w3.org/2001/XMLSchema-instance">

  <code>funnel code</code>

  <name>funnel naam</name>

  <count>aantal gevonden producten met dezelfde antwoorden</count>

  <navigationurl>

    url voor navigatie requests met geselecteerde antwoorden

  </navigationurl>

  <filtertemplateid>id van gebruikte filtertemplate</filtertemplateid>

  <questions>

    <question>

      <questionid>vraag id</questionid>

      <question>vraag</question>

      <explanation>uitleg of samenvatting van de vraag</explanation>

      <ismultiselect>true/false om aan te geven of multiselect mogelijk is</ismultiselect>

      <imageurl>url naar afbeelding van de vraag</imageurl>

      <current>true/false om aan te geven of dit de volgende vraag is<current>

      <skippable>true/false om aan te geven of deze vraag overgeslagen kan worden</skippable>

      <skiplabel>label voor button om deze vraag over te slaan</skiplabel>

      <answers>

        <answer>

          <answerid>antwoord id</answerid>

          <answer>antwoord</answer>

          <caption>antwoord subtext</caption>

          <summary>uitleg of samenvatting van dit antwoord</summary>

          <imageurl>url naar afbeelding</imageurl>

          <count>aantal producten dat over is na selectie van dit antwoord</count>

          <isselected>true/false om aan te geven of dit antwoord is geselecteerd</isselected>

          <nextquestionid>id van de volgende vraag als dit antwoord is gekozen</nextquestionid>

        </answer>

      </answers>

    </question>

  </questions>

  <items>

    <item>

      <itemno>productnummer</itemno>

      <title>productnaam</title>

      <brand>merk</brand>

      <price>prijs</price>

      <url>product url</url>

      <image>productafbeelding url</url>

      <labels>

        <label>

          <name>labelnaam</name>

          <value>labelwaarde</value>

        </label>

      </labels>

      <attributes>

        <attribute>

          <name>eigenschapsnaam</name>

          <values>

            <value>eigenschapswaarde</value>

          </values>

        </attribute>

      </attributes>

    </item>

  </items>

</filterwizard>