Analytics, Facebook girişi ve abonelikler - kurulum

1Bu kartın bağladıkları#

Entegrasyon adımında Oturum açma, analitik ve abonelikler adlı bir kart vardır. KENDİ hesaplarınızı bağlar:

• Firebase Analytics: uygulamayı kimin kullandığı ve ne yaptığı
• Facebook Login: bir Facebook ile Devam Et düğmesi ve Meta App Events
• RevenueCat: abonelikler ve satın almalar

Her anahtar ayrıdır. Yalnızca kullandığınızı açın; tüm anahtarları kapalı bir uygulama eskisi gibi derlenir.

2Firebase Analytics: proje oluşturun veya seçin#

Firebase konsolunu açın ve Proje oluştur'a dokunun (veya uygulamanızın push için zaten kullandığı projeyi seçin). Sorulduğunda Google Analytics'i AÇIK bırakın ve bir Analytics hesabı seçin ya da oluşturun.

Analytics'siz bir projeniz mi var? Proje ayarları → Entegrasyonlar → Google Analytics → Etkinleştir.

Firebase konsolunu aç →

3Firebase Analytics: Android uygulamanızı ekleyin#

Projede Uygulama ekle → Android'e dokunun.

• Android paket adı: sihirbazın Temel adımındaki TAM paket adını yazın, örneğin com.yourname.myapp. Tek bir yanlış harf ve hiç veri gelmez.
• Takma ad isteğe bağlıdır ve SHA-1 analitik için gerekmez.

Uygulamayı kaydet'e, ardından google-services.json dosyasını indir'e dokunun. Kalan Firebase adımlarını atlayabilirsiniz; AppMint SDK'yı sizin için ekler.

Paket adını sonradan mı değiştirdiniz? Yeni paketi başka bir Android uygulaması olarak ekleyin ve dosyayı yeniden indirin.

4Firebase Analytics: sihirbazda açın#

Entegrasyon adımı → Oturum açma, analitik ve abonelikler → Firebase Analytics'i açın. google-services.json yüklemesi daha sonra Push Bildirimleri kartında görünür: dosyayı oraya yükleyin. Push'un kullandığı aynı dosyadır, yani push için zaten yüklediyseniz işiniz bitti.

