Webhook olay türleri ve alanları

Adapty, abonelik olaylarına karşılık olarak webhook’lar gönderir. Bu bölümde bu olay türleri ve her webhook’ta yer alan veriler açıklanmaktadır.

Webhook olay türleri

Tüm olay türlerini webhook’unuza gönderebilir ya da yalnızca bir kısmını seçebilirsiniz. Hangi tür verilerin geleceğini ve bunların etrafında iş mantığınızı nasıl oluşturacağınızı öğrenmek için Event flows sayfamıza göz atabilirsiniz. İhtiyaç duymadığınız olay türlerini, Webhook entegrasyonunu kurma adımında devre dışı bırakabilirsiniz. Aynı yerden, gerekirse Adapty’nin varsayılan olay kimliklerini kendi olay kimliklerinizle de değiştirebilirsiniz.

Event name	Description
subscription_started	Kullanıcı deneme süresi olmaksızın ücretli bir abonelik etkinleştirdiğinde, yani anında ücretlendirildiğinde tetiklenir.
subscription_renewed	Abonelik yenilendiğinde ve kullanıcı ücretlendirildiğinde gerçekleşir. Bu olay, deneme süreli veya deneme süresiz aboneliklerde ikinci ödemeden itibaren başlar.
subscription_renewal_cancelled	Kullanıcı abonelik otomatik yenilemesini kapattığında tetiklenir. Kullanıcı, ücretli abonelik süresi sonuna kadar premium özelliklere erişmeye devam eder.
subscription_renewal_reactivated	Kullanıcı abonelik otomatik yenilemesini yeniden etkinleştirdiğinde tetiklenir.
subscription_expired	İptal edilen bir abonelik tamamen sona erdiğinde tetiklenir. Örneğin, kullanıcı aboneliğini 12 Aralık’ta iptal etmiş ancak abonelik 31 Aralık’a kadar aktif kalmaya devam ediyorsa, olay aboneliğin sona erdiği 31 Aralık’ta kaydedilir.
subscription_paused	Kullanıcı abonelik duraklatma özelliğini etkinleştirdiğinde gerçekleşir (yalnızca Android).
subscription_deferred	Abonelik satın alımı ertelendiğinde tetiklenir; kullanıcılar premium özelliklere erişimlerini sürdürürken ödemeyi geciktirebilir. Bu özellik Google Play Developer API aracılığıyla kullanılabilir ve ücretsiz denemeler için ya da mali güçlük yaşayan kullanıcılara destek sağlamak amacıyla kullanılabilir.
non_subscription_purchase	Süresiz erişim veya oyun içi coin gibi consumable ürünler dahil, abonelik dışındaki tüm satın almalar.
trial_started	Kullanıcı deneme aboneliği etkinleştirdiğinde tetiklenir.
trial_converted	Deneme süresi sona erdiğinde ve kullanıcı ücretlendirildiğinde (ilk satın alma) gerçekleşir. Örneğin, kullanıcının denemesi 14 Ocak’a kadar sürüyor ancak 7 Ocak’ta ücretlendiriliyorsa, bu olay 7 Ocak’ta kaydedilir.
trial_renewal_cancelled	Kullanıcı deneme süresi boyunca abonelik otomatik yenilemesini kapattığında tetiklenir. Kullanıcı deneme süresi sonuna kadar premium özelliklere erişmeye devam eder; ancak ücretlendirilmez ve abonelik başlatılmaz.
trial_renewal_reactivated	Kullanıcı deneme süresi boyunca abonelik otomatik yenilemesini yeniden etkinleştirdiğinde gerçekleşir.
trial_expired	Deneme süresi aboneliğe dönüşmeden sona erdiğinde tetiklenir.
entered_grace_period	Ödeme girişimi başarısız olduğunda ve kullanıcı ek süreye girdiğinde gerçekleşir (etkinleştirilmişse). Kullanıcı bu süre boyunca premium erişimini korur.
billing_issue_detected	Ücretlendirme girişimi sırasında bir ödeme sorunu oluştuğunda (örn. yetersiz kart bakiyesi) tetiklenir.
subscription_refunded	Bir abonelik iade edildiğinde (örn. Apple Support tarafından) tetiklenir.
non_subscription_purchase_refunded	Abonelik dışı bir satın alma iade edildiğinde tetiklenir.
access_level_updated	Kullanıcının access level’ı güncellendiğinde gerçekleşir.

