Analytics API
ComputeAnalytics1
Computes high-level shop analytics for the given date range.
Method | GET or POST |
---|---|
Kind | Read-Only |
URL | https://app.bubblehouse.com/api/v2023061/<shop>/ComputeAnalytics1 |
Authentication | Shop Token |
Day boundaries are in the shop's time zone.
Note that this is a very expensive operation and might take a long time to complete. Please test and set a timeout accordingly. If you're going to be routinely calling this more than once a day in production, please talk to us first.
Input
The first day to consider.
The last day to consider. (This does not have to be a day that actually exists, as long as the range contains all the days you want included. E.g. you can use YYYY-MM-31 to refer to the last day of the month.)
Output
member_count
integerrequiredThe number of customers the online shop has by the end of the period.
member_delta
integerrequiredThe number of customers the online shop has gained during the period.
point_redeeming_customers
integerrequiredThe number of customers that have redeemed points at least once by the end of the period.
point_redeemers_avg_purchase_count
floatrequiredAverage purchase count for point redeemers (customers that have redeemed points at least once by the end of the period).
Average order value for point redeemers (customers that have redeemed points at least once by the end of the period).
Average revenue brought in by point redeemers (customers that have redeemed points at least once by the end of the period).
point_nonredeemers_avg_purchase_count
floatrequiredAverage purchase count for point non-redeemers (customers that have NOT redeemed points at least once by the end of the period).
Average order value for point non-redeemers (customers that have NOT redeemed points at least once by the end of the period).
Average revenue brought in by point non-redeemers (customers that have NOT redeemed points at least once by the end of the period).
votes
integerrequiredNumber of votes recorded during the period.
voting_customers
integerrequiredNumber of customers who voted during the period.
voting_points
integerrequiredTotal number of points awarded for voting during the period.
referrals_sent
integerrequiredTotal number of referrals sent during the period.
referrals_approved
integerrequiredTotal number of referrals approved during the period.
Specific Errors
Status | Error | Reason & Examples |
---|---|---|
None. |
API-wide Errors
Status | Error | Reason & Examples |
---|---|---|
None. |
Global Errors
Status | Error | Reason & Examples |
---|---|---|
401 | invalid_token | The provided authentication token is invalid or has expired. {"id":"invalid_token","message":"The token has expired"} |
429 | rate_limit_exceeded | Your usage is over the rate limit. Ensure that you're not making duplicate calls, and contact our team for a rate limit increase. {"id":"rate_limit_exceeded","message":"You are over the read limit per second for this customer"} |
400 | obsolete_global_api_version | The global API version you are trying to use is no longer supported. {"id":"obsolete_global_api_version"} |
400 | invalid_global_api_version | The global API version you are trying to use has never existed. {"id":"invalid_global_api_version"} |
400 | inaccessible_global_api_version | The global API version you are trying to use is not enabled on your account. {"id":"inaccessible_global_api_version"} |