RevenueCat

Genel bakış

RevenueCat, platformlar arası uygulama içi satın almaları ve abonelik yaşam döngülerini izlemenize yardımcı olur. OneSignal ile, kullanıcının abonelik durumuna göre kişiselleştirilmiş mesajlar göndermek için bu verileri kullanabilirsiniz. Bu entegrasyon, OneSignal’deki kullanıcı etiketlerini en son abonelik bilgileriyle otomatik olarak günceller.

Ana faydalar

RevenueCat–OneSignal entegrasyonu ile şunları yapabilirsiniz:

Ücretsiz denemede olan veya yeni abone olan kullanıcılara onboarding mesajları gönderin.
Anketler veya indirimlerle kayıp kullanıcıları yeniden etkileşime geçirin.
Satın almalar, faturalama sorunları veya yenilemeler için işlemsel mesajlar gönderin.

OneSignal’de doğru abonelik verileriyle, kampanyalarınız daha akıllı ve daha etkili olacaktır.

Gereksinimler

RevenueCat hesabı
- RevenueCat Purchases SDK
- RevenueCat-OneSignal entegrasyonu’nu anlayın
Entegre SDK ile OneSignal hesabı
- Tags, Users ve OneSignal Subscriptions’ı anlayın

Kurulum

OneSignal’i RevenueCat’e bağlayın

RevenueCat dashboard’unuzda, proje ayarlarınıza gidin ve Integrations menüsünden ‘OneSignal’i seçin.
OneSignal Uygulama ID’nizi ve OneSignal API anahtarınızı ekleyin. Daha fazla bilgi için Keys and IDs’e bakın.
RevenueCat’in kullanması gereken etiket adlarını girin veya varsayılan etiket adlarını seçin.

OneSignal ID’yi RevenueCat’e iletin

RevenueCat, kullanıcıların RevenueCat kullanıcı detaylarına göre OneSignal’deki kullanıcı etiketlerini güncellemek için OneSignal kullanıcı ID’sini (OneSignal ID) kullanır.

OneSignal’de External ID ayarlanması, kararlı bir tanımlayıcı için gereklidir. Oturum ortasında değişirse, OneSignal ID de değişebilir ve RevenueCat bağlantısı kesilir.

OneSignal ID’yi RevenueCat’e iletmek için şunları yapmalısınız:

OneSignal'de External ID'yi ayarlayın

OneSignal’deki External ID’yi ana kullanıcı ID’nize ayarlayın. Bu, SDK login yöntemiyle yapılabilir.

OneSignal ID'yi alın

OneSignal ID’yi almak için kullanıcı durumu gözlemci yöntemini kullanmanızı öneririz, ancak ayrıca getter yöntemleri de sağlıyoruz:

Kullanıcı durumu gözlemcileri:
- Mobile SDK addObserver kullanıcı durumu
- Web SDK addObserver kullanıcı durumu
Getter yöntemleri:
- Mobile SDK getOneSignalId yöntemi
- Web SDK OneSignalId özelliği

OneSignal ID'yi RevenueCat'e iletin

OneSignal ID’yi RevenueCat’e iletin.

RevenueCat özelliği: $onesignalUserId
RevenueCat yardımcı yöntemi: setOneSignalUserID() (önerilir)

RevenueCat olaylarını OneSignal’e gönderin

RevenueCat’e eşlenmiş bir OneSignal ID’si olan kullanıcıların etiketleri otomatik olarak güncellenecektir.

Entegrasyonu test etme

Bir sandbox satın alması yapın

Uygulamanızı yükleyen yeni bir kullanıcıyı simüle edin ve bir sandbox satın almasını tamamlamak için uygulama akışınızdan geçin.

OneSignal ID’sinin RevenueCat’te ayarlandığından emin olun.

Gerekli cihaz verilerinin toplandığını kontrol edin

RevenueCat’te, az önce satın alma yapan test kullanıcısı için Müşteri Görünümüne gidin. Gerekli tüm verilerin kullanıcı için özellik olarak listelendiğinden emin olun.

OneSignal olayının başarıyla teslim edildiğini kontrol edin

Hala Müşteri Görünümündeyken, Müşteri Geçmişindeki test satın alma olayına tıklayın ve OneSignal entegrasyon olayının mevcut olduğundan ve başarıyla teslim edildiğinden emin olun.

OneSignal etiketlerinin güncellendiğini kontrol edin

