Meta API
META API предоставляет доступ к метаданным проекта, включая информацию о кампаниях, целевых событиях и валидацию токенов. API помогает получать актуальные списки сущностей для построения фильтров и отчетов.
Endpoints
Список кампаний
GET /v1/meta/campaigns?project_id={project_id}
Query параметры
___________________________________________________________________________
Пример запроса
curl -X GET "https://api.targetads.io/v1/meta/campaigns?project_id=11111&active=true" \
  -H "Authorization: Bearer YOUR_TOKEN"
Успешный ответ
{
  "meta": [
    {
      "placement_id": 12345,
      "placement_name": "Campaign Name 1",
      "placement_created": "2024-01-15 10:30:00",
      "placement_status": "active",
      "source_id": 1,
      "source_name": "Google Ads",
      "marketing_campaign_id": 678,
      "marketing_name": "Marketing Campaign 1",
      "landing_page": "https://example.com/landing",
      "creatives": []
    }
  ],
  "count": 1
}
Поля ответа
___________________________________________________________________________
Поля креатива (при include_creative=true)
___________________________________________________________________________
Валидация токена
GET /v1/meta/campaigns?project_id={project_id}
Query параметры
___________________________________________________________________________
Пример запроса
curl -X GET "https://api.targetads.io/v1/meta/token_validate?project_id=11111" \
  -H "Authorization: Bearer YOUR_TOKEN"
Успешный ответ
___________________________________________________________________________
Список целевых событий
GET /v1/meta/target_event?project_id={project_id}
Query параметры
___________________________________________________________________________
Пример запроса
curl -X GET "https://api.targetads.io/v1/meta/target_event?project_id=11111" \
  -H "Authorization: Bearer YOUR_TOKEN"
Успешный ответ
[
  {
    "human_name": "Покупка товара",
    "event_name": "Purchase",
    "event_category": "transaction",
    "event_type": "ecommerce",
    "sys_type": "purchase"
  },
  {
    "human_name": "Отправка формы",
    "event_name": "ContactForm",
    "event_category": "form",
    "event_type": "lead",
    "sys_type": "event"
  }
]
Поля ответа
___________________________________________________________________________
Использование Meta API
Получение кампаний для фильтров
import requests

API_URL = "https://api.targetads.io"
HEADERS = {"Authorization": "Bearer YOUR_TOKEN"}

def get_campaigns(project_id, active=True):
    response = requests.get(
        f"{API_URL}/v1/meta/campaigns",
        params={"project_id": project_id, "active": active},
        headers=HEADERS
    )
    response.raise_for_status()
    return response.json()['meta']

# Использование placement_id в фильтрах отчётов
campaigns = get_campaigns(11111)
campaign_ids = [c['placement_id'] for c in campaigns]
Получение целевых событий
def get_target_events(project_id):
    response = requests.get(
        f"{API_URL}/v1/meta/target_event",
        params={"project_id": project_id},
        headers=HEADERS
    )
    response.raise_for_status()
    return response.json()
Коды ошибок

Лимиты и ограничения


API имеет технические ограничения, которые следует

учитывать при построении интеграции:


  • Rate Limiting: 40 запросов в минуту на project_id