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.
| Term | Definition | Also called | Technical name |
|---|
| Client | The 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) | |
| Universe | One of your brands, as set up in Goodays, with its own graphic charter: logo, colors, texts. Widgets and GEO fragments 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 consumer | universe (API) |
| Universe ID | Identifier of a universe (one of your brands) in widget and GEO fragment 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), client_id (GEO fragment API) | universe_id |
| SDK key | Key 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 token | Secret credential sent in the Authorization header of Goodays API requests. Never expose it in a web page. | API key | |
| Goodays project contact | The 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 | |
| Term | Definition | Also called | Technical name |
|---|
| Point of sale | Any place where Goodays collects feedback: shop, restaurant, agency, mall, website... Each point of sale belongs to one universe. | place, store, shop, establishment, agency, location | place |
| External ID | Your 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, SDK and GEO fragment URLs. | partner ID, POS ID, store code, place (GEO fragment API) | external_id, partner_id (API responses: a historical field name, it has nothing to do with Goodays partners), pos_id (widget URLs) |
| Place ID | Identifier 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 ID | place_id, id on a place object |
| Term | Definition | Also called | Technical name |
|---|
| End customer | The customer of a client, who gives feedback about a point of sale. | customer, respondent | |
| Survey | Set of questions submitted to end customers, configured in Goodays. | questionnaire, quiz | survey |
| Participation | Everything 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), conversation | response (API) |
| Rating | The score an end customer gives in a participation, usually from 1 to 5. | note, mark | in survey answers |
| Verbatim | The free text written by an end customer in a participation. | comment, message, remark | message |
| Review | A participation published for the public: its rating, verbatim, date and author's first name (followed by the last-name initial in GEO fragments), as shown in Showcase widgets and GEO fragments. Reviews collected from Google are also called Google reviews. | public review, user-generated content (UGC) | |
| Score | An indicator calculated from many ratings over a period, such as the Customer Satisfaction score, the Customer Relationship score or the average rating of a GEO fragment. | average rating, note | |
| Reply | The answer a pro user writes to an end customer from the Goodays back office. | answer | reply |
| Pro user | A person from the client's team who uses the Goodays back office to read participations, reply and follow statistics. | user, back office user | |
| Term | Definition | Also called | Technical name |
|---|
| Web SDK | The Goodays JavaScript library you add to your web pages to display widgets. | SDK | |
| Widget | A ready-to-use Goodays component displayed by the Web SDK in the browser: survey button, pop-in, Showcase score, latest comments... | interface | goodays-widget (HTML class) |
| GEO fragment | A ready-made block of HTML with the reviews and structured data of one point of sale, returned by the GEO fragment API and inserted by your server in your page, so that AI assistants and search engines can read it. | fragment | |
