Tillroll · Kurulum rehberi

Tillroll’u RevenueCat ile kurma rehberi

Tillroll’u kurmak için uygulamayı aç, gösterdiği webhook adresini ve Authorization değerini kopyala ve RevenueCat’te yeni bir webhook’a yapıştır (projen → Integrations → Webhooks → Create new webhook). Sonra RevenueCat’te Send test event’e bas: Tillroll “Bağlantı çalışıyor” deyip çentiğinde “RevenueCat bağlandı” görünce iş tamam. Yaklaşık iki dakika sürer; API anahtarı da kayıt da yok.

  • Yaklaşık 2 dakika
  • macOS 14 veya üstü
  • Bir RevenueCat projesi
  • Kurulum ücretsiz

Tillroll şu an Mac App Store incelemesinde; henüz kurulamıyor.Çıkınca haber ver

Tillroll’u kur ve aç

Tillroll macOS 14 Sonoma veya üstünde çalışır ve menü çubuğunda yaşar. Mac App Store’a çıktığında kurup aç: ilk açılışta Tillroll Kurulumu penceresi kendiliğinden gelir. Çentiğinin her gece ne basacağını görmek için Örnek fişi bas düğmesine, sonra Devam düğmesine bas.

Tillroll kurulum penceresinin karşılama adımı: Print a sample receipt (Örnek fişi bas) ve Continue (Devam) düğmeleri.
Kurulum penceresinin ilk adımı. Ekran görüntüleri İngilizce arayüzden; Mac’inin dili Türkçeyse aynı düğmeleri Türkçe görürsün.

Webhook adresini ve Authorization değerini kopyala

Sonraki ekran, RevenueCat'te nereye?, webhook formunun yerini gösterir (aşağıda 3. adım). Ondan sonraki RevenueCat'i bağla ekranı hesabını orada açar; kayıt ya da şifre yok. RevenueCat’in istediği değerleri, her birinin yanında Kopyala düğmesiyle gösterir: Webhook URL ve Bearer twh_ ile başlayan Authorization header value.

Adres her Tillroll kullanıcısı için aynıdır. Authorization değeri ise sana özel gizli değerdir: göz düğmesine basana kadar maskeli durur. Tillroll RevenueCat API anahtarını hiç istemez.

RevenueCat’i bağlama adımı: Webhook name Tillroll, Webhook URL, Bearer twh ile başlayan Authorization header value, Environment Production only ve App / Event type All apps / All events; yanlarında Copy düğmeleri.
RevenueCat’i bağlama adımı. Bu ekran görüntüsü geliştirme sürümünde alındığı için Webhook URL bulanıklaştırıldı.

RevenueCat’te bir webhook ekle

RevenueCat panelinde projeni aç ve sol menünün altındaki Integrations’a tıkla. Webhooks kartını seç, Create new webhook düğmesine bas ve formu yukarıdan aşağı şöyle doldur:

RevenueCat alanıNe girilecek
Webhook nameTillroll
Webhook URLTillroll’dan yapıştır
Authorization header valueTillroll’dan yapıştır (Bearer twh_…)
Environment to send events forProduction only (varsayılan sandbox’ı da gönderir)
AppAll apps
Event typeAll events

Sağ alttaki Add webhook düğmesine bas. Tillroll’un kendi RevenueCat'te nereye? adımı aynı yolu ekran görüntüleriyle gösterir; RevenueCat'i aç düğmesi de seni panele götürür.

Tillroll yalnızca RevenueCat’in gönderdiği satış bildirimlerini alır. Senin adına hiçbir şey yapamaz: aboneliklere, iadelere ya da RevenueCat ayarlarına dokunamaz. RevenueCat’te webhook’u silerek bağlantıyı istediğin an kesebilirsin.

RevenueCat’in webhook dokümanı bu düğmeye “Add new configuration” diyor; aynı formu açar.

Bir test olayı gönder

Tillroll’a dön ve Devam ile Bağlantıyı test et adımına geç. “Test olayı bekleniyor…” yazar ve 3 saniyede bir kontrol eder.

RevenueCat’te webhook listesinden Tillroll’u aç (Edit webhook). Sayfanın altındaki Webhook Events bölümünde Send test event’e, açılan sayfada da Send Test Event’e bas. Birkaç saniye sonra Tillroll “Bağlantı çalışıyor” der, çentiğinde de “RevenueCat bağlandı” yazar.

