Sign in

v1

latestOpenAPI 3.0.02026-07-2496664456.3 KB
Report

Create a new report.

Create a new report of a specific AdAccount.

post/cm/v1/reports

Query parameters

ad_account_idstring required

The AdAccount ID of Campaigns to create the reports.

Request body

idstring

Unique identifier of the Report. Automatically set by server on creation.

ad_account_idstring required

Ad account ID to which the report associated.

product_idstring

Product App or Site ID to which the report associated.

dimensionsDspReportDimension[] required

List of interested dimensions by which metric numbers will be broken down.

optional_metricsReportOptionalMetric[]

List of interested optional metrics.

expire_atstring date-time

The time when a report will be expired.

created_atstring date-time

Created time.

updated_atstring date-time

Last updated time. Should not modify on the client side.

Example request

{
  "id": "sampleReportId",
  "ad_account_id": "sampleAdAccountId",
  "date_range": {
    "start": "2020-01-01",
    "end": "2020-01-02"
  },
  "dimensions": [
    "DATE",
    "APP_OR_SITE",
    "CAMPAIGN"
  ],
  "created_at": "2020-01-03T03:12:50.124101982Z",
  "updated_at": "2020-01-03T03:24:21.109821241Z"
}

Response

A successful response.

idstring

Unique ID of the newly created report.

hrefstring

Reference URL that shows the report.

statusstring

Reference URL that shows the most recent status of the report.

Example response

{
  "id": "newlyCreatedReportId",
  "href": "https://api.moloco.cloud/cm/v1/reports/newlyCreatedReportId",
  "status": "https://api.moloco.cloud/cm/v1/reports/newlyCreatedReportId/status"
}