Yandex Direct Report

Общее

Этот engine предоставляет доступ к отчетам Яндект Директа (ЯД). Для справочников существует отдельный engine apiproxy так как и у ЯД это отдельная служба.

Дока Директа

payload

  • access_token - токен ЯД
  • version - версия апи ЯД. Новое пишется с v5
  • account_name - название аккаунта клиента ЯД. В некоторых методах, это необязательное поле. Например Clients.get
  • method_params - параметры отчета апи
  • request_headers - Смотреть тут
  • return_as_is - False по умолчанию. Если True будет возвращены TSV данные

Примеры

Пример 1

Получить отчет

import requests
import json
access_token = "YOUR_TOKEN"

ret = requests.post("${HOST}/native_call", json.dumps(body = {
    "engine": "yandex_direct_report",
    "payload": {
        "access_token": access_token,
        "version": "v5",
        "account_name": "myyandexdirectaccount",
        "method_params": {
            "DateRangeType": "CUSTOM_DATE",
            "SelectionCriteria": {
                "DateFrom": "2018-01-01",
                "DateTo": "2018-03-01",
            },
            "FieldNames": [
                "Date",
                "CampaignId",
                "CampaignName",
                "CampaignType",
                "AdId",
                "AdFormat",
                "AdGroupId",
                "AdGroupName",

                "AdNetworkType",
                "Age",
                "Device",
                "Gender",
                "LocationOfPresenceName",
                "Placement",
                "TargetingLocationName",

                "Clicks",
                "Impressions",
                "Cost",

            ],
            "OrderBy": [{"Field": "Date"}],
            "ReportType": "AD_PERFORMANCE_REPORT",
            "IncludeVAT": "YES",
            "IncludeDiscount": "NO"
        }
    }
}))
print(u"ret = %s" % str(ret.text))