📊 RealMinds Report System

Devam etmek için şirket hesabınla giriş yap.

Müşteri ekle

Logo (PNG, opsiyonel): ≤ 400×120 (otomatik boyutlandırılır)

Müşteriler

Ad	GA Mülk	Dil	Para Birimi	Logo	Durum

Müşteri Detayı —

Alıcılar

E-posta	Ad	Durum

Tema

Sosyal medya deck'inde kullanılacak marka renkleri, font ve logo.

Ana renk

Vurgu rengi

Arka plan

Metin rengi

Font

Logo (PNG, opsiyonel):

Platformlar & Durum

Aktif platformları seç. Bağlantı durumu salt okunurdur; arka planda otomatik güncellenir.

Platform	Aktif	Bağlantı durumu
Instagram		yapılandırılmadı
LinkedIn		yapılandırılmadı
Facebook		yapılandırılmadı

Rakip & Newsletter Verisi

Rakipler

Ad	Takipçi	Yeni

CSV yapıştır (name,followers,growth — başlık satırı opsiyonel)

Newsletter (LinkedIn Fintek Radarı)

Toplam abone

Makaleyi okuyan

Yeni abone

Bağlantı Kimlikleri

Marka bazlı, gizli olmayan kimlik/ID alanları. Erişim anahtarları (token/API key) buraya yazılmaz — bkz. .

Instagram Business Account ID Graph API Explorer'da GET /me/accounts?fields=instagram_business_account → sayfanın instagram_business_account.id'si. Veya Business Settings → Instagram hesapları.

Facebook Page ID Facebook Sayfası → Hakkında → Sayfa Kimliği, veya Business Settings → Pages.

LinkedIn Organization URN LinkedIn Company Page admin URL'indeki sayı (linkedin.com/company/XXXX) → urn:li:organization:XXXX.

GA4 property ID Bu alan, müşteri düzenleme formunda ("GA4 mülk ID") yönetilir — burada salt okunur gösterilir.

Kurulum Rehberi

Sistemin canlı veri çekmesi için gereken dış hesap/erişim adımları. İlerlemeyi "Yapıldı" kutularıyla işaretle — bu panelde saklanır. Gizli işaretli kartlardaki anahtarlar panele YAZILMAZ, yalnızca Secret Manager'a konur.

1. Meta App + System User Token (Instagram + Facebook)

Gizli

Ne? Instagram ve Facebook verisini çekmek için tek "System User" erişim anahtarı (ajans Business Manager'ında). Süresiz.

Nereden alınır?

developers.facebook.com → My Apps → Create App → tür Business.
business.facebook.com → Business Settings → Users → System Users → System User oluştur.
Add Assets → müşteri Instagram hesapları + Facebook Sayfaları → "Manage/Analyze" yetkisi.
Generate New Token → app'i seç → izinler: instagram_basic, instagram_manage_insights, pages_read_engagement, read_insights, business_management.

Nereye?

🔒 Bu bir gizli anahtar — panele YAZMA. Secret Manager'a konur. Komutu kopyala ve çalıştır (veya Emre'ye ilet):

printf "%s" "PASTE_TOKEN" | gcloud secrets create meta-system-user-token --project=realminds-report --data-file=-

Yapıldı

2. LinkedIn App + Community Management API

Gizli (onay ~1-2 hafta)

Ne? LinkedIn sayfa istatistiklerini çekmek için app + API onayı. Onay birkaç gün–2 hafta sürer, ERKEN başlat.

Nereden alınır?

linkedin.com/developers → Create app → şirket LinkedIn Company Page ile ilişkilendir.
App → Products → Community Management API → Request access (formu doldur).
Onaylanınca OAuth2 token üret (scope: r_organization_social, r_organization_admin, rw_organization_admin).

Nereye?

🔒 Token gizli → Secret Manager:

printf "%s" "PASTE_TOKEN" | gcloud secrets create linkedin-token --project=realminds-report --data-file=-

Rakip kıyas + newsletter API'de YOK → panelde Gap-fill'den elle girilir.

Yapıldı

3. Anthropic API Key (rapor yorumu)

Gizli

Ne? Raporlardaki yapay zekâ yorum metnini yazan Claude anahtarı.

Nereden alınır?

console.anthropic.com → API Keys → Create Key.

Nereye?

🔒 Gizli → Secret Manager:

printf "%s" "PASTE_KEY" | gcloud secrets create anthropic-api-key --project=realminds-report --data-file=-

Yapıldı

4. Billing (otomatik/zamanlanmış çekim için)

🟡 Opsiyonel — otomasyon için gerekli

Ne? Cloud Function + Scheduler (otomatik haftalık/aylık çekim) için Blaze planı. Manuel/lokal çalıştırma billing'siz de çalışır.

Nereden?

Billing hesabı proje kotası dolu — kota artışı veya kullanılmayan projeden billing boşalt veya başka açık hesap. Sonra realminds-report'a bağla.

Nereye?

gcloud/Console (Emre/Ali).

Yapıldı

5. GA4 (yalnız web raporu isteyen müşteriler)

🟢 Opsiyonel

Ne? Web analytics raporu için GA4 property ID + service account erişimi.

Nereden?

GA4 → Admin → Property Settings → Property ID (sadece rakam). Ayrıca GA4 Admin → Property Access Management → service account'u Viewer ekle.

Nereye?

Property ID → müşteri düzenleme formundaki "GA4 property ID" alanı (panelde zaten var).

Yapıldı