subscription_renewal_reactivated olayı, kullanıcının aboneliği iptal ettiği sırada aktif olan önceki ürün kimliğini taşır; kullanıcı daha sonra farklı bir ürün satın alarak aboneliği yeniden etkinleştirmiş olsa bile bu böyledir. Apple, iptal → yeniden etkinleştirme zinciri boyunca aynı original_transaction_id’yi kullandığından bu olay orijinal ürünü yansıtır. Yeni ürün, yeni ürüne ait faturalandırma başladığında gerçekleşen bir sonraki subscription_renewed olayında görünür.

Webhook etkinlik yapısı

Adapty, yalnızca Integrations -> Webhooks sayfasının Events names bölümünde seçtiğiniz etkinlikleri size gönderir. Webhook olayları JSON formatında serileştirilir. Sunucunuza gönderilen POST isteğinin gövdesi, aşağıdaki yapıya sarmalanmış serileştirilmiş olayı içerir. Tüm olaylar aynı yapıyı izler, ancak alanlar olay türüne, mağazaya ve özel yapılandırmanıza göre farklılık gösterir. Kullanıcı özellikleri, ayarladığınız özel kullanıcı özellikleridir, dolayısıyla yapılandırdığınız içerikleri barındırır. Attribution verisi alanları da tüm olay türleri için aynıdır; ancak attribution listesi, mobil uygulamanızda kullandığınız attribution kaynaklarına göre değişir. Aşağıda bir olay örneği görebilirsiniz:

{
  "profile_id": "00000000-0000-0000-0000-000000000000",
  "customer_user_id": "UserIdInYourSystem",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "profile_install_datetime": "2000-01-31T00:00:00.000000+0000",
  "user_agent": "ExampleUserAgent/1.0 (Device; OS Version) Browser/Engine",
  "email": "[email protected]",
  "event_type": "subscription_started",
  "event_datetime": "2000-01-31T00:00:00.000000+0000",
  "event_properties": {
    "store": "play_store",
    "currency": "USD",
    "price_usd": 4.99,
    "profile_id": "00000000-0000-0000-0000-000000000000",
    "cohort_name": "All Users",
    "environment": "Production",
    "price_local": 4.99,
    "base_plan_id": "b1",
    "developer_id": "onboarding_placement",
    "ab_test_name": "onboarding_ab_test",
    "ab_test_revision": 1,
    "paywall_name": "UsedPaywall",
    "proceeds_usd": 4.2315,
    "variation_id": "00000000-0000-0000-0000-000000000000",
    "purchase_date": "2024-11-15T10:45:36.181000+0000",
    "store_country": "AR",
    "event_datetime": "2000-01-31T00:00:00.000000+0000",
    "proceeds_local": 4.2415,
    "tax_amount_usd": 0,
    "transaction_id": "0000000000000000",
    "net_revenue_usd": 4.2415,
    "profile_country": "AR",
    "paywall_revision": "1",
    "profile_event_id": "00000000-0000-0000-0000-000000000000",
    "tax_amount_local": 0,
    "net_revenue_local": 4.2415,
    "vendor_product_id": "onemonth_no_trial",
    "profile_ip_address": "10.10.1.1",
    "consecutive_payments": 1,
    "rate_after_first_year": false,
    "original_purchase_date": "2000-01-31T00:00:00.000000+0000",
    "original_transaction_id": "0000000000000000",
    "subscription_expires_at": "2000-01-31T00:00:00.000000+0000",
    "profile_has_access_level": true,
    "profile_total_revenue_usd": 4.99,
    "promotional_offer_id": null,
    "store_offer_category": null,
    "store_offer_discount_type": null
  },
  "event_api_version": 1,
  "profiles_sharing_access_level": [{"profile_id": "00000000-0000-0000-0000-000000000000", "customer_user_id": "UserIdInYourSystem"}],
   "attributions": {
    "appsflyer": {
      "ad_set": "Keywords 1.12",
      "status": "non_organic",
      "channel": "Google Ads",
      "ad_group": null,
      "campaign": "Social media influencers - Rest of the world",
      "creative": null,
      "created_at": "2000-01-31T00:00:00.000000+0000"
    }
  },
  "user_attributes": {"Favourite_color": "Violet", "Pet_name": "Fluffy"},
  "integration_ids": {"firebase_app_instance_id": "val1", "branch_id": "val2", "one_signal_player_id": "val3"},
  "play_store_purchase_token": {
    "product_id": "product_123",
    "purchase_token": "token_abc_123",
    "is_subscription": true
  }
}

