/metrics/total
The following methods are supported on this resource:
Mount Points
The following URLs are examples of where this resource is mounted :
Provides statistics over the whole lifespan of one or several apps.
Possible HTTP Parameters
| name |
description |
| api_key |
list of api keys corresponding to applications. Parameter "all" will display metrics for all applications of which the caller is a developer of. If no keys are provided, the key from the authorization tpoken will be used
|
| appId |
(no documentation provided)
|
| metric |
Metrics to display. If no parameter is provided, all available metrics are shown. Here is the list of available metrics - install : Total number of installs
- remove : Total number of removes. You will have to subtract this from the total number of installs to get the net installs of your application for the applicable time period.
- preview : Calls to the preview module
- canvas : Calls to the canvas module
- block : Block requests generated in response to emails and notifications generated by your application_,_ and on the My Applications page.
- invite_requested : Application Invite requests generated. Note that this counts a request containing multiple friends as one request
- invite_sent : Application Invite requests fulfilled
- report_abuse : Notifications generated by your application marked as spam
- notification_requested : Notification API requests made to the API servers
- notification_sent : Notification API requests fulfilled. Note that when an API request is fulfilled, not all the recipients in the API request might receive the request, as some might already have received the limit of per-recipient notifications allowed.
- activity_requested : Requests to generate a Friend Update
- activity_sent : Friend Update requests fulfilled
- view_profile : Calls to the profile module
- api_request : API requests sent to our API servers by your application
- email_requested : Number of requests to send a message
- email_sent : Numbner of message sent
- friend_request_requested : Number of friend requests made by an application
- friend_request_sent : Friend request fulfilled
- all : List all available metrics
|
| context |
Specific contexts in which metrics were taken. If none provided, the breakdown of metrics by context is not displayed and the count is shown over all contexts. Keyword "all" will also provide the count over all contexts but will show the breakdown as well. Here is the list of available contexts - own_profile : The profile of the currently logged-in user
- other_profile : The profile of someone other than the currently logged-in user
- gallery : Application Gallery
- activity_stream : Friend update stream.
- invite : Friend Invite.
- notification : Notification.
- developer_center : Developer page.
- myapps : Manage Applications page.
- homepage : User's home page.
- profilenav : The View More link on the Profile module, and from the Applications drop down in the navigation bar at the top of the Profile page
- canvas : Application canvas
- apphome_owner : My Applications page of the currently logged-in user when user clicks on one of their own apps.
- apphome_friend : My Applications page of the currently logged-in user when user clicks on one of their friend's apps.
- request_share_app Application Invite.
- unknown : All other or when context that wasn't determined. Api requests, for example, don't have a context.
- all : show breakdown by all contexts
|
Output Payload
list of metrics for requested apps
Errors
| code |
description |
| 403 |
Thrown when an attempt is made to do something without the correct permissions.
|
| 400 |
Thrown when attempting to access a missing resource
|