Exploit the full potential of your data!

You want to use the data collected by Goodays without having to recalculate everything on your side? You want consistency between Goodays Back Office and the rest of your tools? Let's get started!

The Metrics API allows you to retrieve very easily - in JSON format - all the data calculated by Goodays.

720

Presentation

The Metrics API allows you to retrieve all the statistics calculated from the data collected by Goodays using the same filters as in the Goodays Back Office.

This is essential to ensure consistency between what a Local Manager sees in Goodays vs. other internal tools.

For example with the metrics API you can:

  • Facilitates the retrieval of statistics
  • Easy integrate data in your CRM
  • Generate reports that meet your needs 100%.
  • Enhance the value of the data collected on your intranet or your store pages
  • And many more!

The metrics approach

Our Metrics API allows you to retrieve Goodays statistics according to 5 different themes:

Customer-Relationship score

The Customer-Relationship score is one of Goodays key performance indicators.

This KPI takes three criteria into account:

  • Reply rate: Does the store respond to all these messages from customers?
  • Reply time: How long does it take for the store to respond to these messages?
  • Reply quality: Score given by your customers when they receive a response from the store.

The score displayed on the interface is updated in real time, and takes into account the messages received and processed during the month.

How do I get my Customer-Relationship score?

See our dedicated page: Customer-Relationship score

curl --location --request GET 'https://api.goodays.co/v2/stats/relationship' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "reply_rate": 79.97107975717982,
            "reply_time": 182097,
            "reply_quality": 4,
            "customer_service_rating": 3.492065770743145
        }
    ]
}

Customer-satisfaction score

The Customer-Satisfaction score is an average calculated on the basis of the customers’ answers to all the star questions from the published surveys.

That score can then be analysed over any period of time, or the focus can be narrowed to any given survey, the NPS, a particular establishment, or any other analysis filter you wish to apply.

How do I get my Customer-Satisfaction score?

See our dedicated page: Customer-Satisfaction Score.

curl --location --request GET 'https://api.goodays.co/v2/stats/satisfaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "average": 4.415842247536645,
            "ratings_count": 4745,
            "responses_count": 1760
        }
    ]
}

NPS

The NPS (Net Promoter Score) is an indicator calculated from a very specific question about the customer's intention to recommend you to others.

The question used in the pathway is:
“Would you recommend this establishment to your friends and family?”
The answer is on a scale of 0 to 10.

The NPS is used to sort respondents into three main categories:

  • DETRACTORS”, who gave a score between 0 and 6
  • PASSIVES”, who gave a score of 7 or 8
  • PROMOTERS”, who gave a score of 9 or 10

That score can then be analysed over any period of time, or the focus can be narrowed
to any given survey, a particular establishment, or any other analysis filter you wish to apply.

How do I get my NPS score?

See our dedicated page: NPS - Net Promoter Score.

curl --location --request GET 'https://api.goodays.co/v2/stats/nps' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "count": 534522,
            "score": 50,
            "detractor": {
                "count": 52234,
                "percentage": 9.772095442283012
            },
            "passive": {
                "count": 160222,
                "percentage": 29.974818622994004
            },
            "promoter": {
                "count": 322066,
                "percentage": 60.25308593472298
            }
        }
    ]
}

Google Score

The Google Score is the public rating of your establishment on Google My Business.

That score can then be analysed over any specific month, or the focus, a particular establishment or any other analysis filter you wish to apply.

How do I get my Google Score?

See our dedicated page: Google Score.

curl --location --request GET 'https://api.goodays.co/v2/stats/google_score' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "public_rating": 4.06,
            "public_rating_count": 177135,
            "places_count": 70,
            "monthly_rating": 4.23,
            "monthly_rating_count": 2510,
            "action_phone_count": 23916,
            "action_website_count": 34752,
            "itinerary_count": 17254,
            "views_count": 394184,
            "rating_distribution": [
                {
                    "value": 1,
                    "count": 166
                },
                {
                    "value": 2,
                    "count": 118
                },
                {
                    "value": 3,
                    "count": 192
                },
                {
                    "value": 4,
                    "count": 542
                },
                {
                    "value": 5,
                    "count": 1492
                }
            ]
        }
    ]
}

Remarks

A remark is the message left by the End Customer. It can be typed as Idea, Praise, Problem or Question.

The discussion between the Local Manager and the End Customer after the first comment from the End Customer is typed as a "Message".

How do I get my Remarks metrics?

See our dedicated page: Remarks metrics.

curl --location --request GET 'https://api.goodays.co/v2/stats/remarks' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "count": 150397,
            "Idea": {
                "count": 36094,
                "percentage": 23.999148919193868
            },
            "Praise": {
                "count": 80626,
                "percentage": 53.60878209006829
            },
            "Problem": {
                "count": 28532,
                "percentage": 18.971123094210657
            },
            "Question": {
                "count": 4734,
                "percentage": 3.147669168932891
            },
            "Message": {
                "count": 411,
                "percentage": 0.27327672759430044
            }
        }
    ]
}