Etkinlik alanları

Etkinlik parametreleri tüm etkinlik türleri için aynıdır.

Alan	Tür	Açıklama
advertising_id	UUID	Reklam kimliği (yalnızca Android).
attributions	JSON	Attribution verisi. Webhook ayarları’nda Send Attribution etkinleştirilmişse eklenir.
customer_user_id	String	Kullanıcıları tanımlarken uygulama kodunuzda ayarladıysanız uygulamanızdaki kullanıcı kimliği (UUID, e-posta veya başka bir kimlik). Kullanıcıları uygulama kodunda tanımlamıyorsanız ya da bu kullanıcı anonimse (oturum açmamışsa) bu alan `null` olur.
email	String	Adapty SDK’daki `updateProfile` metodunu kullanarak veya sunucu taraflı API aracılığıyla profil oluştururken/güncellerken ayarladıysanız kullanıcının e-postası. `email` değerini SDK veya API metoduna geçirmiyorsanız bu alan `null` olur.
event_api_version	Integer	Adapty API sürümü (güncel: `1`).
event_datetime	ISO 8601	Etkinliğin gerçekleşme (iş) zamanı; örneğin bir satın alma için satın alma tarihi, sona erme için son kullanma tarihi — Adapty’nin etkinliği aldığı veya gönderdiği zaman değil. ISO 8601 formatı (ör. `2020-07-10T15:00:00.000000+0000`). Sıralama hakkında aşağıdaki nota bakın.
event_properties	JSON	Etkinlik özellikleri.
event_type	String	Adapty formatındaki etkinlik adı. Tam liste için Webhook etkinlik türleri’ne bakın.
idfa	UUID	Reklam kimliği (yalnızca Apple). Adapty Kontrol Paneli’ndeki profilde IDFA. İzleme kısıtlamaları, çocuk modu veya gizlilik ayarları nedeniyle kullanılamıyorsa `null` olabilir.
idfv	UUID	Geliştirici başına benzersiz Vendor Tanımlayıcısı (IDFV). Adapty Kontrol Paneli’ndeki profilde IDFV.
integration_ids	JSON	Adapty SDK’daki `setIntegrationIdentifier` metodunu kullanarak veya sunucu taraflı API aracılığıyla profil oluştururken/güncellerken ayarladıysanız kullanıcı entegrasyon kimlikleri. Kullanılamıyorsa veya entegrasyonlar devre dışıysa `null`.
play_store_purchase_token	JSON	Play Store satın alma token’ı; Webhook ayarları’nda Send Play Store purchase token etkinleştirilmişse eklenir.
profile_id	UUID	Adapty’nin her profil için otomatik olarak oluşturduğu profil kimliği. Kullanıcıları tanımlamıyorsanız veya giriş öncesi satın almalara izin veriyorsanız, bir Apple/Google kimliği farklı profil kimlikleriyle ilişkilendirilebilir. Adapty’nin üst/devralınan profillerle çalışma şekli hakkında daha fazla bilgi edinin.
profile_install_datetime	ISO 8601	ISO 8601 formatında kurulum zaman damgası (ör. `2020-07-10T15:00:00.000000+0000`).
profiles_sharing_access_level	JSON	Mevcut kullanıcı profili hariç access level’ı paylaşan kullanıcıların listesi. Uygulamanız için access level paylaşımı etkinleştirilmişse bu liste, aynı Apple/Google kimliğiyle kullanılmış diğer profilleri içerir. Format: profile_id: (UUID) Adapty kimliği customer_user_id: (String) Sağlanmışsa Customer User ID
user_agent	String	Cihaz tarayıcısı user-agent bilgisi.
user_attributes	JSON	Kullanıcı profillerini uygulamaya özgü bilgilerle zenginleştirmek için ayarlayabileceğiniz özel veriler. Genellikle kullanıcı tercihlerini (ör. tema, dil) veya davranış bayraklarını (onboarding tamamlandı, özellik kullanımı) takip etmek için kullanılır. Anahtarların string, değerlerin ise string veya sayı olduğu anahtar-değer çiftleri şeklinde biçimlendirilir (ör. `{"Favourite_color": "Violet", "Pet_name": "Fluffy"}`). Özel nitelikleri Adapty Kontrol Paneli’nde bireysel profiller için elle, Adapty SDK’daki `updateProfile` metodunu kullanarak programatik olarak ya da profil oluştururken/güncellerken sunucu taraflı API aracılığıyla ayarlayabilirsiniz. Webhook ayarları’nda Send User Attributes etkinleştirilmişse eklenir. Mobil uygulama kodundaki özel nitelik değerleri float veya string olarak ayarlanabilse de sunucu taraflı API veya geçmiş içe aktarma yoluyla alınan nitelikler farklı formatlarda gelebilir. Bu durumda boolean ve integer değerler float’a dönüştürülür.

