MyTarget API: как автоматизировать VK Ads с Python – практическое руководство

# .env
MT_CLIENT_ID=123456
MT_CLIENT_SECRET=abcdef1234567890

import os, requests, json

# 1. обмен кода на токены
resp = requests.post(
 "https://oauth.mytarget.ru/token",
 data={
 "grant_type": "authorization_code",
 "code": os.getenv("MYTARGET_CODE"),
 "client_id": os.getenv("MYTARGET_CLIENT_ID"),
 "client_secret": os.getenv("MYTARGET_CLIENT_SECRET"),
 "redirect_uri": os.getenv("MYTARGET_REDIRECT_URI"),
 },
)
tokens = resp.json()
os.environ["MYTARGET_ACCESS_TOKEN"] = tokens["access_token"]
os.environ["MYTARGET_REFRESH_TOKEN"] = tokens["refresh_token"]
os.environ["MYTARGET_EXPIRES_IN"] = str(tokens["expires_in"])

import requests, os

BASE_URL = 'https://api.mytarget.com'
TOKEN = os.getenv('MT_TOKEN')
headers = {
 'Authorization': f'Bearer {TOKEN}',
 'Content-Type': 'application/json'
}

# 1. Создать кампанию
campaign_resp = requests.post(
 f'{BASE_URL}/campaigns',
 json={'name': 'Test Campaign'},
 headers=headers
)
campaign_id = campaign_resp.json()['id']

# 2. Создать группу объявлений
group_resp = requests.post(
 f'{BASE_URL}/campaigns/{campaign_id}/adgroups',
 json={
 'name': 'Group 1',
 'budget': 1000,
 'targeting': {
 'age_range': '18-35',
 'region_ids': [1, 2],
 'interests': ['fitness', 'travel']
 }
 },
 headers=headers
)
group_id = group_resp.json()['id']

# 3. Загрузить изображение
with open('banner.jpg', 'rb') as f:
 upload_resp = requests.post(
 f'{BASE_URL}/media',
 files={'file': f},
 headers={'Authorization': f'Bearer {TOKEN}'}
 )
media_id = upload_resp.json()['id']

# 4. Создать креатив
creative_resp = requests.post(
 f'{BASE_URL}/adgroups/{group_id}/creatives',
 json={
 'text': 'Buy now',
 'url': 'https://example.com',
 'media_id': media_id
 },
 headers=headers
)
creative_id = creative_resp.json()['id']

# 5. Связать креатив с группой
link_resp = requests.post(
 f'{BASE_URL}/adgroups/{group_id}/creatives/{creative_id}/link',
 headers=headers
)

print('Campaign', campaign_id, 'ready')

import requests, json

adgroup_id = 123456
current_bid = 50 # руб
target_conv = 0.12
current_conv = 0.10

target_bid = current_bid * (target_conv / current_conv)

payload = {"bid": target_bid}
headers = {"Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json"}

response = requests.patch(
 f"https://api.mytarget.com/v1/adgroups/{adgroup_id}",
 headers=headers,
 data=json.dumps(payload)
)

print(response.status_code, response.text)

import logging, json, requests

logger = logging.getLogger(__name__)
logging.basicConfig(level=logging.INFO)

def send_request(url, payload, token):
 headers = {"Authorization": f"Bearer {token}"}
 try:
 resp = requests.post(url, json=payload, headers=headers, timeout=10)
 logger.info(f"Status: {resp.status_code}")
 logger.debug(f"Response: {resp.text}")
 resp.raise_for_status()
 data = resp.json()
 # обязательные поля
 if "id" not in data or "status" not in data:
 raise ValueError("Missing required fields")
 return data
 except (requests.RequestException, ValueError) as e:
 logger.error(f"Request failed: {e}")
 raise

# пример использования
sandbox_url = "https://api.mytarget.ru/sandbox/campaigns"
payload = {"name": "Test", "budget": 1000}
token = "your_token_here"
campaign = send_request(sandbox_url, payload, token)
print(campaign)

# Пример скрипта на Python
import requests, json, time
MT_TOKEN = "your_mtarget_token"
MT_ENDPOINT = "https://api.mytarget.ru/v2/traffic/stat"

def fetch_stats(period="daily"):
 payload = {
 "period": period,
 "ad_group_ids": [12345],
 "metrics": ["clicks", "spend", "impressions"]
 }
 headers = {"Authorization": f"Bearer {MT_TOKEN}"}
 resp = requests.post(MT_ENDPOINT, json=payload, headers=headers)
 return resp.json()

def send_webhook(data):
 webhook_url = "https://example.com/webhook"
 requests.post(webhook_url, json=data)

def export_csv(data, filename):
 import csv
 with open(filename, "w", newline="") as f:
 writer = csv.DictWriter(f, fieldnames=data[0].keys())
 writer.writeheader()
 writer.writerows(data)

# Запускаем каждый день в 02:00
if __name__ == "__main__":
 stats = fetch_stats("daily")
 send_webhook(stats)
 export_csv(stats, f"mt_daily_{time.strftime('%Y%m%d')}.csv")

# пример переключения среды в Python
import os
import requests

API_URL = os.getenv("API_URL", "https://api.sandbox.mytarget.ru")
TOKEN = os.getenv("MYTARGET_TOKEN")

headers = {"Authorization": f"Bearer {TOKEN}"}

def check_permissions():
 resp = requests.get(f"{API_URL}/v2/advertiser/permissions", headers=headers)
 if resp.status_code != 200:
 raise RuntimeError("Нет прав: " + resp.text)
 print("Права OK:", resp.json())

def create_campaign(name, budget):
 payload = {"name": name, "budget": budget}
 resp = requests.post(f"{API_URL}/v2/campaigns", json=payload, headers=headers)
 return resp.json()

# Тестовый запуск
if __name__ == "__main__":
 check_permissions()
 result = create_campaign("TestCamp", 1000)
 print("Создана:", result)