Het External Data component is onderdeel van de Merchandising Builder componenten. Met als verschil dat deze componenten niet direct uit Tweakwise komen, maar extern worden aangeroepen. Net als de overige componenten, zal jouw Customer Succes Manager dit voor je klaar zetten voor jouw instantie(s) op verzoek.

Het External Data component biedt meer mogelijkheden om bijvoorbeeld gesponsorde producten een specifieke plaats te geven zonder hiervoor in Tweakwise wijzigingen te hoeven doen.
Ook kan je dit component gebruiken om nog specifiekere persoonlijk aanbevolen producten te tonen, door informatie uit bijvoorbeeld een geavanceerd CDP systeem te gebruiken.

Het External Data component werkt hetzelfde als alle andere builder componenten.
Dit betekent ook dat de te pushen producten in Tweakwise moeten staan. Producten die niet in de feed staan kunnen dus niet gepushed worden door middel van het External Data component.

Neem contact met jouw Customer Succes Manager op wanneer je interesse hebt in het gebruik van het External Data component.

Hoe stel je dit in?

Nadat jouw CSM het gebruik van External Data components aan heeft gezet voor jouw instantie(s), kan je beginnen met instellen. Voor het opzetten van dit component heb je een HTTP request nodig om daarmee het component te voeden met informatie.

Het instellen van een External Data component vereist technische kennis. De complexiteit van het instellen hangt af van de externe partij waarmee je koppelt. Kom je er niet uit; neem contact op je met jouw Customer Succes Manager. 

De technische voorwaarden voor de HTTP request hebben we beschreven in ons Docs artikel: External Data Components

Na het opzetten van een HTTP request kan je deze binnen Tweakwise instellen.

Deze stel je in de Builder in als Externe Data component en biedt een nieuwe mogelijkheid voor het toevoegen van een component. Hiervoor doorloop je de volgende stappen. Binnen Tweakwise ga je naar de module Merchandising → Builder.

Stap 1: Nadat je op de knop “Nieuw” hebt geklikt zal je worden doorgeleid naar de instellingen:

Als eerste stap geef je de naam aan voor het External Data component en welk icoon je in de Builder wilt tonen. Hierdoor herken je gemakkelijk welk External Data component gebruikt wordt als je deze controleert in de Demoshop.

Stap 2 Geef de bron aan van de externe data:

Je gebruikt hierbij een HTTP request.
Hier kan je kiezen voor het request type GET of POST . Na het instellen kan je door middel van de test-button zien of de data correct doorkomt in de preview.

Wanneer de HTTP request beveiligd is d.m.v. autorisatie kan je deze eerst opgeven voor je de test-button gebruikt. Anders zal je geen data in de preview terugkrijgen.

Standaard is er bij het uitvoeren van de request een timeout na 200 ms , wanneer voor de externe data een langere tijdsperiode nodig is, kan je deze via het tabje Instellingen verhogen.  

Stap 3: Data omzetten naar een resultaat

De externe data kan verschillende formaten hebben die omgezet moeten worden naar een standaard Tweakwise formaat. In de afbeelding hieronder laten we je zien wat het effect is van het omzetten van data naar het standaard Tweakwise formaat.

Documentatie over deze vereisten is te vinden in ons Docs-artikel External Data Components.

Stap 4: Het koppelen van de externe data aan een eigenschap in Tweakwise.
In deze stap zorg je er voor dat de resultaten op basis van het id-veld worden gekoppeld aan een product in Tweakwise. Gebruik hiervoor de eigenschap die dezelfde waarde heeft als het id-veld. Vaak is dit het veld SKU, EAN of het artikelnummer.

Stap 5: Een voorbeeld van de naam en afbeelding die getoond zal worden als component.

Je hebt nu een extern data component aangemaakt. Na het toevoegen van de externe data component in de Builder stel je in op welke shop of pagina’s de Builder actief is.
Hiervoor ga je naar de module Catalogus → Categorieën → Selecteer de gewenste shop of pagina → In de Merchandising Builder stel je de Builder in waar je zojuist een extern data component hebt toegevoegd.  

Na een succesvolle publish-taak zal het component actief zijn en kan je de werking controleren in de Demoshop of op jouw productie,- of testomgeving.

Wijzigingen in de aangeroepen HTTP request zullen automatisch zorgen voor de wijzigingen in de Builder.
Hiervoor hoeft geen nieuwe publish-taak gedraaid te worden, waardoor wijzigingen direct live doorgevoerd zijn wanneer de data in de HTTP request aangepast wordt.