TD API 2.0 - Getting target statistics

📘

Адрес для отправки запросов:

https://tdm4.adcloud.org/api/v2/?method=MethodName

В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.

Получение статистики по таргету

"method": "Statistic.getTarget" позволяет пользователю получить статистику по ключу таргета. Для этого необходимо выполнить запрос, указав в качестве параметров "targetName" - ключ таргета, а также период времени, за который необходимы статистические данные.

Для получения статистики по ГЕО в виде иерархического дерева необходимо указать ключ таргета "geo_id".

Пример запроса:

JSON

{
  "jsonrpc": "2.0",
  "method": "Statistic.getTarget",
  "params": {
    "targetName": "geo_id",
    "period": {
      "from": "2023-10-29",
      "to": "2023-10-29"
    }
  },
  "id": 1
}

Пример ответа:

JSON

{
    "jsonrpc": "2.0",
    "result": {
        "Europe": {
            "Russia": {
                "Orenburg Oblast": {
                    "Orenburg": {
                        "show": 21646,
                        "click": 26,
                        "cpc": 87.71187310212129,
                        "cpm": 105.35473993602298,
                        "ctr": 0.12011457082139887,
                        "spent": 2280.5087006551535
                    },
                    "total": {
                        "show": 21646,
                        "click": 26,
                        "cpc": 87.712,
                        "cpm": 105.355,
                        "ctr": 0.12,
                        "spent": 2280.509
                    }
                },
                "St.-Petersburg": {
                    "Shushary": {
                        "show": 55,
                        "click": 0,
                        "cpc": 0,
                        "cpm": 115.51263609236493,
                        "ctr": 0,
                        "spent": 6.353194985080071
                    },
                    "Malaya Kushelevka": {
                        "show": 11,
                        "click": 0,
                        "cpc": 0,
                        "cpm": 105.16758024016873,
                        "ctr": 0,
                        "spent": 1.156843382641856
                    },
                    "St Petersburg": {
                        "show": 288639,
                        "click": 342,
                        "cpc": 90.37339804444744,
                        "cpm": 107.08082459820407,
                        "ctr": 0.1184871067319385,
                        "spent": 30907.702131201026
                    },
                    "Kronstadt": {
                        "show": 7,
                        "click": 0,
                        "cpc": 0,
                        "cpm": 104.38572213634242,
                        "ctr": 0,
                        "spent": 0.7307000549543969
                    },
                  
                   // ...
                  
                    "total": {
                        "show": 291539,
                        "click": 344,
                        "cpc": 90.714,
                        "cpm": 107.038,
                        "ctr": 0.118,
                        "spent": 31205.705
                    }
                },
                "Ulyanovsk Oblast": {
                    "Ulyanovsk": {
                        "show": 19503,
                        "click": 23,
                        "cpc": 90.96603139683,
                        "cpm": 107.27676368389942,
                        "ctr": 0.11793057478336666,
                        "spent": 2092.21872212709
                    },
                    "total": {
                        "show": 19503,
                        "click": 23,
                        "cpc": 90.966,
                        "cpm": 107.277,
                        "ctr": 0.118,
                        "spent": 2092.219
                    }
                },
              
                // ...
               
                "total": {
                    "show": 441701,
                    "click": 528,
                    "cpc": 89.999,
                    "cpm": 107.583,
                    "ctr": 0.12,
                    "spent": 47519.41
                }
            },
            "total": {
                "show": 441701,
                "click": 528,
                "cpc": 89.999,
                "cpm": 107.583,
                "ctr": 0.12,
                "spent": 47519.41
            }
        },
        "n/a": {
            "show": 5,
            "click": 0,
            "cpc": 0,
            "cpm": 118.04524312672,
            "ctr": 0,
            "spent": 0.5902262156336
        },
        "total": {
            "show": 441706,
            "click": 528,
            "cpc": 90,
            "cpm": 107.583,
            "ctr": 0.12,
            "spent": 47520
        }
    },
    "id": 1
}

Метод возвращает в секции результатов суммарную статистику за указанный в запросе период времени и по всем доступным кампаниям пользователю в разбивке по ГЕО. То есть отдельно для каждого региона, а также общую статистику для областей, стран и общую статистику по всему ГЕО. В статистику входят следующие данные:

Поле	Описание	Пример значения
show	Количество показов	382995
click	Количество кликов	674
cpc	Рассчитанный cpc (стоимость одного клика)	0.568
cpm	Рассчитанный cpm (стоимость 1000 показов)	1
ctr	ctr в % (кликабельность)	0.176
spent	Расход в текущей валюте	382.995