event_datetime, bir etkinliğin abonelik yaşam döngüsünde ne zaman gerçekleştiğini yansıtır; Adapty’nin bunu ne zaman işlediğini veya ilettiğini değil. Bu nedenle, etkinlikler aynı event_datetime değerini paylaşabilir ya da kronolojik sıradan farklı bir sırada gelebilir. Örneğin, bir subscription_expired etkinliği, Adapty’nin daha önce ilettiği bir subscription_renewal_cancelled etkinliğinden daha erken bir event_datetime taşıyabilir. Etkinlikleri sıralamak için event_datetime değerine güvenmeyin. Bunun yerine, etkinlikleri kendi alım zamanınıza göre sıralayın ve profile_event_id ya da işlem kimliklerini kullanarak tekrar edenleri temizleyin.

Attributions

Attribution verilerini göndermek için Integrations -> Webhooks sayfasında Send Attribution seçeneğini etkinleştirin. Attribution verilerini göndermeyi etkinleştirdiyseniz ve attribution entegrasyonları kurduysanız, aşağıdaki veriler her kaynak için etkinlikle birlikte gönderilir. Aynı attribution verileri tüm etkinlik türlerine gönderilir.

{
  "attributions": {
    "appsflyer": {
      "ad_set": "sample_ad_set_123",
      "status": "non_organic",
      "channel": "sample_channel",
      "ad_group": "sample_ad_group_456",
      "campaign": "sample_ios_campaign",
      "creative": "sample_creative_789",
      "created_at": "2000-01-31T00:00:00.000000+0000",
      "network_user_id": "0000000000000-0000000"
    }
  }
}

Alan adı	Alan türü	Açıklama
ad_set	String	Attribution reklam seti.
status	String	`organic`, `non_organic,` veya `unknown` olabilir.
channel	String	Pazarlama kanalı adı.
ad_group	String	Attribution reklam grubu.
campaign	String	Pazarlama kampanyası adı.
creative	String	Attribution yaratıcı anahtar kelimesi.
created_at	ISO 8601 date	Attribution kaydının oluşturulma tarihi ve saati.
network_user_id	String	Attribution kaynağının kullanıcıya atadığı ID.

Entegrasyon ID’leri

Aşağıdaki entegrasyon ID’leri artık etkinliklerde kullanılmaktadır:

adjust_device_id
airbridge_device_id
amplitude_device_id
amplitude_user_id
appmetrica_device_id
appmetrica_profile_id
appsflyer_id
branch_id
facebook_anonymous_id
firebase_app_instance_id
mixpanel_user_id
pushwoosh_hwid
one_signal_player_id
one_signal_subscription_id
tenjin_analytics_installation_id
posthog_distinct_user_id

Play Store satın alma token’ı

