Mesajlaşma servisi entegrasyonları
Büyüyen mobil pazarda kullanıcı edinmek ne kolay ne de ucuz. Bu yüzden kazandığınız kullanıcılara akıllıca yaklaşmak, özellikle rekabetin yoğun olduğu alanlarda birim ekonominizi ciddi ölçüde iyileştirir. Adapty, kullanıcıların temel ödeme işlemleri hakkında gerçek zamanlı bilgi sağlar. Müşterinizin deneme süresi başlatıp başlatmadığını, ödeme sorunuyla karşılaşıp karşılaşmadığını veya bir abonelik satın alıp daha sonra iptal edip etmediğini biliyoruz. Tüm bu ve diğer olaylar, müşterinin durumundaki değişimi yansıtır. Ve bu, harekete geçmek için en iyi andır — bir teklif gönderin, kişisel bir hediye sunun ya da kullanıcıyı elde tutmak için ne gerekiyorsa yapın. Push bildirim platformları, etkili bir otomatik kullanıcı tutma sistemi kurmak için kullanıcıları standart ve özel etiketlerle tanımlamaya olanak tanır. Bu sistemin çalışması için platforma mesaj gönderme zamanı geldiğini bildiren tetikleyici olaylar gereklidir. Bu olaylar, kurulu entegrasyon aracılığıyla Adapty’den push platformuna iletilir.
Entegre etmek istediğiniz servisi aşağıdan seçin ve talimatları izleyin:
Attribution sağlayıcınızı görmüyor musunuz?
Bize bildirin! Özellik isteği oluşturun ve eklemeyi değerlendireceğiz. :::
Olay özellikleri
Webhook olayları JSON formatında gönderilir. Tüm olaylar aynı yapıyı izler; ancak alanlar olay türüne, mağazaya ve yapılandırmanıza göre farklılık gösterir.
| Özellik | Tür | Açıklama |
|---|---|---|
| profile_id | uuid | Adapty kullanıcı ID’si. |
| currency | str | Yerel para birimi (varsayılan USD). |
| price_usd | float | Apple/Google kesintisi öncesi ürün fiyatı. Gelir. |
| proceeds_usd | float | Apple/Google kesintisi sonrası ürün fiyatı. Net gelir. |
| net_revenue_usd | float | USD cinsinden net gelir (Apple/Google kesintisi ve vergiler sonrası). Boş olabilir. |
| price_local | float | Yerel para biriminde Apple/Google kesintisi öncesi ürün fiyatı. Gelir. |
| proceeds_local | float | Yerel para biriminde Apple/Google kesintisi sonrası ürün fiyatı. Net gelir. |
| transaction_id | str | Satın alma veya yenileme gibi bir işleme ait benzersiz tanımlayıcı. |
| original_transaction_id | str | Orijinal satın alma işleminin tanımlayıcısı. |
| purchase_date | ISO 8601 date | Ürün satın alma tarihi ve saati. |
| original_purchase_date | ISO 8601 date | Orijinal satın alma tarihi ve saati. |
| environment | str | Sandbox veya Production olabilir. |
| vendor_product_id | str | Apple App Store, Google Play Store veya Stripe’taki ürün ID’si. |
| base_plan_id | str | Google Play Store’daki temel plan ID’si veya Stripe’taki fiyat ID’si. |
| event_datetime | ISO 8601 date | Etkinliğin tarihi ve saati. |
| store | str | app_store veya play_store olabilir. |
| trial_duration | str | Deneme süresinin gün cinsinden uzunluğu. ” days” formatında gönderilir, örneğin “7 days”. |
| cancellation_reason | str | Kullanıcının aboneliği iptal etme nedeni. Olası değerler: iOS ve Android voluntarily_cancelled, billing_error, refund iOS price_increase, product_was_not_available, unknown Android new_subscription_replace, cancelled_by_developer |
| subscription_expires_at | ISO 8601 date | Aboneliğin sona erme tarihi. Genellikle gelecekte bir tarihtir. |
| consecutive_payments | int | Kullanıcının kesintisiz abone olduğu dönem sayısı. Mevcut dönem dahildir. |
| rate_after_first_year | bool | Bir yıllık kesintisiz yenilemenin ardından aboneliğin indirimli komisyon oranına (genellikle %15) hak kazandığını belirten boolean değeri. Komisyon oranları programa ve ülkeye göre farklılık gösterir. Ayrıntılar için Mağaza komisyonu ve vergiler bölümüne bakın. |
| promotional_offer_id | str | Adapty Kontrol Paneli’nin Ürün bölümünde belirtilen promosyon teklifi ID’si. |
| store_offer_category | str | introductory veya promotional olabilir. |
| store_offer_discount_type | str | free_trial, pay_as_you_go veya pay_up_front olabilir. |
| paywall_name | str | İşlemin gerçekleştiği paywall’ın adı. |
| paywall_revision | int | İşlemin gerçekleştiği paywall’ın revizyonu. Değer 1 olarak ayarlanır. |
| developer_id | str | İşlemin gerçekleştiği placement’ın geliştirici (SDK) ID’si. |
| ab_test_name | str | İşlemin gerçekleştiği A/B testinin adı. |
| ab_test_revision | int | İşlemin gerçekleştiği A/B testinin revizyonu. Değer 1 olarak ayarlanır. |
| cohort_name | str | Profilin ait olduğu kitlenin adı. |
| profile_event_id | uuid | Tekilleştirme amacıyla kullanılabilecek benzersiz etkinlik ID’si. |
| store_country | str | Mağaza tarafından iletilen ülke bilgisi. |
| profile_ip_address | str | Profil IP’si (IPv4 veya IPv6 olabilir; mevcut olduğunda IPv4 tercih edilir). Cihazın IP’si her değiştiğinde güncellenir. |
| profile_country | str | Adapty tarafından profil IP’sine göre belirlenir. |
| profile_total_revenue_usd | float | İadeler dahil profil için toplam gelir. |
| variation_id | uuid | Satın alma işleminin yapıldığı paywall’ın benzersiz ID’si. |
| access_level_id | str | Ücretli access level ID’si. |
| is_active | bool | Profil için ücretli access level’ın aktif olup olmadığını belirten boolean değeri. |
| will_renew | bool | Ücretli access level’ın yenilenip yenilenmeyeceğini belirten boolean değeri. |
| is_refund | bool | İşlemin iade edilip edilmediğini belirten boolean değeri. |
| is_lifetime | bool | Ücretli access level’ın süresiz erişim olup olmadığını belirten boolean değeri. |
| is_in_grace_period | bool | Profilin ek sürede olup olmadığını belirten boolean değeri. |
| starts_at | ISO 8601 date | Kullanıcı için ücretli access level’ın başlangıç tarihi ve saati. |
| renewed_at | ISO 8601 date | Ücretli erişimin yenileneceği tarih ve saat. |
| expires_at | ISO 8601 date | Ücretli erişimin sona ereceği tarih ve saat. |
| activated_at | ISO 8601 date | Ücretli erişimin etkinleştirildiği tarih ve saat. |
| billing_issue_detected_at | ISO 8601 date | Ödeme sorununun tespit edildiği tarih ve saat. |
| profile_has_access_level | Bool | Profilin aktif bir access level’a sahip olup olmadığını belirten boolean değeri (yalnızca Webhook). |
| Her olayda şu özellikler bulunur: |
transaction_id, original_transaction_id, purchase_date, original_purchase_date, environment, vendor_product_id, event_datetime, store.
Bunlara ek olarak, bazı olaylar ek özellikler içerir. subscription_refunded ve non_subscription_purchase_refunded olayları için price_usd ve proceeds_usd değerlerinin ek özellik olarak sağlanması zorunludur.
| Olay Adı | Özellikler |
|---|---|
| subscription_initial_purchase | price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration |
| subscription_renewed | price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration |
| subscription_cancelled | cancellation_reason, trial_duration |
| trial_started | subscription_expires_at, trial_duration |
| trial_converted | price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration |
| trial_cancelled | cancellation_reason, trial_duration |
| non_subscription_purchase | price_usd, proceeds_usd |
| billing_issue_detected | subscription_expires_at, trial_duration |
| entered_grace_period | subscription_expires_at, trial_duration |
Olay örneği
{
"price_usd": 9.99,
"proceeds_usd": 6.99,
"transaction_id": "1000000628581600",
"original_transaction_id": "1000000628581600",
"purchase_date": "2020-02-18T18:40:22.000000+0000",
"original_purchase_date": "2020-02-18T18:40:22.000000+0000",
"environment": "Sandbox",
"vendor_product_id": "premium",
"event_datetime": "2020-02-18T18:40:22.000000+0000",
"store": "app_store"
}
Adapty, olayları hem sunucunuza hem de üçüncü taraf analitik sistemlere gönderir.
profile_ip_address özelliği, mevcut cihaz IP’siyle eşzamanlanır. Adapty sunucuları SDK’dan bilgi her aldığında, kayıtlı IP’den farklıysa IP güncellenir.