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.

ÖzellikTürAçıklama
profile_iduuidAdapty kullanıcı kimliği.
currencystrYerel para birimi (varsayılan: USD).
price_usdfloatApple/Google payı düşülmeden önceki ürün fiyatı. Gelir.
proceeds_usdfloatApple/Google payı düşüldükten sonraki ürün fiyatı. Net gelir.
net_revenue_usdfloatUSD cinsinden net gelir (Apple/Google payı ve vergiler düşüldükten sonraki gelir). Boş olabilir.
price_localfloatApple/Google payı düşülmeden önceki ürün fiyatı (yerel para birimi). Gelir.
proceeds_localfloatApple/Google payı düşüldükten sonraki ürün fiyatı (yerel para birimi). Net gelir.
transaction_idstrSatın alma veya yenileme gibi bir işlem için benzersiz tanımlayıcı.
original_transaction_idstrOrijinal satın alma işleminin tanımlayıcısı.
purchase_dateISO 8601 dateÜrünün satın alındığı tarih ve saat.
original_purchase_dateISO 8601 dateOrijinal satın almanın gerçekleştiği tarih ve saat.
environmentstrSandbox veya Production olabilir.
vendor_product_idstrApple App Store, Google Play Store veya Stripe’taki ürün kimliği.
base_plan_idstrGoogle Play Store’daki temel plan kimliği veya Stripe’taki fiyat kimliği.
event_datetimeISO 8601 dateOlayın gerçekleştiği tarih ve saat.
storestrapp_store veya play_store olabilir.
trial_durationstrDeneme süresinin gün cinsinden uzunluğu. ” days” formatında gönderilir; örneğin “7 days”.
cancellation_reasonstr

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_atISO 8601 dateAboneliğin sona erme tarihi. Genellikle gelecekte bir tarihtir.
consecutive_paymentsintKullanıcının kesintisiz olarak abone olduğu dönem sayısı. Mevcut dönemi de içerir.
rate_after_first_yearboolAboneliğ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_idstrAdapty Kontrol Paneli’nin Ürün bölümünde belirtildiği şekliyle promosyon teklifi kimliği.
store_offer_categorystrintroductory veya promotional olabilir.
store_offer_discount_typestrfree_trial, pay_as_you_go veya pay_up_front olabilir.
paywall_namestrİşlemin gerçekleştiği paywall’un adı.
paywall_revisionintİşlemin gerçekleştiği paywall’un revizyonu. Değer 1 olarak ayarlanır.
developer_idstrİşlemin gerçekleştiği placement’ın geliştirici (SDK) kimliği.
ab_test_namestrİşlemin gerçekleştiği A/B testinin adı.
ab_test_revisionintİşlemin gerçekleştiği A/B testinin revizyonu. Değer 1 olarak ayarlanır.
cohort_namestrProfilin ait olduğu kitlenin adı.
profile_event_iduuidTekilleştirme için kullanılabilecek benzersiz olay kimliği.
store_countrystrMağaza tarafından iletilen ülke bilgisi.
profile_ip_addressstrProfil IP’si (IPv4 veya IPv6 olabilir; mevcut olduğunda IPv4 tercih edilir). Cihazın IP’si her değiştiğinde güncellenir.
profile_countrystrAdapty tarafından profil IP’sine göre belirlenir.
profile_total_revenue_usdfloatProfil için iadeler dahil toplam gelir.
variation_iduuidSatın almanın yapıldığı paywall’un benzersiz kimliği.
access_level_idstrÜcretli access level kimliği.
is_activeboolProfil için ücretli access level’ın aktif olup olmadığını belirten boolean.
will_renewboolÜcretli access level’ın yenilenip yenilenmeyeceğini belirten boolean.
is_refundboolİşlemin iade edilip edilmediğini belirten boolean.
is_lifetimeboolÜcretli access level’ın süresiz olup olmadığını belirten boolean.
is_in_grace_periodboolProfilin ek sürede olup olmadığını belirten boolean.
starts_atISO 8601 dateKullanıcı için ücretli access level’ın başladığı tarih ve saat.
renewed_atISO 8601 dateÜcretli erişimin yenileneceği tarih ve saat.
expires_atISO 8601 dateÜcretli erişimin sona ereceği tarih ve saat.
activated_atISO 8601 dateÜcretli erişimin etkinleştirildiği tarih ve saat.
billing_issue_detected_atISO 8601 dateÖdeme sorununun tespit edildiği tarih ve saat.
profile_has_access_levelBoolProfilin 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_purchaseprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_renewedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_cancelledcancellation_reason, trial_duration
trial_startedsubscription_expires_at, trial_duration
trial_convertedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
trial_cancelledcancellation_reason, trial_duration
non_subscription_purchaseprice_usd, proceeds_usd
billing_issue_detectedsubscription_expires_at, trial_duration
entered_grace_periodsubscription_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.