Developers
Ask
Sign inSign in

Get marketing dashboard

How much did I spend, and where?

1 min readUpdated 15 November 2026
Short answer

dorna_get_marketing_dashboard shows your marketing figures for a date range: total spend, orders, campaigns, the monthly trend and your top-spend outlets.

  • dorna_get_marketing_dashboard
  • Read only
Contents
  1. Parameters
  2. What it returns
  3. Example
  4. Access and confirmation

Parameters

FieldTypeDescription
projectIdstring (ID)Only this project's figures.
fromstringStart of the date range, YYYY-MM-DD.
tostringEnd of the date range, YYYY-MM-DD.

What it returns

Total spend, order and campaign counts, published orders, average order value, budget use against the caps you defined, the monthly trend (Persian-calendar months) and the top-spend outlets. Amounts are in rials (10 rials = 1 toman).

Example

Ask your assistant: Write my October marketing report with the three biggest changes.

The assistant then calls the tool like this:

{
  "name": "dorna_get_marketing_dashboard",
  "arguments": {
    "projectId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "from": "2026-10-01"
  }
}

A typical result looks like this (the values are examples):

{
  "totalSpentRials": 84000000,
  "orders": 4,
  "campaigns": 3,
  "publishedOrders": 2,
  "avgOrderRials": 6000000,
  "budgets": [
    {
      "type": "monthly",
      "period": "monthly",
      "budgetRials": 50000000,
      "spentRials": 21000000,
      "remainingRials": 29000000,
      "percentage": 58,
      "overBudget": false,
      "from": "2026-10-01",
      "to": "2026-10-31"
    }
  ],
  "monthly": [
    {
      "month": "1405/07",
      "spentRials": 21000000,
      "orders": 4
    }
  ],
  "topMedia": [
    {
      "name": "Tech Daily",
      "orders": 4,
      "spentRials": 21000000
    }
  ]
}

Access and confirmation

Read only: this tool never changes anything in your account.

Related tools: dorna_orders dorna_invoices

Still have a question?

Open this guide in your own AI assistant and ask it.

ChatGPTClaudeGemini