Mesajlaşma servisi entegrasyonları
Büyüyen mobil pazarda kullanıcı edinmek ne kolay ne de ucuz. Bu yüzden kazanılan kullanıcılara akıllıca yaklaşmak, özellikle rekabetin yoğun olduğu nişlerde birim ekonominizi olumlu etkiler.
Adapty, kullanıcıların gerçekleştirdiği temel ödeme eylemlerine ilişkin anlık bilgi sağlar. Bir müşterinizin deneme süresine geçip geçmediğini, ödeme sorunu yaşayıp yaşamadığını ya da abonelik satın aldıktan sonra iptal edip etmediğini takip edebilirsiniz. Tüm bu olaylar ve daha fazlası, müşterinin durumundaki değişimi yansıtır. Ve tam da bu an harekete geçmek için en doğru zamandır: bir teklif, kişisel bir hediye veya kullanıcıyı elde tutacak başka bir şey gönderin.
Push bildirim platformları, etkili ve otomatik bir elde tutma sistemi kurmak için kullanıcıları standart ve özel etiketlerle tanımlamanıza olanak tanır. Bu sistemin çalışması için platforma “artık mesaj gönderme zamanı” sinyalini verecek tetikleyici olaylara ihtiyaç vardır. Bu olaylar, kurduğunuz entegrasyon sayesinde 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öremedi mi?
Bize bildirin! Bir özellik isteği oluşturun, değerlendirerek eklemeyi düşünelim.
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ı kimliği. |
| currency | str | Yerel para birimi (varsayılan: USD). |
| price_usd | float | Apple/Google payı düşülmeden önceki ürün fiyatı. Gelir. |
| proceeds_usd | float | Apple/Google payı düşüldükten sonraki ürün fiyatı. Net gelir. |
| net_revenue_usd | float | USD cinsinden net gelir (Apple/Google payı ve vergiler düşüldükten sonraki gelir). Boş olabilir. |
| price_local | float | Apple/Google payı düşülmeden önceki ürün fiyatı (yerel para birimi). Gelir. |
| proceeds_local | float | Apple/Google payı düşüldükten sonraki ürün fiyatı (yerel para birimi). Net gelir. |
| transaction_id | str | Satın alma veya yenileme gibi bir işlem için 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ün satın alındığı tarih ve saat. |
| original_purchase_date | ISO 8601 date | Orijinal satın almanın gerçekleştiği tarih ve saat. |
| environment | str | Sandbox veya Production olabilir. |
| vendor_product_id | str | Apple App Store, Google Play Store veya Stripe’taki ürün kimliği. |
| base_plan_id | str | Google Play Store’daki temel plan kimliği veya Stripe’taki fiyat kimliği. |
| event_datetime | ISO 8601 date | Olayın gerçekleştiği tarih ve saat. |
| 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. Olabilecek 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 olarak abone olduğu dönem sayısı. Mevcut dönemi de içerir. |
| rate_after_first_year | bool | Aboneliğin bir yıllık kesintisiz yenilemeden sonra indirimli komisyon oranına (%15) hak kazanıp kazanmadığını belirten boolean. Komisyon oranları programa ve ülkeye göre değişir. Ayrıntılar için bkz. Mağaza komisyonu ve vergiler. |
| promotional_offer_id | str | Adapty Kontrol Paneli’nin Ürün bölümünde belirtildiği şekliyle promosyon teklifi kimliği. |
| 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’un adı. |
| paywall_revision | int | İşlemin gerçekleştiği paywall’un revizyonu. Değer 1 olarak ayarlanır. |
| developer_id | str | İşlemin gerçekleştiği placement’ın geliştirici (SDK) kimliği. |
| 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 için kullanılabilecek benzersiz olay kimliği. |
| 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 | Profil için iadeler dahil toplam gelir. |
| variation_id | uuid | Satın almanın yapıldığı paywall’un benzersiz kimliği. |
| access_level_id | str | Ücretli access level kimliği. |
| is_active | bool | Profil için ücretli access level’ın aktif olup olmadığını belirten boolean. |
| will_renew | bool | Ücretli access level’ın yenilenip yenilenmeyeceğini belirten boolean. |
| is_refund | bool | İşlemin iade edilip edilmediğini belirten boolean. |
| is_lifetime | bool | Ücretli access level’ın süresiz olup olmadığını belirten boolean. |
| is_in_grace_period | bool | Profilin ek sürede olup olmadığını belirten boolean. |
| starts_at | ISO 8601 date | Kullanıcı için ücretli access level’ın başladığı tarih ve saat. |
| 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 (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.