README.md

AVMS (Automated Voucher Management)

🚀 Customer Survey with Automated Voucher Management System

This project offers a cost-effective, fully integrated solution for:

⚙️ Collecting customer feedback

⚙️ Automated form submission Email

⚙️ Rewarding participation with discount vouchers

⚙️ Resubmission handling (9.7.2024)

⚙️ Managing voucher expiration and usage

It leverages the free tier capabilities of:

Google Apps Script Google AppSheet Google Forms Google Docs Google Sheets

🚦 Apps created with AppSheet can be used free of charge by 10 users!
🚦 I don't explain how to create the service point app using AppSheet in this document. There are lots of good tutorials that help create your app in just 1 hour. I share links at the end.

Solution Benefits:

1. Increase response rates by incentivizing participation with discount vouchers just after submiting the form.
2. Automate email responses with vouchers upon survey completion, and integrating the system with voucher managagement app.
3. Manage voucher expiration and usage efficiently and with multiple users.
4. User device independant.

Problem definition

I wanted to run a survey for analyzing customer satisfaction and value creating elements for customers of a local cafe. I wanted to collect 250 responses at least. So, negotiated with cafe manager to provide a discount for all participants and also a raffle. We needed a reliable voucher generation and management system that

• Sends automated form submission "thank you" emails containing vouchers
• Tracks voucher usage and expiration at the service point
• Service usage be easy for survey respondents and cafe personel
• It should be free!

Solution (steps to follow)

1. Create a Google Form to collect customer feedback. A Google form containing description and survey questionnaire. Don't forget to add email validity checks in the form if you are collecting emails as a non required field. example:

   ^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$

2. Connect the form to a Google Sheet
3. Create a Google Doc using "Send curated content email template.docx" in the repository. Texts in curly brackets like {{text}} are used as varables in the code.gs; you can edit the document but keep those. otherwise remember to edit the Apps Script code too. From Share click on the Copy link, and keep it for later (in a note :D )

4. Generate random vouchers in a sheet document using a formula function. You can use following formula to generate a **seven** charachter string. customize it for your need.

=CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))& CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))&CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))& CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))&CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))& CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))&CHOOSE(RANDBETWEEN(1;2);CHAR(RANDBETWEEN(65;90)); CHAR(RANDBETWEEN(97;122)))

6. Create a spead Sheet using the sample vouchers.xlsx file in the repository. Paste your column of vouchers in the table. Let other columns and cell structures as it is. From Share click on the Copy link, and keep it for later (in the same note :D )

7. Open the survey responses spreadsheet connected to your form, then click Extensions > Apps Script.

   a. copy Code.js file content in the repository and paste it to the code.gs in the Apps Script project.
   b. change the url in const EMAIL_TEMPLATE_DOC_URL = "url" with email template Doc link.
   c. change the url in const VOUCHERS_SHEET_URL ="url" with voucher reference sheet link.
   d. Edit const EMAIL_SUBJECT = "text" and const EMAIL_BCC = "adress_1@email.com, address_2@email.com" and const EXPIRATION_DURATION_IN_DAYS = 14 based on your preference.
   e. In the function dropdown, select installTrigger.
   f. Click Run.
   g. When prompted, authorize the script. If the OAuth consent screen displays the warning, This app isn't verified, continue by selecting Advanced > Go to {Project Name} (unsafe).

   🚨 Important: If you run installTrigger more than once, the script creates multiple triggers that each send an email when a user submits the form. To delete extra triggers and avoid duplicate emails, click Triggers alarm. Right-click on each extra trigger and click Delete trigger. you can delete this function from code and do the trigger installation manually from Apps Script.

Test automated email response

Switch back to the survey responses spreadsheet and click Tools > Manage form > Go to live form. Fill out the form and click Submit. Check your email for an email with links to the content you selected. you can check other email addresses that you entered as BCC. If you look into the vouchers spread sheet, you should notice new information. 🍀 I Hope everything works fine till here.

Voucher Management App

You need a voucher management app at the service point to check validity of each discount voucher and mark that it is used or not: and do all this in realtime and multiuser. I used Google AppSheet to quickly create the app. App can be used in mobile phone and computers and you can limit the users by requiring signin if you use the premium service. The service is no code, so I can not effectively reflect what I did to create the app. But I highly suggest you to visit this tutorial. You can find a lot more in youtube and specially AppSheet help center. I share screenshot of the app I created to give you ideas:

Disclaimer: This solution and code is provided "as is" without warranty of any kind, express or implied. The author are not responsible for any damages or losses arising from the use of this code. Consider that this solution is aimed for personal use and app users are considered trusted parties of the main user. Consider GDPR and personal data requirements in managing surveys.