Bu alan, gerektiğinde bir satın almayı yeniden doğrulamak için gereken tüm verileri içerir. Yalnızca Webhook entegrasyon ayarlarında Send Play Store purchase token seçeneği etkinleştirilmişse gönderilir.

Alan	Tür	Açıklama
product_id	String	Play Store’da satın alınan ürünün benzersiz tanımlayıcısı (SKU).
purchase_token	String	Google Play tarafından bu satın alma işlemini benzersiz şekilde tanımlamak için oluşturulan token.
is_subscription	Boolean	Satın alınan ürünün bir abonelik (`true`) mi yoksa tek seferlik satın alma (`false`) mı olduğunu belirtir.

Etkinlik özellikleri

Etkinlik özellikleri, etkinlik türüne ve hatta aynı türdeki etkinlikler arasında bile farklılık gösterebilir. Örneğin, App Store’dan gelen bir etkinlik, base_plan_id gibi Android’e özgü özellikleri içermez. Access Level Updated olayının kendine özgü özellikleri bulunduğundan, bu olay için ayrı bir bölüm hazırladık. Benzer şekilde, yalnızca belirli olay türlerine özgü oldukları için Ek vergi ve gelir olayı özellikleri de ayrı bir bölümde ele alınmaktadır.

Çoğu olay türü için

Access Level Updated etkinliği dışındaki çoğu etkinlik türü için etkinlik özellikleri tutarlıdır (Access Level Updated etkinliği kendi bölümünde açıklanmaktadır). Aşağıda özellikleri öne çıkaran ve hangi etkinliklere ait olduklarını gösteren kapsamlı bir tablo bulunmaktadır.