Her sayfa değişiminde bir ekran görüntüleme kaydedin: bu açıkken uygulama, sayfanız her yönlendirme değiştirdiğinde (bağlantılar, geçmiş değişiklikleri, geri ve ileri, # değişiklikleri) yol ve sayfa başlığıyla bir screen_view kaydeder. Kod yazmadan insanların hangi ekranları kullandığını görürsünüz. Sayfanız kendi screenView çağrılarını gönderiyorsa kapalı bırakın, aksi halde ekranlar iki kez sayılır.

5Kendi olaylarınızı gönderin#

AppMint.analytics.log(name, params) bir olayı kaydeder. Adlar harf, rakam ve _ kullanır (en fazla 40 karakter, harfle başlar). Yanıt neyin gönderildiğini ya da neden gönderilmediğini söyler: no_consent, not_configured, invalid_name, reserved_name.

setUserId olayları kendi kullanıcı kimliğinizle etiketler (asla e-posta değil), setUserProperty plan gibi bir özellik ayarlar ve screenView bir ekranı kendiniz kaydeder. Meta App Events açıkken log aynı olayı Meta'ya da gönderir.

if (window.AppMint && AppMint.analytics) {
  AppMint.analytics.setUserId('u_42');
  AppMint.analytics.setUserProperty('plan', 'pro');
  const r = await AppMint.analytics.log('add_to_cart', { item_id: 'sku-42', value: 19.99, currency: 'USD' });
  if (!r.ok) console.warn('not logged', r.providers);
  AppMint.analytics.screenView('Checkout', 'CheckoutPage');
}

6Verilerin göründüğü yer#

Firebase konsolu → Analytics. Realtime, uygulamayı açtıktan birkaç dakika içinde kullanıcıları ve olayları gösterir. Pano ve Olaylar raporları yaklaşık 24 saat içinde dolar; bu yüzden ilk gün boş bir rapor normaldir.

Test ederken her olayı canlı izlemek için telefonu bir bilgisayara bağlayıp aşağıdaki komutu çalıştırın, ardından uygulamayı açıp Analytics → DebugView'a gidin. Kendi paket adınızı kullanın.

adb shell setprop debug.firebase.analytics.app com.yourname.myapp
# turn it off again:
adb shell setprop debug.firebase.analytics.app .none.

7Onay ve vazgeçme#

Reklam gösteren bir uygulamada, Google'ın onay formu analitik için de belirleyicidir: kullanıcı yanıtlayana kadar hiçbir şey toplanmaz ve GDPR'nin geçerli olduğu yerlerde kullanıcının kabul etmesi gerekir. O zamana kadar çağrılar no_consent yanıtı verir ve hiçbir şey kuyruğa alınmaz.

Sayfanız toplamayı her zaman kapatabilir: AppMint.analytics.setEnabled(false) durdurur ve hatırlanır, setEnabled(true) tekrar açar. Analitikten gizlilik politikanızda ve Play'in Veri güvenliği formunda bahsedin.

document.getElementById('optOut').onchange = (e) =>
  AppMint.analytics.setEnabled(!e.target.checked);

8Facebook Login: Facebook uygulamasını oluşturun#

Meta for Developers → Uygulamalarım → Uygulama oluştur'u açın. Facebook Login ile oturum açma kullanım senaryosunu seçin (veya zaten sahip olduğunuz bir uygulamaya Facebook Login ürününü ekleyin). Bir ad ve iletişim e-postanızı girin.

Meta for Developers'ı aç →

9Facebook Login: yönlendirme URL'sini ekleyin#

Facebook Login → Ayarlar → Geçerli OAuth Yönlendirme URI'leri:
https://freewebtoapk.com/fb-return/
adresini, son eğik çizgi dahil aynen ekleyin. Sihirbazda yazmanıza gerek kalmaması için Yönlendirme URL'sini kopyala düğmesi vardır. İstemci OAuth girişi ve Web OAuth girişini açık tutun, ardından Değişiklikleri kaydet'e basın.

Anahtar karması ve Android platform kurulumu gerekmez: oturum açma bir tarayıcı sekmesinde açılır ve uygulamanıza döner.

10Facebook Login: Uygulama Kimliği ve İstemci Belirteci#

Uygulama ayarları → Temel, Uygulama Kimliğini gösterir. Uygulama ayarları → Gelişmiş → Güvenlik, İstemci belirtecini gösterir. İkisini de sihirbazın Facebook Login alanlarına yapıştırın.

Facebook uygulaması Geliştirme modundayken yalnızca üzerinde rolü olanlar (siz ve test kullanıcılarınız) oturum açabilir. Yayınlamadan önce Uygulama ayarları → Temel bölümüne bir gizlilik politikası URL'si ve bir simge ekleyin ve uygulamayı Canlı'ya alın.

11Facebook Login: insanları oturum açtırın#

AppMint.facebook.login(permissions) Facebook'u açar ve belirteçle ya da kullanıcı vazgeçerse ok: false ve cancelled ile sonuçlanır. Belirteci sunucunuza gönderin ve orada doğrulayın. getAccessToken() sayfa başladığında kayıtlı belirteci döndürür; logout() oturumu kapatır.

Kurulumları, uygulama açılışlarını ve kendi olaylarınızı Meta Events Manager'a göndermek için Meta App Events'i açın. AppMint.facebook.logEvent(name, valueToSum, params) yalnızca Meta'ya gönderir; analitikle aynı onay kuralına uyar.

const r = await AppMint.facebook.login(['public_profile', 'email']);
if (r.ok) {
  await fetch('/api/login/facebook', { method: 'POST', body: JSON.stringify({ token: r.accessToken }) });
} else if (!r.cancelled) {
  alert('Facebook sign-in failed: ' + (r.message || r.error));
}
AppMint.facebook.logEvent('fb_mobile_purchase', 9.99, { fb_currency: 'USD' });

12RevenueCat: projeyi oluşturun ve Google Play'i bağlayın#

RevenueCat'te bir proje oluşturun ve Google Play Store için bir uygulama ekleyin. Temel adımdaki TAM paket adını girin.

RevenueCat satın almaları Google ile bir hizmet hesabı üzerinden doğrular: Google Cloud'da oluşturmak için RevenueCat'in kendi rehberini izleyin, listelediği finansal izinlerle Play Console'da davet edin ve JSON kimlik bilgilerini RevenueCat uygulamasına yükleyin. Google, yeni kimlik bilgilerinin çalışması için bir gün veya daha fazla sürebilir.

RevenueCat'i aç →

13RevenueCat: ürünler, hak ve teklif#

1. Play Console'da aboneliklerinizi veya uygulama içi ürünlerinizi oluşturun (uygulama önce bir test kanalına yüklenmiş olmalıdır).
2. RevenueCat → Ürün kataloğunda aynı ürün kimliklerini ekleyin.
3. Bir Hak (Entitlement) oluşturun, örneğin pro, ve onu açan ürünleri ekleyin.
4. Bu ürünlere işaret eden Aylık ve Yıllık gibi paketler içeren bir Teklif (Offering) oluşturun (varsayılan olan güncel olarak gösterilir).

Sayfanız ödeme duvarını çizmek için güncel teklifi okur ve özellikleri açmak için hakkı kontrol eder.

14RevenueCat: genel Google anahtarı#

RevenueCat → Proje ayarları → API anahtarları: Google Play uygulamanızın GENEL anahtarını kopyalayın. goog_ ile başlar. Sihirbazdaki RevenueCat alanına yapıştırın.

Asla gizli anahtar (sk_...) kullanmayın. Bir uygulamanın içindeki her şey indiren herkes tarafından okunabilir ve gizli anahtar RevenueCat hesabınızın tam kontrolünü verir.

15RevenueCat: teklifler, satın almalar ve haklar#

configure() RevenueCat'i başlatır (kendi kullanıcı kimliğinizi verin ya da anonim kullanıcı için boş bırakın). getOfferings() ödeme duvarını döndürür, purchase(package) Google Play satın almasını çalıştırır ve getCustomerInfo() kullanıcının neye sahip olduğunu söyler. restore() önceki satın almaları geri getirir. Lisans test hesabıyla ve bir Play test kanalından kurulumla test edin.

if (window.AppMint && AppMint.revenuecat) {
  await AppMint.revenuecat.configure({ appUserId: 'u_42' });
  const off = await AppMint.revenuecat.getOfferings();
  if (off.ok && off.current) {
    const pkg = off.current.availablePackages[0];
    const r = await AppMint.revenuecat.purchase(pkg);
    if (r.ok) unlock();
  }
  const info = await AppMint.revenuecat.getCustomerInfo();
  const isPro = info.ok && !!info.customerInfo.entitlements.active.pro;
}