Reporting

Reporting provides click-level data in JSON for a UTC datetime range, with pagination.

Requirements

We look for nw, platform click IDs (gclid, fbclid, …), and goat on landing URLs when they are present, then set buyside and click_id using the precedence below.

Traffic source (buyside)

We resolve buyside in this order:

• nw — If the landing URL includes nw, we use it. This is the strongest signal.
• If nw is absent, we take the first matching parameter name from the list that appears on the URL. buyside is whatever network that row assigns (fbclid → facebook).

Click identifier (click_id)

We resolve click_id in this order:

• Platform IDs — For the same first-matching table parameter, click_id is its value (the token after =, e.g. what Meta appends to fbclid= or Google to gclid=).
• goat. If no platform click ID is available (browsers occasionally strip click ids due privacy settings etc.), we fall back to pass-through query parameter that is set per tenant (often goat). If yours is not goat, let us know so we can configure it and keep reporting consistent.
• Generated — If there is still no usable ID after the above (i.e. organic traffic), we generate a unique ID per event so downstream reporting and models always have a stable key.

Default click-ID → network mapping

The table order is the evaluation order (first match wins). The Query parameter column is the URL name (e.g. fbclid). Attributed network is buyside for that parameter.

Query parameter	Attributed network
fbclid	facebook
gclid	google
nbclid	newsbreak
zmclid	zemanta
ttclid	tiktok
mgclid	mintegral
mgdclid	mediago
obclid	outbrain
snclid	smartnews
msclkid	microsoft
tbclid	taboola
gbraid	google
wbraid	google

Note: Custom order and mappings are available per tenant on request.

---

Overview

This API returns reporting rows for a given UTC datetime range with pagination.

• Get /report
  Returns paginated reporting data.

---

Base URL

raas-api.ace1m.com

1. Data Report

Paginated Report with a json output.

note

The report is in UTC.

Endpoint

GET /report

Authentication

Requests must include an API key in the header:

Ocp-Apim-Subscription-Key: <your-subscription-key>

Request Parameters

Name	Type	Required	Example
start_datetime	string	Yes	2026-03-01T00:00:00Z
end_datetime	string	Yes	2026-03-31T23:59:59Z
page	integer	Yes	1
page_size	integer	Yes	50

Request Fields

• start_datetime (string, required): Start date in YYYY-MM-DDTHH:MM:SSZ format (inclusive)
• end_datetime (string, required): End date in YYYY-MM-DDTHH:MM:SSZ format (inclusive)
• page (int, required): page must be an integer and page >= 1
• page_size (int, required): page_size must be an integer between 1 and 100

Response Fields

data: Array of reporting rows.

Each row contains:

• click_id
• buyside
• date
• timestamp
• revenue

Pagination metadata for the current result set.

• page: current page number
• page_size: number of rows returned per page
• total_pages: total number of pages available
• total_records: total number of matching records

Successful Response

{
  "data": [
    {
      "click_id": "abc123",
      "buyside": "google",
      "date": "2026-03-01",
      "timestamp": "2026-03-01 12:59:12.23",
      "revenue": 1.25
    },
    {
      "click_id": "abc125",
      "buyside": "google",
      "date": "2026-03-01",
      "timestamp": "2026-03-01 13:32:23.23",
      "revenue": 1.25
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total_pages": 1,
    "total_records": 2
  }
}

Validation Errors

• Missing start_datetime
• Missing end_datetime
• Missing page
• Missing page_size

Example Request

curl -X Get "https://raas-report-api-apim.azure-api.net/report?start_datetime=2026-03-01T03:39:33Z&end_datetime=2026-04-01T04:39:33Z&page=1&page_size=50" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \

Example Response

{
  "data": [
    {
      "click_id": "abc123",
      "buyside": "google",
      "date": "2026-03-01",
      "timestamp": "2026-03-01 12:59:12.23",
      "revenue": 1.25
    },
    {
      "click_id": "abc125",
      "buyside": "google",
      "date": "2026-03-01",
      "timestamp": "2026-03-01 13:32:23.23",
      "revenue": 1.25
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total_pages": 1,
    "total_records": 2
  }
}