OneSignal’de, Audience > Users’a gidin ve OneSignal ID’yi arayın. RevenueCat tarafından güncellenen etiketleri görmelisiniz.

Entegrasyon tamamlandı! Kullanıcılar satın alma yaptıkça veya abonelik durumlarını güncelledikçe artık OneSignal’deki etiketlerin otomatik olarak güncellendiğini görmelisiniz.

RevenueCat olay etiketleri

RevenueCat’teki her otomatik yenilenen abonelik olayı için, aşağıdaki etiketler OneSignal’deki kullanıcıya eklenir veya güncellenir. RevenueCat dashboard’unda etiketi boş bırakarak, belirli etiket(ler) için herhangi bir değer göndermemeyi seçebilirsiniz.

Etiket	Açıklama
`app_user_id`	Olayı tetikleyen RevenueCat Uygulama Kullanıcı ID’si
`period_type`	Satın alma veya yenileme için en son dönem türü. Ya: `TRIAL` (ücretsiz denemeler için), `INTRO` (tanıtım fiyatlandırması için) ya da `NORMAL` (standart abonelik)
`purchased_at`	En son abonelik satın alması veya yenilemesinin Epoch zamanı (saniye cinsinden)
`expiration_at`	En son abonelik bitiş tarihinin Epoch zamanı (saniye cinsinden)
`store`	Ya `APP_STORE`, `PLAY_STORE` ya da `STRIPE`
`environment`	Ya `SANDBOX` ya da `PRODUCTION`
`last_event_type`	Kullanıcıdan gelen en son olay türü. Ya: `INITIAL_PURCHASE`, `TRIAL_STARTED`, `TRIAL_CONVERTED`, `TRIAL_CANCELLED`, `RENEWAL`, `CANCELLATION`
`product_id`	Kullanıcının satın aldığı veya yenilediği en son abonelik ürün tanımlayıcısı
`entitlement_ids`	Kullanıcının kilidi açtığı RevenueCat Entitlement tanımlayıcılarının virgülle ayrılmış dizesi
`active_subscription`	Değer herhangi bir satın alma/yenileme olayında `true` ve `EXPIRATION`’da `false` olarak ayarlanacaktır
`subscription_status`	Aşağıdaki Abonelik Durumu Özelliği’ne bakın
`grace_period_expiration_at`	Faturalama sorunu oluşursa, ek süre bitiş tarihini göndereceğiz.

Yalnızca otomatik yenilenen abonelikler
RevenueCat, OneSignal’deki veri etiketlerini yalnızca otomatik yenilenen abonelik olaylarına yanıt olarak günceller.

RevenueCat olay örnekleri

Sağlanan JSON örnekleri, RevenueCat Events’e göre OneSignal’e gönderilen etiketleri gösterir. Olay, last_event_type etiketi olarak kaydedilir.

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1600016247,
        "expiration_at": 1602608247,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "initial_purchase",
        "last_event_at": 1600016250,
        "product_id": "monthly_sub",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1600031584,
        "expiration_at": 1600290784,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_started",
        "last_event_at": 1600031586,
        "product_id": "three_month_sub_trial",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602136340,
        "expiration_at": 1602741140,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_converted",
        "last_event_at": 1602114850,
        "product_id": "weekly_sub_trial",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1602051920,
        "expiration_at": 1602311120,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_cancelled",
        "last_event_at": 1602129368,
        "product_id": "weekly_sub_trial",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602125078,
        "expiration_at": 1604807078,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "renewal",
        "last_event_at": 1602122793,
        "product_id": "monthly_sub",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "cancellation",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1663445025,
        "expiration_at": 1664049825,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "uncancellation",
        "last_event_at": 1663969096,
        "product_id": "annual_sub",
        "entitlement_ids": "Premium"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "purchased_at": 1602086660,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "non_renewing_purchase",
        "last_event_at": 1602118600,
        "product_id": "one_time_purchase_product",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "PLAY_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "subscription_paused",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "auto_resume_at": 1602119600,
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "period_type": "NORMAL",
        "purchased_at": 1652374230,
        "expiration_at": 1652979030,
        "last_event_type": "expiration",
        "last_event_at": 1652988735
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1652383957,
        "expiration_at": 1654371157,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "billing_issue",
        "last_event_at": 1652988776,
        "product_id": "annual_sub",
        "entitlement_ids": "Premium"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "product_change",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "new_product_id": "monthly_sub",
        "entitlement_ids": null
    }
}