Alan	Tür	Açıklama
ab_test_name	String	İşlemin kaynaklandığı Adapty A/B testinin adı.
ab_test_revision	Integer	İşlemin kaynaklandığı A/B testinin revizyonu.
base_plan_id	String	Google Play Store’daki temel plan ID’si veya Stripe’taki fiyat ID’si.
cancellation_reason	String	Olası iptal nedenleri: `voluntarily_cancelled`, `billing_error`, `price_increase`, `product_was_not_available`, `refund`, `cancelled_by_developer`, `new_subscription_replace`, `upgraded`, `unknown`, `adapty_revoked`. Şu olay türlerinde bulunur: `subscription_cancelled`, `subscription_refunded` ve `trial_cancelled`.
cohort_name	String	Kullanıcıya hangi paywall’ın gösterileceğini belirleyen kitlenin adı.
consecutive_payments	Integer	Kullanıcının kesintisiz olarak abone olduğu dönem sayısı. Geçerli dönemi de kapsar.
currency	String	Yerel para birimi.
developer_id	String	İşlemin kaynaklandığı placement’ın ID’si.
environment	String	Olası değerler: `Sandbox` veya `Production`.
event_datetime	ISO 8601 date	Olayın tarih ve saati. Olayın kök düzeyindekiyle aynıdır.
original_purchase_date	ISO 8601 date	Yinelenen aboneliklerde orijinal satın alma, zincirdeki ilk işlemdir; orijinal işlem ID’si olarak adlandırılan ID’si yenileme zincirini birbirine bağlar; sonraki işlemler bunun uzantısıdır. Orijinal satın alma tarihi, bu ilk işlemin tarih ve saatidir.
original_transaction_id	String	Yinelenen aboneliklerde bu, yenileme zincirini birbirine bağlayan orijinal işlem ID’sidir. Orijinal işlem zincirdeki ilktir; sonraki işlemler bunun uzantısıdır. Uzantı yoksa `original_transaction_id`, store_transaction_id ile aynıdır.
paywall_name	String	İşlemin kaynaklandığı paywall’ın adı.
paywall_revision	String	İşlemin kaynaklandığı paywall’ın revizyonu. Varsayılan değer 1’dir.
price_local	Float	Apple/Google kesintisi öncesi ürün fiyatı (yerel para birimi cinsinden).
price_usd	Float	Apple/Google kesintisi öncesi ürün fiyatı (USD cinsinden).
profile_country	String	Adapty tarafından profil IP’sine göre belirlenir.
profile_event_id	UUID	Tekilleştirme amacıyla kullanılabilecek benzersiz olay ID’si.
profile_has_access_level	Boolean	Profilin aktif bir access level’a sahip olup olmadığını gösteren boolean değer.
profile_id	UUID	Adapty tarafından oluşturulan profil ID’si. Olayın kök düzeyindekiyle aynıdır.
profile_ip_address	String	Profil IP’si (IPv4 veya IPv6 olabilir; mevcut olduğunda IPv4 tercih edilir). Uygulama ayarlarında Collect users’ IP addresses devre dışıysa `null` döner.
profile_total_revenue_usd	Float	İadeler düşüldükten sonra profil için toplam gelir.
promotional_offer_id	String	Kullanılan promosyon teklifinin Adapty ID’si. Bu ID’yi kontrol panelinde teklif oluştururken siz belirlersiniz.
purchase_date	ISO 8601 date	Ürünün satın alındığı tarih ve saat.
rate_after_first_year	Boolean	Aboneliğin bir yıllık kesintisiz yenilemeden sonra indirimli komisyon oranına (%15) hak kazanıp kazanmadığını belirten 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.
store	String	Ürünün satın alındığı mağaza. Standart değerler: app_store, play_store, stripe, paddle. Sunucu tarafı API kullanarak özel mağaza işlemleri ayarladıysanız, store parametresindeki değer kullanılır.
store_country	String	Uygulama mağazası tarafından bize iletilen ülke.
store_offer_category	String	Uygulanan teklif kategorisi. Olası değerler: `introductory`, `promotional`, `winback`.
store_offer_discount_type	String	Uygulanan teklif türü. Olası değerler: `free_trial`, `pay_as_you_go` ve `pay_up_front`.
subscription_expires_at	ISO 8601 date	Aboneliğin bitiş tarihi. Genellikle gelecekte bir tarihtir.
transaction_id	String	İşlem için benzersiz tanımlayıcı.
trial_duration	String	Deneme süresinin gün cinsinden uzunluğu. ” days” formatında gönderilir; örneğin “7 days”. Yalnızca denemeyle ilgili olay türlerinde bulunur: `trial_started`, `trial_converted`, `trial_cancelled`.
variation_id	UUID	Satın almanın gerçekleştiği paywall’ın benzersiz ID’si.
vendor_product_id	String	Apple App Store, Google Play Store veya Stripe’taki ürün ID’si. Erişim gerçek bir mağaza işlemi olmadan verildiyse, `vendor_product_id` şu değerlerden biri olur: `adapty_server_side_product` — sunucu tarafı API aracılığıyla verildi. `adapty_dashboard_product` — Adapty Kontrol Paneli’nde manuel olarak verildi. `adapty_promotion` — eski sürüm.

Ek vergi ve gelir olayı özellikleri

Aşağıdaki vergi ve gelirle ilgili olay özellikleri, yalnızca belirli olay türleri için geçerli olan ek alanlardır. Yani listelenen olay türleri, Çoğu olay türü için olay özellikleri bölümündeki alanların yanı sıra aşağıda listelenen ek alanları da içerir.

Vergi ve gelir olay özelliklerine sahip olay türleri:

subscription_renewed
subscription_initial_purchase (subscription_started olarak da bilinir — aynı olaydır)
subscription_refunded
non_subscription_purchase | Alan | Tür | Açıklama | | :-------------------- | :---- | :----------------------------------------------------------- | | net_revenue_local | Float | Net gelir (Apple/Google payı ve vergiler düşüldükten sonraki gelir) yerel para biriminde. | | net_revenue_usd | Float | Net gelir (Apple/Google payı ve vergiler düşüldükten sonraki gelir) ABD doları cinsinden. | | proceeds_local | Float | Apple/Google payı düşüldükten sonraki ürün fiyatı yerel para biriminde. | | proceeds_usd | Float | Apple/Google payı düşüldükten sonraki ürün fiyatı. | | tax_amount_local | Float | Kesilen vergi tutarı yerel para biriminde. | | tax_amount_usd | Float | Kesilen vergi tutarı ABD doları cinsinden. |

`non_subscription_purchase` örnek payload’u

