Allt du behöver veta om Vitec integrationen

Principen är enkel: Det PLAYipp tar emot från Vitec, det visar PLAYipp. Ingen manuell hantering krävs när integrationen väl är uppsatt.

Hur fungerar integrationen?

Integrationen sätts upp en gång under onboarding, i samarbete med din partner och Vitec. Så här ser dataflödet ut:

Vitec skapar en applikation på sin sida som kopplar till deras eget API och bestämmer vilka data som skickas till PLAYipp.
PLAYipp tar emot datan och gör den tillgänglig som en datakälla inne i PLAYipp.
Du använder Fastighetswidgets i PLAYipp för att visa objekten på dina skärmar.

Integrations konfigurationen är en engångsprocess. Varje kunds integration är unik filtrering och fältkonfiguration bestäms per beställning.

Viktigt: PLAYipp tillämpar ingen filtrering av Vitecs data. Allt PLAYipp tar emot visas. Det innebär att om ett objekt visas som inte borde göra det, eller om ett objekt saknas, beror det på Vitecs konfiguration inte på PLAYipp.

Vem styr vad som visas på skärmen?

PLAYipp har ingen filtreringslogik för Vitec-data. Allt som Vitec skickar visas.

Situation	Var ligger problemet?
Ett objekt visas som inte borde	Kontrollera Vitecs konfiguration
Ett objekt saknas som borde visas	Kontrollera Marknadsföring i Vitec

Marknadsföring i Vitec

I Vitec finns ett avsnitt som heter Marknadsföring. Här kan du som mäklare styra vilka kanaler varje enskilt objekt publiceras till till exempel PLAYipp, Instagram och andra.

Så här fungerar det:

Varje objekt har en egen marknadsföringsapp i Marknadsföring-vyn.
Du aktiverar eller inaktiverar publicering till PLAYipp per objekt direkt från den här vyn.
Det är det enda sättet att styra vilka objekt som visas i PLAYipp.

Tips:

Visas inte ett objekt i PLAYipp? Kontrollera först att det är aktiverat/publicerat i Marknadsföring i Vitec.
Visas ett objekt som inte borde? Inaktivera det i Marknadsföring.

Objektstatus i Vitec

Varje objekt i Vitec har en status som påverkar hur det visas i PLAYipp.

Status	Betydelse	Beteende i PLAYipp
Kundbearbetning	Utkast objektet är ofullständigt	⚠️ Visas tomt/trasigt i PLAYipp
Uppdrag finns	Uppdragsavtal finns	Skickas till PLAYipp om konfigurerat
Snart till salu	Kommer snart	Skickas till PLAYipp om konfigurerat
Kommande	Kommande	Skickas till PLAYipp om konfigurerat
Till salu	Aktivt objekt	Skickas till PLAYipp om konfigurerat
Vilande	Pausat	Skickas till PLAYipp om konfigurerat
Reserverad ej till salu	Reserverat	Skickas till PLAYipp om konfigurerat
Såld	Sålt	Skickas till PLAYipp om konfigurerat
Såld referensobjekt	Referensobjekt	Visas tills det tas bort från Marknadsföring

⚠️ Kundbearbetning viktigt att känna till

Objekt med status Kundbearbetning är inte fullständiga i Vitec, alla obligatoriska fält har inte fyllts i. Dessa objekt visas tomma eller trasiga på skärmen i PLAYipp.

Ser du en tom bild på skärmen? Det är troligtvis detta som är orsaken.

Åtgärd: Slutför objektet i Vitec, eller se till att det inte skickas till PLAYipp via Marknadsföring.

Sålda referensobjekt

Sålda referensobjekt är objekt som mäklaren aktivt vill ha kvar synliga efter försäljning för att visa upp tidigare affärer. De fortsätter att visas på skärmen tills mäklaren tar bort dem från Marknadsföring. Det är ett avsiktligt beteende.

Obs: Om gamla sålda objekt aldrig tas bort från Marknadsföring samlas de på hög i flödet. Se till att rensa bort objekt som inte längre är relevanta.

Fastighetswidgets visningstyper

PLAYipp erbjuder fyra visningstyper för fastighetswidgeten. Alla fyra visar exakt samma data det enda som skiljer dem åt är layout och design.

Alternative

