Saved Reports

Create a saved report

post/v2/saved_reports

Request

  • Base URL
    https://api.tenjin.com
  • Auth
    HTTP bearer

Request body

namestring required

Name of the saved report

granularity'daily' | 'weekly' | 'monthly' | 'totals-daily' required

Granularity of the report

group_bystring[] required

Dimensions to group the report by, comma-separated or as an array. The dimensions and combinations each report_type takes: user_acquisition: channel, app, country, campaign, site, creative, channel,app,country, channel,app, campaign,country; ad_revenue: channel, app, country, ad_placement, channel,app,country, channel,app, app,country

report_type'user_acquisition' | 'ad_revenue' required

user_acquisition for a spend report, ad_revenue for an ad revenue report

past_number_daysinteger

Number of days before today that the report covers

channel_idsinteger[]

Ids of the channels the report covers, comma-separated or as an array; all when blank

app_idsstring[]

Ids of the apps the report covers, comma-separated or as an array; all when blank

metricsstring[]

Metrics of the report, comma-separated or as an array: any of the spend metrics for user_acquisition, or of the ad revenue metrics for ad_revenue. A POST without metrics uses spend, impressions, clicks, installs, cpi, ctr, cvr, tcpi for user_acquisition, and ad_revenue, impressions, clicks, ecpm, ecpc for ad_revenue

Response

The created saved report

metaobject required

Always empty

Example response

{
  "data": {
    "attributes": {
      "name": "Daily spend by channel",
      "past_number_days": 30,
      "metrics": [
        "spend",
        "installs",
        "cpi"
      ],
      "granularity": "daily",
      "report_type": "user_acquisition",
      "channel_ids": [
        3
      ],
      "group_by": "channel_app"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.