Surveys

The survey is a series of questions asked to the End Customer.

That data can then be analysed over any period of time, or the focus can be narrowed
to a particular establishment, or any other analysis filter you wish to apply.

How do I get my Surveys metrics?

See our dedicated page: Surveys metrics

curl --location --request GET 'https://api.goodays.co/v2/stats/surveys/5gd0vbRYxL' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": "yLdLYMKp4j",
            "description": "Did you easily find the products you were looking for?",
            "average": 3.6965811965811968,
            "answers": [
                {
                    "count": 1,
                    "percentage": 2.857142857142857
                },
                {
                    "count": 4,
                    "percentage": 11.428571428571429
                },
                {
                    "count": 7,
                    "percentage": 20.0
                },
                {
                    "count": 17,
                    "percentage": 48.57142857142857
                },
                {
                    "count": 6,
                    "percentage": 17.142857142857142
                }
            ]
        },
        {
            "key": "bJdY1MKqdR",
            "description": "Note the **level of ease** to place your order online",
            "average": 3.8098290598290596,
            "answers": [
                {
                    "count": 1,
                    "percentage": 2.857142857142857
                },
                {
                    "count": 3,
                    "percentage": 8.571428571428571
                },
                {
                    "count": 5,
                    "percentage": 14.285714285714285
                },
                {
                    "count": 20,
                    "percentage": 57.14285714285714
                },
                {
                    "count": 6,
                    "percentage": 17.142857142857142
                }
            ]
        },
        {
            "key": "ELxjqQmr4K",
            "description": "**Would you recommend** the VÉLO online store to your friends and family?",
            "average": 6.878205128205128,
            "answers": [
                {
                    "count": 0,
                    "percentage": 0.0
                },
                {
                    "count": 1,
                    "percentage": 2.857142857142857
                },
                {
                    "count": 5,
                    "percentage": 14.285714285714285
                },
                {
                    "count": 2,
                    "percentage": 5.714285714285714
                },
                {
                    "count": 1,
                    "percentage": 2.857142857142857
                },
                {
                    "count": 1,
                    "percentage": 2.857142857142857
                },
                {
                    "count": 0,
                    "percentage": 0.0
                },
                {
                    "count": 8,
                    "percentage": 22.857142857142858
                },
                {
                    "count": 6,
                    "percentage": 17.142857142857142
                },
                {
                    "count": 7,
                    "percentage": 20.0
                },
                {
                    "count": 4,
                    "percentage": 11.428571428571429
                }
            ]
        }
    ]
}

Dissatisfaction

A Dissatisfaction Alert is triggered if an End Customer gives a low score on a pre-defined surve survey question or leaves a problem remark.

Each Dissatisfaction Alert is highlighted in the Goodays Back Office and must be handled by the Local Manager by a call or message to the End Customer to understand their dissatisfaction.
In some rare cases they may be spammed or ignored.

That data can then be analysed over any period of time, or the focus can be narrowed
to any given survey, a particular establishment, or any other analysis filter you wish to apply.

How do I get my Dissatisfaction metrics?

See our dedicated page: Dissatisfaction metrics.

curl --location --request GET 'https://api.goodays.co/v2/stats/dissatisfaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": null,
            "description": null,
            "count": 78515,
            "percentage": 40.979029008653534,
            "pending": {
                "count": 1374,
                "percentage": 1.7499840794752597
            },
            "spam": {
                "count": 13453,
                "percentage": 17.13430554671082
            },
            "ignored": {
                "count": 1237,
                "percentage": 1.5754951283194294
            },
            "call": {
                "count": 11470,
                "percentage": 14.608673501878622
            },
            "text": {
                "count": 50981,
                "percentage": 64.93154174361587
            }
        }
    ]
}

Retained Customers

A Retained Customers is an End Customer who, following the treatment of their Dissatisfaction Alert, indicated that they were convinced by the response of the Local Manager and were considering returning to the establishment.

That score can then be analysed over any period of time, or the focus can be narrowed
to any given survey, a particular POS, or any other analysis filter you wish to apply.

How do I get my Retained Customers metrics?

See our dedicated page: Retained Customers metrics.

curl --location --request GET 'https://api.goodays.co/v2/stats/retained_customers?by=place' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'
{
    "data": [
        {
            "key": "bwdQ7oBgxQ",
            "description": "Style Castleford (Castleford) - 481",
            "retained_customers_count": 51,
            "retained_customers_percentage": 57.95454545454546,
            "customers_responding_count": 88
        },
        {
            "key": "wjdpMqXO4M",
            "description": "Style Howden (Howden) - 482",
            "retained_customers_count": 55,
            "retained_customers_percentage": 63.2183908045977,
            "customers_responding_count": 87
        },
        {
            "key": "My4lMmX1xR",
            "description": "Style Barnsley (Barnsley) - 471",
            "retained_customers_count": 46,
            "retained_customers_percentage": 55.42168674698795,
            "customers_responding_count": 83
        }
    ]
}