Bağlantı testi adımı: yeşil onay işareti ve Connection works (Bağlantı çalışıyor) yazısı.
Çentikten çıkan siyah bildirim: yeşil onay işareti ve RevenueCat connected (RevenueCat bağlandı) yazısı.
Test olayı gelince çentiğin altında çıkan ding.

Henüz webhook yok mu? Şimdilik atla ile kurulumu yine de bitirebilirsin; RevenueCat olmadan dene bölümüne bak.

Uygulamalarını adlandır

RevenueCat olaylarda uygulama adı göndermiyor; Tillroll adı uygulamanın ilk satışından, genelde ürün kimliğinden tahmin eder (fitnote.monthly gibi bir ürün “Fitnote” olur). Uygulamaların adımında fişte görmek istediğin adı yaz ve Kaydet düğmesine bas.

Bir uygulama listeye ilk satışıyla girer; test olayından hemen sonra liste boş olabilir. Adları istediğin zaman Ayarlar → Uygulama adları bölümünden değiştirebilirsin. App Store’daki adla eşleşen adlarda ding uygulamanın ikonunu gösterir; eşleşmezse harfli bir rozet çıkar.

Uygulamalar adımı: düzenlenebilir iki uygulama adı alanı, her birinde 1 event sayısı ve Save (Kaydet) düğmesi.
Bu ekran görüntüsünde uygulama adları gizlendi.

Gün sonu saatini seç

Son dokunuş adımında üç ayar var. Fiş başlığı fişin en üstündeki başlıktır (sen değiştirene kadar MY APPS). Gün sonu saati kasanın kapandığı saattir: varsayılan 23:59’da günün Z raporu çentikten kendiliğinden basılır; menü çubuğundaki Kasayı kapat ile istediğin an da bastırabilirsin.

Ses (ding ve yazıcı) sen açana kadar kapalıdır. Kâğıt temaları, günlük hedef ve saat dilimi Ayarlar → Fiş bölümünde.

Son dokunuş adımı: Receipt header (Fiş başlığı) alanı, 23:59’a ayarlı Closing time (Gün sonu saati) ve kapalı Sound (Ses) anahtarı.

Ekran paylaşırken gizlilik

Ayarlar → Bildirim bölümünde Rakamları gizle varsayılan olarak Ekran paylaşılırken seçilidir: Zoom paylaşımı, OBS, Loom, Screen Studio ya da Cap çalışırken tutarlar $•• olur. Tarayıcıdan (Meet) ya da Teams’ten paylaşım algılanamaz; onlar için Her zaman’ı seç.

Uygulama adlarını gizlemek için basılan fişteki Uygulama adlarını gizle (göz) düğmesine bas. Fişte ve paylaşım kartında uygulamalar APP A, APP B diye basılır; tutarlar görünür kalır.

Gizli modda Tillroll’un çentik özeti: bugünün neti ve brütü $•• olarak, yanında 12 satış sayısı.
Örnek veriyle gizli mod; uygulama adı gizlendi.

Diğer RevenueCat projelerini bağla

Her RevenueCat projesinin kendi webhook’u olmalı; hepsinde aynı iki değer kullanılır. Tillroll menüsünde RevenueCat projesi ekle…’yi (ya da Ayarlar’da Proje ekle…’yi) seç ve 3. ve 4. adımları sıradaki projede tekrarla.

Başarılı bir testten hemen sonra Bir proje daha bağla düğmesine de basabilirsin. Bütün uygulamaların tek fişte, tek sayaçta, tek seride toplanır.

Bir RevenueCat projesi daha bağlama penceresi: aynı webhook adı, adres ve maskeli Authorization değeri, yanlarında Copy düğmeleri.

Tillroll’u Lifetime ile aç

Kurulum ücretsiz. Bitir düğmesine basınca Tillroll Tillroll Lifetime’ı ister: lansman fiyatıyla tek seferlik 4,99 $, bütün özellikler, abonelik yok. App Store fiyatı kendi para biriminde gösterir.

Açana kadar ding ve fişler durur; menüde Tillroll'u aç — Lifetime görünür. Daha önce aldıysan Ayarlar → Satın alma bölümündeki Satın alımları geri yükle’yi kullan.