`subscription_status` etiketi

RevenueCat, OneSignal’e bir olay gönderdiğinde, aşağıdaki değerlerden birini kullanarak uygulanabilir değişikliklerle birlikte bir subscription_status etiketi eklenir veya güncellenir:

Durum	Açıklama
active	Müşterinin, bir sonraki yenileme tarihinde yenilenecek şekilde ayarlanmış aktif, ücretli bir aboneliği vardır.
intro	Müşterinin, ücretli bir tanıtım teklifi aracılığıyla aktif, ücretli bir aboneliği vardır.
cancelled	Müşterinin, bir sonraki yenileme tarihinde sona erecek şekilde ayarlanmış ücretli bir aboneliği vardır.
grace_period	Müşteri, başarıyla yenilenemeyen ücretli bir aboneliğin ardından ek süreye girmiştir.
trial	Müşteri, deneme süresi sonunda ücretliye dönüşecek şekilde ayarlanmış bir deneme süresindedir.
cancelled_trial	Müşteri, deneme süresi sonunda sona erecek şekilde ayarlanmış bir deneme süresindedir.
grace_period_trial	Müşteri bir deneme süresindeydi ve başarıyla yenilenemeyen bir aboneliğin ardından şimdi ek süreye girdi.
expired	Müşterinin aboneliğinin süresi doldu.
promotional	Müşteri, bir RevenueCat aracılığıyla bir yetkilendirmeye erişime sahiptir
expired_promotional	Müşteri daha önce süresi dolan bir RevenueCat Verilen Yetkilendirme aracılığıyla bir yetkilendirmeye erişime sahipti.
paused	Müşterinin, duraklatılmış ve gelecekte bir tarihte devam edecek şekilde ayarlanmış ücretli bir aboneliği vardır.

Birden fazla aktif aboneliği olan müşteriler için, bu özellik yalnızca en son olayın gerçekleştiği aboneliğin durumunu temsil edecektir.

SSS

Entegrasyonun çalışıp çalışmadığını nasıl anlarım?

OneSignal’de, Audience > Users’a gidin ve OneSignal ID’yi arayın. RevenueCat tarafından güncellenen etiketleri görmelisiniz. Ayrıca Audience > Segments’e gidip RevenueCat aracılığıyla ayarladığınız etiketleri filtreleyen bir segment oluşturabilirsiniz.

Kaç etiket ayarlayabilirim?

OneSignal’de ayarlayabileceğiniz etiket sayısında bir sınır yoktur, ancak her kullanıcının belirli bir zamanda sahip olabileceği etiket sayısında bir sınır vardır. Daha fazla bilgi için Pricing sayfamıza bakın.

İlk adımlar & ayarlar

Mesaj kanalları

Journey'ler

Hedeflenen & özel olaylar

Analitik ve Entegrasyonlar

Gizlilik & Güvenlik

Genel bakış

Ana faydalar

Gereksinimler

Kurulum

OneSignal’i RevenueCat’e bağlayın

OneSignal ID’yi RevenueCat’e iletin

RevenueCat olaylarını OneSignal’e gönderin

Entegrasyonu test etme

RevenueCat olay etiketleri

RevenueCat olay örnekleri

`subscription_status` etiketi

SSS

Entegrasyonun çalışıp çalışmadığını nasıl anlarım?

Kaç etiket ayarlayabilirim?

​Genel bakış

​Ana faydalar

​Gereksinimler

​Kurulum

​OneSignal’i RevenueCat’e bağlayın

​OneSignal ID’yi RevenueCat’e iletin

​RevenueCat olaylarını OneSignal’e gönderin

​Entegrasyonu test etme

​RevenueCat olay etiketleri

​RevenueCat olay örnekleri

​subscription_status etiketi

​SSS

​Entegrasyonun çalışıp çalışmadığını nasıl anlarım?

​Kaç etiket ayarlayabilirim?

Genel bakış

Ana faydalar

Gereksinimler

Kurulum

OneSignal’i RevenueCat’e bağlayın

OneSignal ID’yi RevenueCat’e iletin

RevenueCat olaylarını OneSignal’e gönderin

Entegrasyonu test etme

RevenueCat olay etiketleri

RevenueCat olay örnekleri

`subscription_status` etiketi

SSS

Entegrasyonun çalışıp çalışmadığını nasıl anlarım?

Kaç etiket ayarlayabilirim?