Brukerdokumentasjon Mamut Webforms av 3 PROSJEKT NR. -34 Studieprogram: Postadresse: Postboks 4 St. Olavs plass, 030 Oslo Besøksadresse: Holbergs plass, Oslo TILGJENGELIGHET Åpen Telefon: 22 45 32 00 Telefaks: 22 45 32 05 BRUKERDOKUMENT HOVEDPROSJEKTETS TITTEL System for generering av webskjemaer for Mamut ASA DATO 24.05.20 ANTALL SIDER 3 PROSJEKTDELTAKERE Kjetil Hårtveit, s5550 INTERN VEILEDER Alfred Bratterud OPPDRAGSGIVER Mamut ASA KONTAKTPERSON Espen Johannessen SAMMENDRAG Systemet som er utviklet brukes til å generere webskjemaer. Hensikten med systemet er å øke datakvalitet ved å fjerne manuelle rutiner, redusere svinn av leads og øke salg gjennom bedre oppfølging av leads. Systemet er utviklet med Microsoft teknologier C#/ASP.NET med MSSQL og Windows Service. 3 STIKKORD Mamut Webforms Webskjemagenerering.NET
Brukerdokumentasjon Mamut Webforms 2 av 3 Innholdsfortegnelse. Introduksjon... 3. Om manualen... 3.2 Ordforklaring... 3 2. Om systemet... 4 2. Målet med systemet... 4 2.2 Hva kan systemet gjøre?... 4 2.3 Introdusering i bruk av systemet... 5 3. Brukerveiledning... 6 3. Webutvikleroppgaver... 6 3.. Hvordan oppretter man skjema?... 6 3..2 Hvordan generer man skjemakode?... 6 3..3 Hvordan fletter man inn skjema på nettside?... 6 3.2 Markedsføreroppgaver... 7 3.2. Hvordan henter man URL parameter ved skjemainnsending og registrerer det som prosjektkode?... 7 3.2.2 Hvordan henter man egendefinerte URL parametre ved skjemainnsending?... 7 3.2.3 Hvordan eksporterer man leads manuelt?... 7 3.2.4 Hvordan henter endrer man tidspunktet for automatisk eksportering?... 7 3.2.5 Hvordan endrer man hvor lang tid det tar før No lead detection feil utløses?... 8 4. Referanse... 9 4. Seksjon: User... 9 4.. Login... 9 4..2 Change password... 0 4.2 Seksjon: Forms... 4.2.3 Create form... 4.2.4 List all... 2 4.2.5 Edit info... 3 4.2.6 Edit fields... 4 4.2.7 Generate code... 5 4.2.8 Form data... 7 4.3 Seksjon: Categories... 8 4.3. Create category... 8 4.3.2 List all... 9 4.3.3 Edit category... 20 4.4 Seksjon: Analysis... 2 4.4. Google Utmccn... 2 4.4.2 Project url parameters... 22 4.4.3 Custom url parameters... 23 4.5 Seksjon: Export... 24 4.5. Manual export... 24 4.5.2 Automatic export basic settings... 25 4.5.3 Automatic export advanced settings... 26 4.6 Seksjon: Logging... 28 4.6. Settings... 28 4.7 Seksjon: Demo... 29 4.7. Landingsside... 29 4.7.2 Update form... 30 5. Stikkordliste... 3
Brukerdokumentasjon Mamut Webforms 3 av 3. Introduksjon. Om manualen Denne manualen er beregnet på brukere av Mamut Webforms systemet. Det er hovedsakelig to forskjellige typer brukere som vil bruke dette systemet: webutviklere og markedsførere involvert i sporing og innsamling av leads. Det forutsettes at de er kjent med det gamle CMS systemet Mamut bruker og for markedsførere forutsettes det at de er kjent med noe Google analytics terminologi. Manualen er delt inn i to hoveddeler: brukerveiledning og referanse. Brukerveiledningen inneholder prosedyrer og rutiner for å fullføre enkelte oppgaver, mens referansen viser en oversikt over alle funksjonene i systemet..2 Ordforklaring Ord/uttrykk Skjema Kategori Lead Utmccn Url parameter Betydning Ett webskjema som ofte inkluderes på landingssider for å registrere informasjon for brukere. Skjemaer kan bli gruppert etter kategorier. En individuell skjemainnsending gjennom ett webskjema med informasjon som gjør at innsenderen kan oppfølges som en potensiell kunde. En cookie verdi som brukes av Google Analytics som sier noe om hvordan brukeren har funnet frem til nettstedet. En parameter i spørredelen av en URL. En url parameter er den uthevede delen av denne eksempel urlen: http://www.example.com?urlparam=50
Brukerdokumentasjon Mamut Webforms 4 av 3 2. Om systemet 2. Målet med systemet Mamut ASA ønsket ett å få utviklet ett nytt system for å generere webskjemaer for innsamling av lead fra kampanjeaktiviteter. Det eksisterende CMS systemet og den eksisterende rutinen for registrering av leads hadde svakheter som både hadde negativ virkning på det totale salget og tilgjengelige ressurser. Det nye systemet har som mål å strømlinjeforme og automatisere leadinnsamlingen så mye som mulig og dermed løse opp flokene som er tilstede. Oppsummert skal det gi følgende fordeler: Ressursbesparelser gjennom automatisering av rutineoppgaver. Øke datakvalitet ved å fjerne manuelle rutiner. Gir bedre informasjon i forhold til hvilke prosjekter som selger. Reduserer svinn av leads. Øke salget gjennom bedre oppfølging av leads. 2.2 Hva kan systemet gjøre? Følgende aktiviteter er mulige i Mamut Webforms: Innlogging og utlogging av systemet. Endring av brukerpassord. Opprettelse og håndtering skjema. o Generering av kode. o Visning av innhentet data. Opprettelse og håndtering av kategorier. Automatisk og manuell eksportering av leads (skjemadata) til CSV format med fast kolonnebredde. Endre innstillinger for lagring av informasjon for analyseringsbruk. Endre innstillinger for loggføring av systemtilbakemeldinger.
Brukerdokumentasjon Mamut Webforms 5 av 3 2.3 Introdusering i bruk av systemet Som tidligere nevnt er det hovedsakelig to typer brukere av systemet: webutviklere og markedsførere. Webutviklere oppretter, fletter inn og vedlikeholder webskjemaer mens markedsførere konfigurerer innstillinger for sporing og innsamling av leads. Markedsførere, men også potensielt brukere innenfor salg, har nytte av å kontrollere og eksporterer skjemadata. Under vises kjernen i bruk av systemet, fra opprettelsen av webskjema til leadinnsamlingen. Vanlig hendelsesforløp ved bruk av Mamut Webforms
Brukerdokumentasjon Mamut Webforms 6 av 3 3. Brukerveiledning 3. Webutvikleroppgaver 3.. Hvordan oppretter man skjema?. Navigerer deg til menyen der det står Forms. 2. Trykk på Create i undermenyen. 3. Fyll inn ønskede skjema detaljer. 4. Trykk på Create knappen for å opprette skjema. Referanse: Create form 3..2 Hvordan generer man skjemakode?. Sørg for at du har generert ett skjema. For hjelp les her: Hvordan oppretter man skjema? 2. Navigerer deg til skjemaet du ønsker å generere kode for gjennom Forms (list all) siden. 3. Trykk på Code tabben. 4. Konfigurer ønskede genererings innstillinger. 5. Trykk på View Source knappen for å generer skjemakoden. Tips: Preview knappen viser deg hvordan skjemaet ser ut i HTML. Tips 2: Highlights content lenken merker den genererte skjemakoden for deg automatisk. Referanse: Create form List all Generate code 3..3 Hvordan fletter man inn skjema på nettside?. Først trenger du å generere koden for skjemaet. For hjelp les her: Hvordan generer man skjemakode? 2. Merk og kopier skjemakoden. 3. Lim inn koden i nettsidens kildekode (eller gjennom ditt favoritt CMS system) der du ønsker å plassere skjemaet. Referanse: Generate code
Brukerdokumentasjon Mamut Webforms 7 av 3 3.2 Markedsføreroppgaver 3.2. Hvordan henter man URL parameter ved skjemainnsending og registrerer det som prosjektkode?. Naviger deg til Analysis elementet i menyen. 2. Trykk på Project URL parameters i undermenyen. 3. Legg til en ny URL parameter verdi eller endre en eksisterende parameter. Etter dette vil URL parameteren hentes ved fremtidige skjemainnsendinger og registreres i Project feltet. Referanse: Project url parameters 3.2.2 Hvordan henter man egendefinerte URL parametre ved skjemainnsending?. Naviger deg til Analysis elementet i menyen. 2. Trykk på Custom URL parameters i undermenyen. 3. Legg til en ny URL parameter verdi eller endre en eksisterende parameter. Etter dette vil URL parameteren hentes ved fremtidige skjemainnsendinger og registreres til det tilknyttede CustomParameter feltet. Referanse: Custom url parameters 3.2.3 Hvordan eksporterer man leads manuelt?. Naviger deg til Export elementet i menyen. 2. Trykk på Manual export i undermenyen. 3. Oppgi ønskede filtreringsinnstillinger. 4. Trykk på Export knappen. 5. Lagre eller åpne den genererte CSV filen. Referanse: Manual export 3.2.4 Hvordan henter endrer man tidspunktet for automatisk eksportering?. Naviger deg til Export elementet i menyen. 2. Trykk på Automatic export settings i undermenyen. 3. Lokaliser feltet Run export.
Brukerdokumentasjon Mamut Webforms 8 av 3 4. Endre intervall og tidspunkt etter ønske. 5. Trykk på Update for å lagre innstillingene. Forandringen vil bli reflektert i Mamut Webform Servicen så fort den snakker med databasen, derfor kan det hende at du ikke opplever en øyeblikkelig endring. Referanse: Automatic export basic settings 3.2.5 Hvordan endrer man hvor lang tid det tar før No lead detection feil utløses?. Naviger deg til Logging elementet i menyen. 2. Trykk på Settings i undermenyen. 3. Lokaliser feltet No lead detection trigger time. 4. Endre antall timer du vil det må gå før No lead detection feilen utløses. Referanse: Settings
Brukerdokumentasjon Mamut Webforms 9 av 3 4. Referanse 4. Seksjon: User 4.. Login Side for å logge seg inn på systemet. 2 3 Brukernavn. Passord. Om du ønsker å bli logget inn automatisk neste gang du besøker siden.
Brukerdokumentasjon Mamut Webforms 0 av 3 4..2 Change password Her kan man endre passordet sitt. Gammelt, nytt og bekreftelse på nytt passord.
Brukerdokumentasjon Mamut Webforms av 3 4.2 Seksjon: Forms 4.2.3 Create form Her kan man opprette nytt skjema. 2 3 Skjemaets navn. Landet skjemaet skal bli knyttet til. Kategorien skjemaet skal knyttes til.
Brukerdokumentasjon Mamut Webforms 2 av 3 4.2.4 List all Denne siden lister opp alle skjemaene som er opprettet. Her kan du velge antall skjemaer som skal vises på en gang. Velg verdien show all om du vil at alle skjemaene skal vises samtidig. 2 3 Her kan du søke på skjemaets ID. Du kan velge å sortere skjemaene på alle de forskjellige kolonnene enkelt ved å trykke på en av dem. Ved å trykke på en kolonne som allerede er valgt vil det sorteres reversert. ID: Skjemaets ID. Name: Skjemaets navn. Category: Kategorien skjemaet hører til. Country: Landet skjemaet hører til. Date created: Når skjemaet ble opprettet. Last submittion: Når siste lead ble sendt inn med webskjema. Total submits: Totalt antall leads registrert. 4 For å gå til side med detaljer for skjemaet siden trykk på skjema navnet.
Brukerdokumentasjon Mamut Webforms 3 av 3 4.2.5 Edit info Her kan man endre generell informasjon og oppførsel vedrørende ett spesifikt skjema. 2 3 4 5 6 Her vises generell informasjon om skjemaet. Her kan du endre skjemaets navn. Her kan du endre kategorien skjemaet hører til. Her kan du spesifisere en side hvor brukeren blir omsendt etter å ha sendt inn webskjema. Hvis feltet er tomt vil brukeren bli sendt tilbake til siden skjemaet befant seg på. Her kan du spesifisere en tilbakemelding-/takkemail som sendes til brukeren etter å ha innsendt skjema. Om No lead detection skal brukes på dette skjemaet. Hvis ja så vil en feil utløses om skjemaet ikke har fått inn ett lead innen ett spesifisert antall timer.
Brukerdokumentasjon Mamut Webforms 4 av 3 4.2.6 Edit fields Her endrer man skjemaets felter. 2 3 4 5 6 Om feltet skal være aktivt. Uaktive felt blir ikke generert med Generate code funksjonen. Her kan man endre hvert enkelt felts navn. Dette navnet brukes ved generering av skjemakode på Generate code siden. Engelsk navn på feltet, slik at man alltid kjenner feltets betydning selv når skjemaet bruker ett annet språk. Hvilken rekkefølge feltet vil vises ved generering av skjemakode på Generate code siden. Feltets skjematype. Dette sier hvordan feltet skal tolkes og har direkte sammenheng med hva slags valideringer og liknende som knyttes til feltet. Om skjemaet må fylles ut ved innsending av skjemaet. Konkret betyr dette at en validering vil skrike opp om ingen verdi finnes i feltet.
Brukerdokumentasjon Mamut Webforms 5 av 3 4.2.7 Generate code Her genererer man koden for skjema. Hva slags mal som skal brukes for skjemaet. Simple Inside: Vanlig mal med feltnavnene som felt tekst. Simple Outside: Vanlig mal med feltnavnene til venstre for feltene, mens feltene står tomme. 2 Om det skal legges til ett script på feltene som vasker verdien når man trykker på feltet, og at den originale verdien settes på feltet om verdien er tom. Dette gjelder bare for Simple Inside malen. 3 4 Bredden på skjemaet. Her kan man spesifisere hvordan innsendingsknappen skal se ut. Text: Vanlig submit innsendingsknapp og tekst. Image: Innsendingsknappen er ett bilde og det kan også spesifiseres et rollover bilde. 5 6 7 Kode som legges til i onclick attributtet på innsendingsknappen. Kode som legges til i onsubmit attributtet på skjemaet. Om ajax kall skal brukes for å hente valideringsmeldinger.
Brukerdokumentasjon Mamut Webforms 6 av 3 8 9 0 Genererer skjemakode og viser det i kildekode form. Genererer skjemakode og viser det i HTML form. Merker skjemakoden som er generert.
Brukerdokumentasjon Mamut Webforms 7 av 3 4.2.8 Form data Her vises all data som er blitt innsendt med skjema. 2 3 4 5 6 7 8 Leadets ID. Datoen leadet ble sendt inn. Hovedfeltene i skjema. Valgfrie felter. Nettadressen skjemaet befant seg på når leadet ble sendt inn. Prosjektverdien som hentes fra nettadressen. Hvilke parametre den sjekker kan spesifiseres på Project url parameters siden. Google analytics utmccn verdien som hentes fra cookie. Egendefinerte url parametre. Disse kan spesifiseres på Custom url parameters siden.
Brukerdokumentasjon Mamut Webforms 8 av 3 4.3 Seksjon: Categories 4.3. Create category Her kan man opprette kategorier. Navnet på kategorien.
Brukerdokumentasjon Mamut Webforms 9 av 3 4.3.2 List all Her vises alle kategoriene som er opprettet i systemet. Her kan du velge antall kategorier som skal vises på en gang. Velg verdien show all om du vil at alle kategoriene skal vises samtidig. 2 Du kan velge å sortere skjemaene på alle de forskjellige kolonnene enkelt ved å trykke på en av dem. Ved å trykke på en kolonne som allerede er valgt vil det sorteres reversert. ID: Kategoriens ID. Name: Kategoriens navn. 3 For å gå til side med detaljer for skjemaet siden trykk på skjema navnet.
Brukerdokumentasjon Mamut Webforms 20 av 3 4.3.3 Edit category Her kan man endre kategorier. Navnet på kategorien.
Brukerdokumentasjon Mamut Webforms 2 av 3 4.4 Seksjon: Analysis 4.4. Google Utmccn Her kan man endre innstillinger for lagring av Google Analytics sin utmccn cookie verdi. Om Google Analytics sin utmccn verdi skal lagres med hver skjemainnsending eller ikke.
Brukerdokumentasjon Mamut Webforms 22 av 3 4.4.2 Project url parameters Her kan man endre innstillinger for henting av prosjektkoden fra URLen ved skjema innsending. 2 3 Om parameteren skal slettes. Navnet på parameteren som skal letes etter i URLen. Parameterens prioritet. Hensikten med denne verdien er å unngå kollisjoner hvis to eller flere parametre finnes i URLen. Lavere tall tilsier høyere prioritet.
Brukerdokumentasjon Mamut Webforms 23 av 3 4.4.3 Custom url parameters Her kan man spesifisere egendefinerte parametre som skal bli hentet fra URLen ved skjema innsending. 2 Navn på parameter som skal letes etter i URLen. Type definisjonen til parametrene.
Brukerdokumentasjon Mamut Webforms 24 av 3 4.5 Seksjon: Export 4.5. Manual export Her kan man eksportere leads til CSV fil og filtrere disse på visse verdier. 2 3 4 Hvilke land eksporteringen skal filtreres på. Hvilken kategori eksporteringen skal filtreres på. Start dato for eksporteringen. Slutt dato for eksporteringen.
Brukerdokumentasjon Mamut Webforms 25 av 3 4.5.2 Automatic export basic settings Her kan man endre basiske innstillinger for automatisk eksportering av leads. 2 3 Med hva slags intervall den automatiske eksporteringen skal foretas. Om bare tidligere ueksporterte leads skal eksporteres, eller om alle leads innenfor tidsrommet mellom forrige eksportering og den gjeldende eksporteringen skal inkluderes. Her kan man kontrollere om automatisk eksportering skal være aktiv eller ikke.
Brukerdokumentasjon Mamut Webforms 26 av 3 4.5.3 Automatic export advanced settings Her kan man endre avanserte innstilinger for automatisk eksportering av leads. Tilkoblingsinnstillinger for SFTP serveren som det lastes opp filer til ved automatisk eksportering. Host: Hostnavn. Username: Brukernavn. Port: Porten som brukes. Destination directory: Stien filene lastes opp til på SFTP serveren. Private key: Den private nøkkelen som brukes til å verifisere tilkoblingen. 2 3 4 5 6 Hvor ofte servicen skal sende spørring til databasen for oppdateringer. Hvis en e-post konto er spesifisert her så vil leads bli sendt til denne kontoen i tillegg til opplastningen. Parameter verdi som er nødvendig for å starte automatisk eksportering på webserveren. URLen som vil bli spørret av servicen for å foreta automatisk eksportering. Denne knappen oppdaterer request urlen automatisk. Den tar domenet og trigger parmeter verdien til betraktning og lager en gyldig request url.
Brukerdokumentasjon Mamut Webforms 27 av 3 7 Denne knappen sjekker at SFTP innstillingene er korrekte.
Brukerdokumentasjon Mamut Webforms 28 av 3 4.6 Seksjon: Logging 4.6. Settings Her kan man endre innstillinger for loggføring. 2 Hvis oppgitt så sendes nye logginnføringer til denne e-post kontoen. Her kan man spesifisere hva slags loggtyper som skal bli sendt med e-post. Database errors: Feil under kommunikasjon med database. Export errors: Feil under automatisk eksportering. Service errors: Feil som oppstår i servicen. No lead detection errors: Feil som utløses når skjema ikke har fått leads innenfor en spesifisert tidsramme. 3 Hvor lang tid det må gå før en feil utløses hvis ikke skjema har fått en skjemainnsending.
Brukerdokumentasjon Mamut Webforms 29 av 3 4.7 Seksjon: Demo 4.7. Landingsside Demo landingssiden er ment for å teste skjemaer før de blir offentliggjort. 2 Lenken tar deg tilbake til Mamut Webforms systemet. Her inkluderes skjemaet som er lagret på Update form siden.
Brukerdokumentasjon Mamut Webforms 30 av 3 4.7.2 Update form Her kan man endre skjemakoden som blir brukt på Landingsside siden. Koden i dette feltet blir brukt på Landingsside siden. En vanlig prosedyre er først å generere skjemakoden for ett skjema, for å så kopiere og lime inn koden i dette feltet. Deretter kan man gå på landingssiden for å teste skjemaet både visuelt og funksjonelt.
Brukerdokumentasjon Mamut Webforms 3 av 3 5. Stikkordliste C CMS... 4; 6 CSV... 4; 7; 24 E eksportering... 4; 7; 25; 26; 28 automatisk... 4; 7 manuell... 4; 7 G Google Analytics... 3; 2 K kategori... 3; 4; 8; 9; 20 kildekode... 6; 6 L lead... ; 3; 4; 5; 7; 2; 24; 25; 26; 28 loggføring... 4; 28 M Mamut Webforms... ; 3; 4; 5; 29 markedsfører... 3; 5; 7 N no lead detection... 8; 3 S skjema... 3; 6 skjemainnsending... 3; 7; 2; 28 skjemakode... 6; 4; 6; 30 sporing... 3; 5 U URL... 3; 7 url parameter... 3 utmccn... 3; 2 W webskjema... ; 3; 4; 5; 2; 3 webutvikler... 3; 5; 6