RevenueCat olmadan dene

Kurulum sırasında ilk adımda örnek fiş bastırabilirsin; test adımındaki Şimdilik atla da webhook olmadan bitirmeni sağlar.

Daha kapsamlı bir tur için Ayarlar → Demo hesabı bölümünde Demo hesabını oluştur düğmesine bas. Tillroll ayrı bir demo hesabı açar ve 30 günlük örnek satışı RevenueCat gibi webhook üzerinden gönderir; gerçek hesabına dokunulmaz. Sonra Gösterilen hesap ile Gerçek ve Demo arasında geç ya da Canlı satış simülasyonu (10–25 sn'de bir, 10 dk)’nu açıp yeni örnek satışların dinglemesini izle. tillroll://demo?setup=1 adresini açmak da düğmeyle aynı işi yapar.

Bitir’e basana kadar Tillroll Lifetime olmadan çalışır. Sonrasında demo da gerçek satışların gibi Lifetime ister.

Sorun giderme

Test olayı hiç gelmiyor

İki değerin de eksiksiz kopyalandığından emin ol; Authorization değeri Bearer twh_ ile başlar. Test olayını Tillroll Bağlantıyı test et adımındayken gönder: bu adım açılmadan önce gönderilen test sayılmaz. RevenueCat her gönderimi webhook sayfasındaki Webhook Events bölümünde listeler; başarısız olanı oradan yeniden gönderebilirsin.

Test çalıştı ama gerçek satışlar dinglemiyor

Sandbox satın almaları varsayılan olarak gizli: Ayarlar → Bildirim → Sandbox olaylarını göster’i aç; webhook’un ortamı da sandbox’ı kapsamalı. Gerçek satışlar biraz sürebilir: RevenueCat webhook’u genelde satın almadan 5–60 saniye sonra gönderir, Tillroll da 30 saniyede bir yeni satışlara bakar. Menüde “Tillroll kilitli” yazıyorsa ding’ler Lifetime’ı bekler.

RevenueCat’te Webhooks kartını göremiyorum

RevenueCat webhook’ları güncel Pro planına dahil; bu plan aylık 2.500 $ takip edilen gelire kadar ücretsiz. Bazı eski (legacy) planlarda webhook yok; RevenueCat’in dokümanı bu durumda Pro plana geçmeyi söylüyor.

Yeni gizli değer ürettim, ding’ler durdu

Ayarlar → RevenueCat bağlantısı → Yeni gizli değer üret… eski değeri hemen geçersiz kılar. Yeni Authorization değerini RevenueCat’teki her webhook’a yapıştır.

Tutarlar $•• görünüyor

Rakamları gizle varsayılan olarak Ekran paylaşılırken seçili; Zoom paylaşımı, OBS, Loom, Screen Studio ya da Cap çalışırken tutarlar gizlenir. Ayarlar → Bildirim → Rakamları gizle’den değiştirebilirsin.

Dün gece fiş basılmadı

Mac gün sonu saatinde uykudaysa o günün fişi kendiliğinden basılmaz (Mac aynı gün içinde uyanırsa basılır). Satışlar kaybolmaz: sunucuda bekler ve ait oldukları güne yazılır.

Mac’imde çentik yok

Tillroll çentiği olmayan ekranlarda da aynı şekilde çalışır: ding, özet kartı ve fişler ekranın üst ortasındaki küçük bir hapta çıkar.

Yeni bir Mac’e geçtim

Tillroll hesabın o Mac’in Keychain’inde durur. Yeni Mac yeni ve boş bir hesapla başlar; onun değerlerini RevenueCat webhook’larına yapıştır. Lifetime’ı Satın alımları geri yükle ile geri alırsın.

Bağlantıyı nasıl keserim, verimi nasıl sildiririm?

RevenueCat’te Tillroll webhook’unu sil; yeni satışlar anında gelmez olur. Verilerinin silinmesi için “Delete my Tillroll data” konulu bir e-postayı hello@justshipstudio.com adresine at. Ayrıntılar gizlilik politikasında (İngilizce).

Hâlâ takıldın mı?

Şu adrese yaz: hello@justshipstudio.com. Her mesajı uygulamayı yapan kişi okur; macOS sürümün ve bir ekran görüntüsü çok yardımcı olur. Daha fazla cevap destek sayfasında (İngilizce).