Hvordan Axon kan hjelpe deg med å integrere FINN.NO i appen din

86% av kundene er villige til å betale mer for en bedre brukeropplevelse.

Enhver moderne app som tilbyr en sømløs og effektiv brukeropplevelse, ligger godt an. En måte å forbedre appens funksjonalitet og rekkevidde på er å integrere populære plattformer.

Finn.no, Norges største nettmarkedsplass, tilbyr et omfattende API som lar utviklere integrere funksjonene direkte i sine applikasjoner. Integrering av Finn.no kan dermed berike appens tilbud betydelig.

I dette blogginnlegget vil vi veilede deg gjennom trinnene for integrering med Finn.no i appen din. Vi vil dekke alle backend-trinnene du trenger for å komme i gang. Ved slutten av denne veiledningen vil du ha en klar forståelse av hvordan du kan bruke API-et til Finn.no for å forbedre appens funksjoner og gi mer verdi til brukerne dine.

Mer om Finn.no

Finn.no er en norsk digital markedsplass som tilbyr en omfattende plattform for kjøp, salg og tjenester. Siden etableringen i 2000 har Finn.no blitt et velkjent navn i Norge med kategorier som eiendom, kjøretøy, jobber og rubrikkannonser. Med millioner av annonser og et brukervennlig grensesnitt, kobler Finn.no effektivt kjøpere og selgere. Plattformens robuste søke- og filtreringsfunksjoner samt brede rekkevidde gjør det enkelt for brukerne å finne det de leter etter, enten det er et nytt hjem, bil eller jobbmuligheter.

Fordeler med Finn.no-integrering

‍
Integrering av Finn.no i appen din er et strategisk grep som kan gi betydelige fordeler for bedrifter. Ved å utnytte Finn.no sine omfattende og varierte oppføringer kan appen din tilby brukerne en rikere og mer helhetlig opplevelse, noe som øker engasjement og tilfredshet. For bedrifter betyr dette å tiltrekke seg et større publikum og nye kundegrupper. Finn.no sitt pålitelige og veldokumenterte API sikrer en jevn integrasjon. Finn.no API-integrasjon kan betydelig forbedre appens funksjonalitet ved å gi tilgang til et bredt utvalg av eiendommer, jobbannonser og rubrikkannonser.

Hvordan integrere Finn.no i appen din

Kom i gang
FINN.no-integrering er basert på REST API, hvor import til FINN.no skjer via XML-filer.

Før opplasting må annonsøren være registrert i FINN-systemet og motta en ID som plasseres i <PARTNER>-taggen. Filer med ukjent partner-ID blir ikke behandlet.
Leverandøren må også identifiseres ved å gi en provider-ID i <PROVIDER>-taggen. Du kan velge din egen provider-ID, så lenge den ikke allerede eksisterer som en ID i FINN-systemet og du har informert FINN om hva din provider-ID er, slik at de kan registrere det i systemet.

Det finnes DTD-filer for hver annonsetype og separate DTD-er for salgsinformasjon, stopping av annonser og overføring av multimediainnhold (bilder, logoer, dokumenter, osv.). Ved integrering med FINN.no tilbys HTTP-opplasting (REST) for filoverføring.

REST/HTTP-Opplasting

Du kan laste opp en enkel XML-fil eller en zip-fil. Hvis du laster opp bilder, må du bruke en zip-fil. I henhold til IAD-response DTD, vil responsen være en XML-streng.

En annonse i systemet defineres av den unike kombinasjonen av elementene <PARTNER> og <ORDERNO>. Hvis en annonse med denne kombinasjonen allerede eksisterer, vil en oppdatering bli utført. Denne kombinasjonen blir også brukt for å legge til ekstra informasjon, dvs. bilder til annonsen.

Opplastings-URL:

https://import.finn.no/finn/import/fileimport (testmiljø)

https://www.finn.no/finn/import/fileimport (produksjonsmiljø)

Enhver opplasting vil resultere i en XML-fil i henhold til DTD IADIF-objectresponse.dtd. Denne filen vil returneres ved en HTTP-transport.

DTD-er

Alle DTD-er er tilgjengelige på www.iad.no/dtd/. I de fleste tilfeller har hver annonsetype sin egen DTD. I tillegg brukes et sett med felles DTD-er for å administrere en annonses livssyklus eller legge til mer informasjon.

IADIF-head

Definerer starten på enhver XML-fil som leveres til iad-systemet.

IADIF-objecthead

Inkluderes i en annen DTD og definerer vanlige elementer i annonsen.

IADIF-objecthead-product

Ligner IADIF-objecthead, men inkluderer også valg av ulike produkter.

IADIF-mmo

Denne DTD-en definerer hvordan bilder og grafiske elementer lastes opp.

IADIF-salesinfo

Definerer hvordan man kan lage en XML-fil for å merke en annonse som solgt eller fjernet.

IADIF-stop

Beskriver hvordan en annonse stoppes eller fjernes. Annonsen vil umiddelbart bli tatt offline.

Valideringer

Filstruktur

Filen vil bli validert med en standard XML-parser. Alle opplastede filer må være gyldige i henhold til en av de støttede DTD-ene. Filer som ikke er korrekt dannet, vil bli avbrutt. Eventuelle tagger som ikke er definert i DTD-en, vil ikke bli lest.

Annonse

Alle annonser vil bli validert mot partnerens kontrakter. Annonser som ikke passer inn i kontraktene, vil ikke bli publisert.

Alvorlighetsgrader

1. Fatal: En fatal feil kan enten være en midlertidig systemfeil eller en feilskrevet XML. Konsekvensen er at annonsen ikke vil bli lagret i databasen.
2. Feil: En feil kan oppstå når annonsen ikke samsvarer med kontrakten, eller innholdet i annonsen er dårlig. Denne alvorlighetsgraden resulterer i at annonsen ikke blir publisert.
3. Advarsel: Kan oppstå når obligatoriske elementer mangler.
4. Informasjon: Typisk når systemet sjekker elementer, og dette mislykkes.

Nyttig informasjon

I Finn.no-integrasjonen inneholder XML-responsfilen en URL til en statistikk-side for hver annonse.

URL-en kan se slik ut: http://www.finn.no/adstats.html?finnkode=xxxxxxxxx&s=ae192a02834fbf06e581e2d5a64f84840743960e518c9b7d8bee47a1100ae15c.

Dette inkluderer antall klikk, e-postvarsler, push-varsler og favorittmarkeringer. Du kan få statistikk for en enkelt annonse eller for alle annonser eid av en organisasjon. E-postadresser angitt i XML-filen eller innen admin-modulen vil motta en kort melding når en fil lastes opp.

Konklusjon

Ved å følge trinnene beskrevet i denne guiden kan du sømløst gjennomføre Finn.no API-integrasjon med omfattende oppføringer og tjenester, noe som gir brukerne dine en rikere og mer helhetlig opplevelse. Enten du ønsker å legge til eiendomslister, jobbannonser eller andre rubrikkannonser, vil integreringen med Finn.no sitt API spare deg for utviklingstid og -innsats.

Start Finn.no-integrasjonen i dag og utnytt det enorme potensialet i appen din. Kontakt oss i dag for å diskutere appintegrasjonene dine!