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:

Note

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.

Note

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.

ÖzellikTürAçıklama
profile_iduuidAdapty kullanıcı ID’si.
currencystrYerel para birimi (varsayılan olarak USD).
price_usdfloatApple/Google kesintisi öncesi ürün fiyatı. Gelir.
proceeds_usdfloatApple/Google kesintisi sonrası ürün fiyatı. Net gelir.
net_revenue_usdfloatNet gelir (Apple/Google kesintisi ve vergiler sonrası gelir) USD cinsinden. Boş olabilir.
price_localfloatApple/Google kesintisi öncesi yerel para birimi cinsinden ürün fiyatı. Gelir.
proceeds_localfloatApple/Google kesintisi sonrası yerel para birimi cinsinden ürün fiyatı. Net gelir.
transaction_idstrSatın alma veya yenileme gibi bir işlem için benzersiz tanımlayıcı.
original_transaction_idstrOrijinal satın almanın işlem tanımlayıcısı.
purchase_dateISO 8601 dateÜrün satın alma tarihi ve saati.
original_purchase_dateISO 8601 dateOrijinal satın alma tarihi ve saati.
environmentstrSandbox veya Production olabilir.
vendor_product_idstrApple App Store, Google Play Store veya Stripe’taki ürün ID’si.
base_plan_idstrGoogle Play Store’daki temel plan ID’si veya Stripe’taki fiyat ID’si.
event_datetimeISO 8601 dateEtkinliğin tarihi ve saati.
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 & 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 kapsar.
rate_after_first_yearboolAboneliğin bir yıllık kesintisiz yenilemenin ardından indirimli komisyon oranına (genellikle %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 Mağaza komisyonu ve vergiler bölümüne bakın.
promotional_offer_idstrAdapty Kontrol Paneli’nin Ürün bölümünde belirtilen promosyon teklifi ID’si.
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ın adı.
paywall_revisionintİşlemin gerçekleştiği paywallın revizyonu. Değer 1 olarak ayarlanır.
developer_idstrİşlemin gerçekleştiği placementin geliştirici (SDK) ID’si.
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 etkinlik ID’si.
store_countrystrMağaza tarafından gönderilen ü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_usdfloatİadeler dahil profil için toplam gelir.
variation_iduuidSatın almanın yapıldığı paywallın benzersiz ID’si.
access_level_idstrÜcretli access level ID’si.
is_activeboolÜcretli access level’ın profil için aktif olup olmadığını gösteren boolean değer.
will_renewboolÜcretli access level’ın yenilenip yenilenmeyeceğini gösteren boolean değer.
is_refundboolİşlemin iade edilip edilmediğini gösteren boolean değer.
is_lifetimeboolÜcretli access level’ın süresiz erişim olup olmadığını gösteren boolean değer.
is_in_grace_periodboolProfilin ek süre içinde olup olmadığını gösteren boolean değer.
starts_atISO 8601 dateÜcretli access level’ın kullanıcı için başladığı tarih ve saat.
renewed_atISO 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_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 dateFatura sorunununun tespit edildiği tarih ve saat.
profile_has_access_levelBoolProfilin aktif bir access level’a sahip olup olmadığını gösteren boolean değer (yalnızca Webhook için).

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.