Phygrid Developers
Browse Topics
App Reports / Phygrid Developers

App Reports

The following endpoints are available in the API for app reports.

MethodEndpointDescription
GETeventsReturns list of app events based on specified query parameters
GETsessionsReturns list of app sessions based on specified query parameters
GETnpsReturns app nps data
GET

events flow

Returns app events flow data
GET

products events

Returns list of app products events based on specified query parameters

GET

categories events

Returns list of app categories events based on specified query parameters

GET

purchases events

Returns list of app purchases (transactions) events based on specified query parameters

GET

purchased products events

Returns list of app purchased products events based on specified query parameters

GET

qr codes events

Returns list of app qr codes events based on specified query parameters

GET

media events

Returns list of app media events based on specified query parameters

{tenant-id} is your tenant id in the grid console.

{app-id} is your app id in the grid console.

GET App events

Returns list of app events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/events

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "appId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "count": number,
    "sessionCount": number,
    "hour"?: number
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines events interaction type.
Possible values: interactive, nonInteractive, all. Default value: all

interactivefalse
timespanTypestring

Defines events timespan type.
Possible values: day, hour. Default value: day

dayfalse

GET App sessions

Returns list of app sessions based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/sessions

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "sessionCount": number,
    "date": string,
    "appId": string,
    "hour"?: number
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines sessions interaction type.
Possible values: interactive, all. Default value: all

interactivefalse
timespanTypestring

Defines sessions timespan type.
Possible values: day, hour. Default value: day

dayfalse

GET App nps

Returns app nps data.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/nps

Response

{
  "score": number,
  "replyCount": number
}

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET App events flow

Returns app events flow data.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/eventsFlow

Response

[
  {
    "count": number,
    "eventType": string,
    "eventTypePrevious"?: string,
    "eventOrder": number
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
eventsFlowDepthnumber

Defines events flow depth. Minimum value: 1. Maximum value: 40. Default value: 15

15false

GET App products events

Returns list of app products events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/products

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "productId": string,
    "count": number,
    "sessionCount": number,
    "appId": string
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines events interaction type.
Possible values: interactive, nonInteractive, all. Default value: all

interactivefalse

GET App categories events

Returns list of app categories events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/categories

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "categoryId": string,
    "count": number,
    "sessionCount": number,
    "appId": string
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET App purchases events

Returns list of app purchases (transactions) events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/purchases

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    eventTime: string;
    interaction: boolean;
    transactionId: string;
    revenue: number;
    currency: string;
    count: number;
    sessionCount: number;
    appId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET App purchased products events

Returns list of app purchased products events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/purchased-products

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    transactionId: string;
    productId: string;
    categoryId: string;
    productName: string;
    currency: string;
    quantity: number;
    price: number;
    count: number;
    sessionCount: number;
    appId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET App qr codes events

Returns list of app qr codes events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/qr-codes

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    qrCodeId: string;
    qrCodeContent: string;
    qrCodeEntryMethod: string;
    qrCodeType: string;
    count: number;
    sessionCount: number;
    appId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET App media events

Returns list of app media events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/apps/{app-id}/media

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    mediaId: string;
    mediaType: string;
    mediaName: string;
    mediaTags: string[];
    mediaDuration: number;
    count: number;
    sessionCount: number;
    appId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

© 2024 · Phygrid. An Ombori company