Glossary

The words we use across Goodays developer documentation, and the older names you may still find.

This glossary gives one reference name per notion. Older pages, URLs and parameters may still use another name: they are listed in the Also called column so you can match them.


Your organization

TermDefinitionAlso calledTechnical name
ClientThe company that subscribed to Goodays. A client owns one or more universes and all their points of sale.customer (name used inside some Goodays tools and URLs; in documentation always say client)
UniverseOne of your brands, as set up in Goodays, with its own graphic charter: logo, colors, texts. Widgets are displayed with the look of their universe. For example, a client that runs two restaurant brands has two universes. In other pages, the first mention reads "universe (one of your brands)".brand, banner, enseigne, widget consumeruniverse (API)
Universe IDIdentifier of a universe (one of your brands) in widget URLs, usually built as <client>-<universe> (for example madrigal-los-pollos-hermanos for the Los Pollos Hermanos brand of the Madrigal client). Given by your Goodays project contact.customer_name (widget URLs)universe_id
SDK keyKey that identifies a universe in the Web SDK script URL (https://cdn.goodays.co/sdk/<SDK key>.js). It is visible in your web pages by design. Not to be confused with the API token.API_KEY (Web SDK page)sdk_key
API tokenSecret credential sent in the Authorization header of Goodays API requests. Never expose it in a web page.API key
Goodays project contactThe person at Goodays who follows your project and gives you your identifiers and access.account team, sales representative, Goodays team, Goodays contact, Customer Success Manager (CSM), engagement manager

Points of sale

TermDefinitionAlso calledTechnical name
Point of saleAny place where Goodays collects feedback: shop, restaurant, agency, mall, website... Each point of sale belongs to one universe.place, store, shop, establishment, agency, locationplace
External IDYour own code for a point of sale, as used in your information system (SAP code, store code...), for example ABQ-001. It is set by you, unique per client, and is the identifier you use in widget and SDK URLs.partner ID, POS ID, store codeexternal_id, partner_id (API responses: a historical field name, it has nothing to do with Goodays partners), pos_id (widget URLs)
Place IDIdentifier generated by Goodays for a point of sale (the External ID is yours, the Place ID is Goodays'), returned by the /places endpoint of the Goodays API (for example EFGH5678). Use it only with the Goodays API.Goodays IDplace_id, id on a place object

Feedback

TermDefinitionAlso calledTechnical name
End customerThe customer of a client, who gives feedback about a point of sale.customer, respondent
SurveySet of questions submitted to end customers, configured in Goodays.questionnaire, quizsurvey
ParticipationEverything one end customer submits at once: survey answers, a rating and/or a verbatim, whatever the channel (email, SMS, QR code, website, Google...). It is the base unit of data in Goodays.feedback, response (API), conversationresponse (API)
RatingThe score an end customer gives in a participation, usually from 1 to 5.note, markin survey answers
VerbatimThe free text written by an end customer in a participation.comment, message, remarkmessage
ReviewA participation published for the public: its rating, verbatim, date and author's first name, as shown in Showcase widgets. Reviews collected from Google are also called Google reviews.public review, user-generated content (UGC)
ScoreAn indicator calculated from many ratings over a period, such as the Customer Satisfaction score, or the Customer Relationship score.average rating, note
ReplyThe answer a pro user writes to an end customer from the Goodays back office.answerreply
Pro userA person from the client's team who uses the Goodays back office to read participations, reply and follow statistics.user, back office user

Integration

TermDefinitionAlso calledTechnical name
Web SDKThe Goodays JavaScript library you add to your web pages to display widgets.SDK
WidgetA ready-to-use Goodays component displayed by the Web SDK in the browser: survey button, pop-in, Showcase score, latest comments...interfacegoodays-widget (HTML class)