Geçmiş verileri Adapty'ye aktarma
Adapty SDK’yı yükleyip uygulamanızı yayınladıktan sonra, Profiles bölümünden kullanıcılarınıza ve abonelerinize erişebilirsiniz. Peki ya eski bir altyapınız varsa ve Adapty’ye geçiş yapmak istiyorsanız ya da mevcut verilerinizi Adapty’de görmek istiyorsanız?
Veri aktarımı zorunlu değildir
Adapty, Adapty SDK entegre edilmiş uygulamayı açtıklarında geçmiş kullanıcılara otomatik olarak access level’lar verir ve satın alma etkinliklerini geri yükler. Bu kullanım senaryosunda geçmiş verilerin içe aktarılması gerekli değildir. Ancak önemli miktarda geçmiş işleminiz varsa veri içe aktarma, analizlerin doğruluğunu artırır; yine de bu işlem genel olarak migration için zorunlu değildir.
Bir destek ekibi, işlemin apple_original_transaction_id veya google_purchase_token değerini içe aktardıktan sonra Adapty, o işleme ait ilerideki App Store ve Play sunucu bildirimlerini otomatik olarak aynı profile eşler; kullanıcının uygulamayı önceden açması gerekmez.
Bir webhook veya başka bir entegrasyon, abonelik olayında ödül veriyorsa (örneğin, sanal para birimi), içe aktarmaya başlamadan önce entegrasyon ayarlarından söz konusu entegrasyon için Exclude Historical Events seçeneğini etkinleştirin. Aksi takdirde, içe aktarılan geçmiş satın almalar entegrasyon olaylarını yeniden tetikler ve ödül veren bir webhook, kullanıcının zaten sahip olduğu bir satın alma için ödülü ikinci kez verir. Bkz. Entegrasyonları Adapty’ye taşıma.
Verileri Adapty’ye içe aktarmak için:
- İşlemlerinizi bir CSV dosyasına aktarın (iOS, Android ve Stripe için ayrı dosyalar sağlanmalıdır). Ayrıntılı gereksinimler için aşağıdaki İçe aktarma dosyası biçimi bölümüne bakın.
- Herhangi bir dosya 1 GB’ı aşıyorsa, yaklaşık 100 satırlık bir veri örneği hazırlayın.
- Tüm dosyaları Google Drive’a yükleyin (sıkıştırabilirsiniz, ancak ayrı tutun).
- iOS işlemleri için, StoreKit 1 kullanıyor olsanız bile App settings içindeki In-app purchase API bölümünün Issuer ID, Key ID ve Private key (.P8 dosyası) ile doldurulduğundan emin olun. Ayrıntılı talimatlar için Adapty’ye Uygulama İçi Satın Alma anahtarı ekleme bölümüne bakın.
- Bağlantıları ekibimizle e-posta veya Adapty Kontrol Paneli’ndeki çevrimiçi sohbet aracılığıyla paylaşın.
Geçmiş verileri içe aktarmanın, Adapty’deki mevcut girişlerle örtüşse bile yinelenen kayıtlar oluşturmayacağı konusunda endişelenmenize gerek yok.
Android için bilinen kısıtlamalar
- Yalnızca aktif abonelikler geri yüklenecektir; süresi dolmuş işlemler geri yüklenmez.
- Bir abonelikteki yalnızca en son yenilemeler geri yüklenecektir; satın alma zincirinin tamamı geri yüklenmez.
- Satın alma tarihinden bu yana ürün fiyatı değişmişse, mevcut fiyat kullanılır ve bu da yanlış fiyatlandırmaya yol açabilir.
Büyük hacimde Android işleminiz varsa, varsayılan API sınırını aşmamak için içe aktarmaya başlamadan önce Google Play Developer API kota artışı talep etmeniz gerekebilir.
İçe aktarma dosyası formatı
RevenueCat’ten geçiş yapıyorsanız, RevenueCat dışa aktarma dosyasını doğrudan gönderebilirsiniz — dönüştürme gerekmez. Dışa aktarma talimatları için RevenueCat belgelerine bakın.
Lütfen verilerinizi aşağıdaki kurallara uyan bir veya birden fazla dosyada hazırlayın:
- Dosya formatı .CSV’dir.
- Android, iOS ve Stripe importları için ayrı dosyalar.
- Her import dosyası tüm zorunlu sütunları içerir.
- Import dosyasındaki sütunların başlıkları vardır.
- Sütun başlıkları, aşağıdaki tablonun Column name sütunundakiyle birebir aynıdır. Lütfen yazım hatalarını kontrol edin.
- Zorunlu olmayan sütunlar dosyada bulunmayabilir. Veriniz olmayan sütunlar için boş sütun eklemeyin.
- Import dosyalarında tabloda belirtilmeyen fazladan sütunlar olmamalıdır. Varsa lütfen silin.
- Değerler virgülle ayrılır.
- Değerler tırnak içine alınmaz.
- Bir kullanıcı için birden fazla apple_original_transaction_id varsa, her apple_original_transaction_id için ayrı satır olarak hepsini ekleyin. Aksi takdirde, consumable satın alımları geri yükleyemeyebiliriz.
Örnek dosyalar için lütfen iOS ve Android bağlantılarını kullanın.
Kullanılabilir içe aktarma dosyası sütunları
| Sütun adı | Varlık | Açıklama |
|---|---|---|
| user_id | zorunlu | Kullanıcınızın kimliği |
| apple_original_transaction_id | iOS için zorunlu | StoreKit 2 içe aktarma mekanizmasında kullanılan orijinal işlem kimliği veya OTID (daha fazla bilgi). Bir kullanıcının birden fazla OTID’i olabileceğinden, başarılı içe aktarma için en az bir tane sağlamanız yeterlidir. Not: Bu içe aktarmanın gerçekleştirilebilmesi için Adapty Kontrol Paneli’nde Uygulama İçi Satın Alma API kimlik bilgilerinin ayarlanmış olması gerekmektedir. Nasıl yapacağınızı buradan öğrenebilirsiniz. |
| google_product_id | Google için zorunlu | Google Play Store’daki ürün kimliği. |
| google_purchase_token | Google için zorunlu | Kullanıcıyı ve satın aldıkları uygulama içi ürünün ürün kimliğini temsil eden benzersiz bir tanımlayıcı |
| google_is_subscription | Google için zorunlu | Olası değerler: 1 | 0 |
| stripe_token | Stripe için zorunlu | Benzersiz bir satın almayı temsil eden Stripe nesnesinin token’ı. Stripe’ın Abonelik (sub_...) veya Ödeme Niyeti (pi_...) token’ı olabilir. |
| subscription_expiration_date | isteğe bağlı | Aboneliğin sona erme tarihi, yani bir sonraki ücretlendirme tarihi; saat dilimi bilgisiyle birlikte tarih ve saat (2020-12-31T23:59:59-06:00) |
| created_at | isteğe bağlı | Profilin oluşturulma tarihi ve saati (2019-12-31 23:59:59-06:00) |
| birthday | isteğe bağlı | Kullanıcının doğum tarihi, format: 2000-12-31 |
| isteğe bağlı | Kullanıcınızın e-posta adresi | |
| gender | isteğe bağlı | Kullanıcının cinsiyeti |
| phone_number | isteğe bağlı | Kullanıcınızın telefon numarası |
| country | isteğe bağlı | format ISO 3166-1 alpha-2 |
| first_name | isteğe bağlı | Kullanıcınızın adı |
| last_name | isteğe bağlı | Kullanıcınızın soyadı |
| last_seen | isteğe bağlı | Saat dilimi bilgisiyle birlikte tarih ve saat (2020-12-31T23:59:59-06:00) |
| idfa | isteğe bağlı | Reklam verenler için tanımlayıcı (IDFA), Apple tarafından kullanıcının cihazına atanan rastgele bir cihaz tanımlayıcısıdır. Yalnızca iOS uygulamaları için geçerlidir |
| idfv | isteğe bağlı | Satıcılar için tanımlayıcı (IDFV), tek bir geliştiricinin geliştirdiği tüm uygulamalara atanan benzersiz bir koddur; bu durumda uygulamalarınızı ifade eder. Yalnızca iOS uygulamaları için geçerlidir |
| advertising_id | isteğe bağlı | Reklam Kimliği, reklamcıların bir kullanıcının cihazını benzersiz şekilde tanımlamak için kullanabileceği, Android İşletim Sistemi tarafından atanan benzersiz bir koddur |
| amplitude_user_id | isteğe bağlı | Amplitude’deki kullanıcı kimliği |
| amplitude_device_id | isteğe bağlı | Amplitude’deki cihaz kimliği |
| mixpanel_user_id | isteğe bağlı | Mixpanel’deki kullanıcı kimliği |
| appmetrica_profile_id | isteğe bağlı | AppMetrica’daki kullanıcı profili kimliği |
| appmetrica_device_id | isteğe bağlı | AppMetrica’daki cihaz kimliği |
| appsflyer_id | isteğe bağlı | AppsFlyer’dan gelen benzersiz tanımlayıcı |
| adjust_device_id | isteğe bağlı | Adjust’tan gelen cihaz kimliği |
| facebook_anonymous_id | isteğe bağlı | Facebook’a giriş yapmadan uygulamanızla veya web sitenizle etkileşime giren kullanıcılar için Facebook tarafından oluşturulan benzersiz bir tanımlayıcı |
| branch_id | isteğe bağlı | Branch’ten gelen benzersiz tanımlayıcı |
| attribution_source | isteğe bağlı | Attribution’ın kaynak entegrasyonu, örneğin appsflyer |
| attribution_status | isteğe bağlı | organic |
| attribution_channel | isteğe bağlı | İşlemi getiren attribution kanalı |
| attribution_campaign | isteğe bağlı | İşlemi getiren attribution kampanyası |
| attribution_ad_group | isteğe bağlı | İşlemi getiren attribution reklam grubu |
| attribution_ad_set | isteğe bağlı | İşlemi getiren attribution reklam seti |
| attribution_creative | isteğe bağlı | Tıklama, dönüşüm veya yükleme gibi istenen eylemleri tetiklemedeki etkinliklerini ölçmek amacıyla takip edilen, bir reklam veya pazarlama kampanyasında kullanılan belirli görsel ya da metinsel öğeler |
| custom_attributes | isteğe bağlı | Anahtar-değer formatında JSON sözlüğü olarak en fazla 30 özel özellik tanımlayın:
Format: Formattaki çift ve tek tırnak kullanımına dikkat edin. Boolean ve integer değerlerin float’a dönüştürüleceğini unutmayın. |
Zorunlu Alanlar
Her platform için 2 grup zorunlu alan vardır: user_id ve ilgili platforma özgü satın almaları tanımlayan veriler. Platform başına zorunlu alanlar için aşağıdaki tabloya bakın.
| Platform | Zorunlu alanlar |
|---|---|
| iOS | user_id apple_original_transaction_id |
| Android | user_id google_product_id google_purchase_token google_is_subscription |
| Stripe | user_id stripe_token |
Bu alanlar olmadan Adapty işlemleri getiremez.
Doğru kohort analitiği için lütfen created_at alanını belirtin. Sağlanmazsa, yükleme tarihinin ilk satın alma tarihiyle aynı olduğu varsayılır.
Verileri Adapty’ye İçe Aktarma
Lütfen bizimle iletişime geçin ve içe aktarma dosyalarınızı support@adapty.io adresine veya Adapty Kontrol Paneli’ndeki çevrimiçi sohbet aracılığıyla paylaşın.