non_subscription_purchase, abonelik etkinlikleriyle aynı yapıyı izler ancak tek seferlik veya consumable bir satın almayı yansıtır. Yalnızca aboneliğe özgü alanlar geçerli değildir: cancellation_reason, will_renew, is_in_grace_period, is_refund, is_lifetime ve trial_duration bulunmaz. subscription_expires_at mevcut olsa da değeri null’dır. Vergi ve gelir alanları (net_revenue_*, proceeds_*, tax_amount_*) dahil edilmiştir.

Örnek payload (genişletmek için tıklayın)

{
  "profile_id": "00000000-0000-0000-0000-000000000000",
  "customer_user_id": "UserIdInYourSystem",
  "event_type": "non_subscription_purchase",
  "event_datetime": "2000-01-31T00:00:00.000000+0000",
  "event_properties": {
    "store": "app_store",
    "currency": "USD",
    "price_usd": 4.99,
    "price_local": 4.99,
    "proceeds_usd": 4.2415,
    "proceeds_local": 4.2415,
    "net_revenue_usd": 4.2415,
    "net_revenue_local": 4.2415,
    "tax_amount_usd": 0,
    "tax_amount_local": 0,
    "profile_id": "00000000-0000-0000-0000-000000000000",
    "environment": "Production",
    "vendor_product_id": "100coins",
    "transaction_id": "0000000000000000",
    "original_transaction_id": "0000000000000000",
    "purchase_date": "2024-11-15T10:45:36.181000+0000",
    "original_purchase_date": "2024-11-15T10:45:36.181000+0000",
    "subscription_expires_at": null,
    "store_country": "US",
    "profile_country": "US",
    "profile_ip_address": "10.10.1.1",
    "profile_has_access_level": false,
    "profile_total_revenue_usd": 4.99,
    "consecutive_payments": 1,
    "rate_after_first_year": false,
    "profile_event_id": "00000000-0000-0000-0000-000000000000"
  },
  "event_api_version": 1
}

Access Level Updated eventi için

Access Level Updated eventi, yalnızca Webhook entegrasyonu etkin olduğunda ve bu event türü etkinleştirildiğinde oluşturulan özel bir webhook eventidir. Etkinleştirilmişse, yapılandırılmış Webhook’a gönderilir ve Event Feed’de görünür. Etkinleştirilmemişse event oluşturulmaz.

Access level paylaşımını etkinleştirdiyseniz, access level updated eventi, access level’ı paylaşan tüm profiller için gönderilir.

Bu etkinliği kullanarak veritabanınızdaki kullanıcının access level’ını güncelleyebilir, backend’inizde premium özellikleri etkinleştirip devre dışı bırakabilir ve erişimi cihazlar veya platformlar arasında senkronize tutabilirsiniz.

