Başlangıç
İlk rapor isteğini at — base URL, kimlik doğrulama ve ilk çağrı.
1. API anahtarını al
Reporting API bir API anahtarı (Bearer token) ile yetkilendirilir. Anahtar yoksa hesap yöneticinle iletişime geç. Anahtarı gizli tut — istemci tarafında (tarayıcı, mobil uygulama) açığa çıkarma.
2. İlk isteğini at
En basit çağrı: tek bir grand-total satırı (boyut yok).
curl -s 'https://reporting.magfiads.com/v1/report?from=2026-06-01T00:00:00Z&to=2026-06-30T23:59:59Z&metrics=views,spending,clicks' \
-H 'Authorization: Bearer <API_KEY>'Zorunlu üç parametre:
| Parametre | Açıklama |
|---|---|
from | Başlangıç (dahil), ISO 8601 — 2026-06-01T00:00:00Z |
to | Bitiş (dahil), ISO 8601 — 2026-06-30T23:59:59Z. En fazla 90 gün. |
metrics | Virgülle ayrılmış — views,spending,clicks,conversions,revenue |
3. Yanıt
{
"meta": {
"granularity": null,
"dimensions": [],
"metrics": ["views", "spending", "clicks"],
"total": 1,
"page": 1,
"limit": 500,
"has_more": false
},
"data": [
{
"dimensions": {},
"metrics": { "views": 1250400, "spending": 84210.5, "clicks": 9120 }
}
]
}Her satır { dimensions, metrics } şeklindedir. Boyut eklemeden tek bir toplam satırı
döner.
Sonraki adım
- Kırılım (kampanya/reklam/anahtar kelime/tarih) eklemek için → Rapor uç noktası
- Yetkilendirme detayı → Kimlik doğrulama
- Tam parametre listesi → API referansı