124 lines
3.8 KiB
Markdown
124 lines
3.8 KiB
Markdown
---
|
|
stage: Analyze
|
|
group: Product Analytics
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# Product analytics API **(ULTIMATE)**
|
|
|
|
> - Introduced in GitLab 15.4 [with a flag](../administration/feature_flags.md) named `cube_api_proxy`. Disabled by default.
|
|
> - `cube_api_proxy` removed and replaced with `product_analytics_internal_preview` in GitLab 15.10.
|
|
> - `product_analytics_internal_preview` replaced with `product_analytics_dashboards` in GitLab 15.11.
|
|
|
|
FLAG:
|
|
On self-managed GitLab, by default this feature is not available. To make it available per project or for your entire instance, ask an administrator to [enable the feature flag](../administration/feature_flags.md) named `cube_api_proxy`.
|
|
On GitLab.com, this feature is not available.
|
|
This feature is not ready for production use.
|
|
|
|
NOTE:
|
|
Make sure to define the `cube_api_base_url` and `cube_api_key` application settings first using [the API](settings.md).
|
|
|
|
## Send query request to Cube
|
|
|
|
Generate an access token that can be used to query the Cube API. For example:
|
|
|
|
```plaintext
|
|
POST /projects/:id/product_analytics/request/load
|
|
POST /projects/:id/product_analytics/request/dry-run
|
|
```
|
|
|
|
| Attribute | Type | Required | Description |
|
|
|-----------------|------------------| -------- |---------------------------------------------------------------------------------------------|
|
|
| `id` | integer | yes | The ID of a project that the current user has read access to. |
|
|
| `include_token` | boolean | no | Whether to include the access token in the response. (Only required for funnel generation.) |
|
|
|
|
### Request body
|
|
|
|
The body of the load request must be a valid Cube query.
|
|
|
|
NOTE:
|
|
When measuring `TrackedEvents`, you must use `TrackedEvents.*` for `dimensions` and `timeDimensions`. The same rule applies when measuring `Sessions`.
|
|
|
|
#### Tracked events example
|
|
|
|
```json
|
|
{
|
|
"query": {
|
|
"measures": [
|
|
"TrackedEvents.count"
|
|
],
|
|
"timeDimensions": [
|
|
{
|
|
"dimension": "TrackedEvents.utcTime",
|
|
"dateRange": "This week"
|
|
}
|
|
],
|
|
"order": [
|
|
[
|
|
"TrackedEvents.count",
|
|
"desc"
|
|
],
|
|
[
|
|
"TrackedEvents.docPath",
|
|
"desc"
|
|
],
|
|
[
|
|
"TrackedEvents.utcTime",
|
|
"asc"
|
|
]
|
|
],
|
|
"dimensions": [
|
|
"TrackedEvents.docPath"
|
|
],
|
|
"limit": 23
|
|
},
|
|
"queryType": "multi"
|
|
}
|
|
```
|
|
|
|
#### Sessions example
|
|
|
|
```json
|
|
{
|
|
"query": {
|
|
"measures": [
|
|
"Sessions.count"
|
|
],
|
|
"timeDimensions": [
|
|
{
|
|
"dimension": "Sessions.startAt",
|
|
"granularity": "day"
|
|
}
|
|
],
|
|
"order": {
|
|
"Sessions.startAt": "asc"
|
|
},
|
|
"limit": 100
|
|
},
|
|
"queryType": "multi"
|
|
}
|
|
```
|
|
|
|
## Send metadata request to Cube
|
|
|
|
Return Cube Metadata for the Analytics data. For example:
|
|
|
|
```plaintext
|
|
GET /projects/:id/product_analytics/request/meta
|
|
```
|
|
|
|
| Attribute | Type | Required | Description |
|
|
| --------- |------------------| -------- |---------------------------------------------------------------|
|
|
| `id` | integer | yes | The ID of a project that the current user has read access to. |
|
|
|
|
## List a project's funnels
|
|
|
|
List all funnels for a project. For example:
|
|
|
|
```plaintext
|
|
GET /projects/:id/product_analytics/funnels
|
|
```
|
|
|
|
| Attribute | Type | Required | Description |
|
|
| --------- |------------------| -------- |--------------------------------------------------------------------|
|
|
| `id` | integer | yes | The ID of a project that the current user has the Developer role for. |
|