# API Kurulum Rehberi

Bu rehber, `.env` dosyasındaki Google Ads ve Meta Marketing API anahtarlarını nasıl alacağınızı adım adım açıklar.

---

## 1. Google Ads API Kurulumu

Google Ads API'yi kullanabilmek için bir **Google Ads Yönetici Hesabı (MCC)** gereklidir.

### GOOGLE_ADS_DEVELOPER_TOKEN
1. [Google Ads Yönetici Hesabınıza](https://ads.google.com/home/tools/manager-accounts/) giriş yapın.
2. **Araçlar ve Ayarlar** > **Kurulum** > **API Merkezi**'ne gidin.
3. Buradan "Developer Token" (Geliştirici Jetonu) oluşturun. Başlangıçta "Test Access" (Test Erişimi) alacaksınız, bu yeterlidir.

### GOOGLE_ADS_CLIENT_ID & CLIENT_SECRET
1. [Google Cloud Console](https://console.cloud.google.com/)'a gidin.
2. Yeni bir proje oluşturun.
3. **API'ler ve Hizmetler** > **Kitaplık** kısmından "Google Ads API"yi etkinleştirin.
4. **OAuth Onay Ekranı**'nı (Consent Screen) yapılandırın (External seçin).
5. **Kimlik Bilgileri** (Credentials) > **Kimlik Bilgisi Oluştur** > **OAuth istemci kimliği**'ni seçin.
6. Uygulama türünü "Web Uygulaması" veya "Masaüstü Uygulaması" seçin.
7. Oluşan `Client ID` ve `Client Secret` değerlerini kopyalayın.

### GOOGLE_ADS_REFRESH_TOKEN
Bu token, Client ID ve Secret kullanarak bir kez alınır ve sürekli kullanılır. Google'ın sunduğu [OAuth2 Playground](https://developers.google.com/oauthplayground/) aracını kullanarak:
1. Sağ üstteki ayarlar simgesinden "Use your own OAuth credentials" seçip ID ve Secret'ınızı girin.
2. Sol taraftan `https://www.googleapis.com/auth/adwords` kapsamını seçin.
3. "Authorize APIs" butonuna basıp izin verin.
4. "Exchange authorization code for tokens" butonuna basarak `Refresh Token` değerini alın.

### GOOGLE_ADS_LOGIN_CUSTOMER_ID
Bu, Google Ads Yönetici Hesabınızın (MCC) 10 haneli müşteri kimliğidir (Örn: 123-456-7890). Tire işaretleri olmadan yazın.

---

## 2. Meta (Facebook) Marketing API Kurulumu

### META_APP_ID & META_APP_SECRET
1. [Meta for Developers](https://developers.facebook.com/) adresine gidin.
2. **Uygulamalarım** > **Uygulama Oluştur**'a tıklayın.
3. Uygulama türünü "İşletme" (Business) seçin.
4. Uygulama paneline girdiğinizde **Ayarlar** > **Temel** kısmından `App ID` ve `App Secret` değerlerini alabilirsiniz.

### META_ACCESS_TOKEN
1. Uygulama panelinde sol menüden **Pazarlama API'si**'ni (Marketing API) ekleyin.
2. **Pazarlama API'si** > **Araçlar** kısmına gidin.
3. `ads_management`, `ads_read`, `read_insights` izinlerini seçin.
4. "Get Token" butonuna basarak uzun süreli (Long-lived) bir erişim jetonu oluşturun.

### META_AD_ACCOUNT_ID
1. [Meta Reklam Yöneticisi](https://adsmanager.facebook.com/adsmanager/manage/accounts)'ne gidin.
2. Kullanmak istediğiniz reklam hesabının ID'sini (genellikle URL'de `act=123456789` şeklinde görünür) alın.
3. `.env` dosyasına `act_` önekiyle birlikte yazın (Örn: `act_123456789`).

---

## Önemli Notlar
- API anahtarlarını `.env` dosyasına ekledikten sonra sistemi gerçek verilerle test edebilirsiniz.
- Anahtarlar girilmediği sürece sistem **Demo Veri** modunda çalışmaya devam edecektir.
- Güvenliğiniz için bu anahtarları kimseyle paylaşmayın.