Layout: Helskärmsbilder med ett textblock i mitten.
Status visas: Nej
Beskrivning: Kort beskrivning (faller tillbaka på lång om kort saknas)
Teckenbegränsning: 0 1 000 tecken
Passar för: Att lyfta fram rika objektbeskrivningar i ett stilrent, redaktionellt format.

Landscape

Layout: Horisontell layout med information bredvid bilden.
Status visas: Ja
Beskrivning: Kort beskrivning (faller tillbaka på lång om kort saknas)
Teckenbegränsning: 50 200 tecken
Passar för: Skärmar där du vill visa både bild och nyckelinformation samtidigt.

Portrait

Layout: Vertikal layout med objektinformation.
Status visas: Ja
Beskrivning: Kort beskrivning (faller tillbaka på lång om kort saknas)
Teckenbegränsning: 50 200 tecken
Passar för: Stående skärmar liknar Landscape men i vertikalt format.

Minimal ⭐ Populärast

Layout: Bildfokuserad, ren och minimalistisk design.
Status visas: Nej
Beskrivning: Visas inte
Passar för: Att lyfta fram fastighetsfotografi. Det här är det mest populära valet bland mäklarkontor.

Beskrivningsfält kort och lång

I Vitec finns det två beskrivningsfält per objekt:

Kort säljande beskrivning används i första hand
Lång säljande beskrivning används som reserv om kort saknas

PLAYipp försöker alltid använda den korta beskrivningen först. Finns ingen kort beskrivning inlagd i Vitec byter widgeten automatiskt till den långa.

Rekommendation: Fyll alltid i Kort säljande beskrivning för varje objekt i Vitec. Det är den text som visas på skärmen håll den kärnfull och relevant.

Widget	Teckenbegränsning
Alternative	0-1 000 tecken
Landscape	50-200 tecken
Portrait	50-200 tecken
Minimal	Beskrivning visas inte

Synkroniseringsintervall 20 minuter

PLAYipp hämtar data från Vitec var 20:e minut. Det gäller all Vitec-data: objekt, status, beskrivningar, bilder med mera.

Vad det innebär för dig:

Ändringar du gör i Vitec syns i PLAYipp inom cirka 20 minuter.
Ser du inte en ändring direkt? Vänta 20 minuter innan du börjar felsöka.

Felsökning vanliga problem

Ett objekt visas inte på skärmen

Kontrollera följande steg för steg:

Är objektet publicerat i Marknadsföring i Vitec (PLAYipp-kanalen aktiv)?
Har det gått 20 minuter sedan publiceringen?
Har objektet status Kundbearbetning (utkast)? Slutför i så fall alla obligatoriska fält i Vitec.
Är integrationen aktiv i PLAYipp? (Kontrollera integrationspanelen)

En tom eller trasig bild visas på skärmen

Troligaste orsak: Objektet har status Kundbearbetning i Vitec det är inte fullständigt ifyllt.

Åtgärd: Slutför objektet i Vitec, eller ta bort det från PLAYipps marknadsföringskanal i Marknadsföring.

Sålda objekt fortsätter att visas

Orsak: Sålda objekt är inte borttagna från Marknadsföring, eller integrationen är konfigurerad att skicka sålda referensobjekt.

Åtgärd: Inaktivera objektets marknadsföringsapp i Marknadsföring, eller kontakta Vitec för att uppdatera konfigurationen.

Ett felaktigt objekt visas (ett som inte borde visas)

Orsak: PLAYipp visar allt det tar emot filtrering sker enbart på Vitecs sida.

Åtgärd: Kontakta Vitec och be dem uppdatera integrationskonfigurationen för att exkludera det aktuella objektet.

Ändringar syns inte på skärmen

Orsak: Data synkroniseras var 20:e minut.

Åtgärd: Vänta upp till 20 minuter. Syns ändringen fortfarande inte? Kontakta supporten.

När ska jag kontakta support?

Kontakta PLAYipp-support om:

Integrationen inte tar emot någon data alls (inga objekt visas och integrationen visar fel)
Widgetens visning är trasig på ett sätt som inte beror på datainnehållet

Kontakta Vitec om:

Ett specifikt objekt konsekvent saknas trots att du kontrollerat Marknadsföring och status
För många eller fel objekt skickas
Integrationskonfigurationen behöver ändras (filtrering)

Kom ihåg: PLAYipp styr visningen Vitec styr datan. Datarelaterade problem hanteras alltid av Vitec.

Har du frågor? Hör av dig till PLAYipp-support så hjälper vi dig.