Özellik	Tür	Açıklama
ab_test_name	String	İşlemin gerçekleştiği A/B testinin adı.
access_level_id	String	Access level’ın ID’si.
activated_at	ISO 8601 date	Erişimin en son etkinleştirildiği tarih ve saat.
active_introductory_offer_type	String	Uygulanan başlangıç teklifinin türü. Olası değerler: `free_trial`, `pay_as_you_go` ve `pay_up_front`.
active_promotional_offer_id	String	Adapty Kontrol Paneli’nin Ürün bölümünde belirtilen promosyon teklifinin ID’si.
active_promotional_offer_type	String	Uygulanan promosyon teklifinin türü. Olası değerler: `free_trial`, `pay_as_you_go` ve `pay_up_front`.
base_plan_id	String	Google Play Store’daki temel plan ID’si veya Stripe’taki fiyat ID’si.
billing_issue_detected_at	ISO 8601 date	Faturalama sorununun tespit edildiği tarih ve saat.
cancellation_reason	String	Olası iptal nedenleri: `voluntarily_cancelled`, `billing_error`, `price_increase`, `product_was_not_available`, `refund`, `cancelled_by_developer`, `new_subscription_replace`, `upgraded`, `unknown`, `adapty_revoked`.
cohort_name	String	Profilin ait olduğu kitlenin adı.
currency	String	Yerel para birimi (varsayılan olarak USD).
developer_id	String	İşlemin gerçekleştiği placement’ın ID’si.
environment	String	Olası değerler: `Sandbox` veya `Production`.
event_datetime	ISO 8601 date	Olayın tarih ve saati.
expires_at	ISO 8601 date	Erişimin sona ereceği tarih ve saat.
is_active	Boolean	Access level’ın aktif olup olmadığını gösteren Boolean değer.
is_in_grace_period	Boolean	Profilin ek süre içinde olup olmadığını gösteren Boolean değer.
is_lifetime	Boolean	Access level’ın süresiz erişim olup olmadığını gösteren Boolean değer.
is_refund	Boolean	İşlemin iade olup olmadığını gösteren Boolean değer.
original_purchase_date	ISO 8601 date	Yenilenen abonelikler için orijinal satın alma, zincirdeki ilk işlemdir; original transaction ID adı verilen ID’si yenileme zincirini birbirine bağlar; sonraki işlemler bunun uzantısıdır. Orijinal satın alma tarihi, bu ilk işlemin tarih ve saatidir.
original_transaction_id	String	Yenilenen abonelikler için bu, yenileme zincirini birbirine bağlayan orijinal işlem ID’sidir. Orijinal işlem zincirdeki ilkidir; sonraki işlemler bunun uzantısıdır. Uzantı yoksa `original_transaction_id`, store_transaction_id ile aynıdır. Orijinal satın almanın işlem tanımlayıcısı.
paywall_name	String	İşlemin gerçekleştiği paywall’un adı.
paywall_revision	String	İşlemin gerçekleştiği paywall’un revizyonu. Varsayılan değer 1’dir.
profile_country	String	Adapty tarafından profil IP’sine göre belirlenir.
profile_event_id	UUID	Tekilleştirme için kullanılabilecek benzersiz olay ID’si.
profile_has_access_level	Boolean	Profilin aktif bir access level’a sahip olup olmadığını gösteren Boolean değer.
profile_id	UUID	Adapty dahili kullanıcı profili ID’si.
profile_ip_address	String	Profil IP’si (IPv4 veya IPv6 olabilir; mevcut olduğunda IPv4 tercih edilir). Uygulama ayarlarında Collect users’ IP addresses devre dışıysa `null`.
profile_total_revenue_usd	Float	Profil için iadeler dahil toplam gelir.
purchase_date	ISO 8601 date	Ürünün satın alındığı tarih ve saat.
renewed_at	ISO 8601 date	Erişimin yenileneceği tarih ve saat.
starts_at	ISO 8601 date	Access level’ın başladığı tarih ve saat.
store	String	Ürünün satın alındığı mağaza. Standart değerler: app_store, play_store, stripe, paddle. Sunucu tarafı API’sini kullanarak özel mağaza işlemleri ayarladıysanız store parametresindeki değer kullanılır.
store_country	String	Uygulama mağazası tarafından Adapty’ye gönderilen ülke.
subscription_expires_at	ISO 8601 date	Aboneliğin sona erme tarihi.
transaction_id	String	Bir işlem için benzersiz tanımlayıcı.
trial_duration	String	Deneme süresinin gün cinsinden uzunluğu (ör. “7 days”).
variation_id	UUID	Satın almaları bu paywall’a atfetmek için kullanılan varyant tanımlayıcısı.
vendor_product_id	String	Mağazadaki (Apple/Google/Stripe) ürün ID’si. Gerçek bir mağaza işlemi olmadan erişim sağlandıysa `vendor_product_id` şunlardan biri olur: `adapty_server_side_product` — sunucu tarafı API’si aracılığıyla sağlandı. `adapty_dashboard_product` — Adapty Kontrol Paneli’nde manuel olarak sağlandı. `adapty_promotion` — eski sürüm.
will_renew	Boolean	Ücretli access level’ın yenilenip yenilenmeyeceğini gösterir.

Bu yapının zamanla büyüyebileceğini unutmayın — biz veya birlikte çalıştığımız üçüncü taraflar tarafından yeni veriler eklenebilir. Bu yapıyı işleyen kodunuzun yeterince sağlam olduğundan ve tüm yapıya değil, belirli alanlara dayandığından emin olun.

Webhook olay türleri ve alanları