Mesajlaşma servisi entegrasyonları
Büyüyen mobil pazarda kullanıcı edinmek ne kolay ne de ucuz. Bu yüzden çektiğiniz kullanıcılara akıllıca davranmak, özellikle rekabetçi nişlerde birim ekonominizi 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. :::
Etkinlik özellikleri
Webhook etkinlikleri JSON formatında gönderilir. Tüm etkinlikler aynı yapıyı izler; ancak alanları etkinlik türüne, mağazaya ve özel yapılandırmanıza göre değişiklik gösterir.
Adapty, diğer para birimlerini USD’ye currencylayer.com döviz kuru üzerinden çevirir (her 8 saatte bir güncellenir). Kur, işlem anında sabitlenir — sonraki değişiklikler dönüşüm sonucunu etkilemez.
| Ö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 | Net gelir (Apple/Google kesintisi ve vergiler sonrası gelir) USD cinsinden. Boş olabilir. |
| price_local | float | Apple/Google kesintisi öncesi yerel para birimindeki ürün fiyatı. Gelir. |
| proceeds_local | float | Apple/Google kesintisi sonrası yerel para birimindeki ürün fiyatı. 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 ID’si. 12 aylık taahhüt planı için değer <product_id>:monthly şeklindedir. |
| 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 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 & 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önemi de içerir. |
| rate_after_first_year | bool | Aboneliğin bir yıllık kesintisiz yenilemenin ardından indirimli komisyon oranına (%15) hak kazandığını gösteren boolean değer. Komisyon oranları programa uygunluk 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 teklifinin 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’un adı. Bir flow için, paywall ekranının ID’si (scr_...). |
| 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) ID’si. |
| ab_test_name | str | İşlemin gerçekleştiği A/B testinin adı. Çok placement’lı bir A/B testi için, tek bir placement’taki testin adı (<test name> child-N). Çok placement’lı testi tüm placement’lar genelinde gruplamak için ab_test_id kullanın. |
| ab_test_revision | int | İşlemin gerçekleştiği A/B testinin revizyonu. Değer 1 olarak ayarlanır. |
| ab_test_id | uuid | İşlemin gerçekleştiği A/B testinin ID’si. Çok placement’lı bir A/B testinde tüm placement’larda aynıdır. |
| ab_test_parent_name | str | Çok placement’lı A/B testinin adı. Yalnızca çok placement’lı A/B testlerinde bulunur. |
| ab_test_variant_id | uuid | İşlemin gerçekleştiği A/B testi varyantının ID’si. İşlemleri test varyantına göre ayırmak için kullanın. |
| ab_test_variant_name | str | A/B testi varyantının adı. |
| flow_id | uuid | İşlemin gerçekleştiği flow’un ID’si. |
| flow_name | str | İşlemin gerçekleştiği flow’un adı. |
| flow_variation_id | uuid | Bu placement’taki flow varyantının ID’si; SDK’daki flow.variationId ile aynıdır. |
| cohort_name | str | Profilin ait olduğu kitlenin adı. |
| profile_event_id | uuid | Tekilleştirme için kullanılabilecek benzersiz etkinlik ID’si. |
| store_country | str | Mağaza tarafından bize iletilen ülke. |
| 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 | Profil IP’sine göre Adapty tarafından belirlenir. |
| profile_total_revenue_usd | float | İadeler dahil olmak üzere profile ait toplam gelir. |
| variation_id | uuid | Satın alma işleminin gerçekleştiği paywall’un benzersiz ID’si. Bir flow için, A/B testi varyantının değil, flow içindeki paywall ekranının 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ı gösteren boolean değer. |
| will_renew | bool | Ücretli access level’ın yenilenip yenilenmeyeceğini gösteren boolean değer. |
| is_refund | bool | İşlemin iade edilip edilmediğini gösteren boolean değer. |
| is_lifetime | bool | Ücretli access level’ın süresiz olup olmadığını gösteren boolean değer. |
| is_in_grace_period | bool | Profilin ek süre içinde olup olmadığını gösteren boolean değer. |
| 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 mevcut döneminin en son başladığı tarih ve saat. İlk yenilemeden önce activated_at ile aynıdır. |
| 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ı gösteren boolean değer (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.