Adapty SDK’yı yükleyip uygulamanızı yayınladıktan sonra, kullanıcılarınıza ve abonelerinize Profiller bölümünden erişebilirsiniz. Peki ya eski bir altyapınız varsa ve Adapty’ye geçiş yapmanız gerekiyorsa ya da mevcut verilerinizi Adapty’de görmek istiyorsanız?

Verileri Adapty’ye aktarmak için:

1. İşlemlerinizi bir CSV dosyasına aktarın (iOS, Android ve Stripe için ayrı dosyalar hazırlanmalıdır). Ayrıntılı gereksinimler için aşağıdaki İçe aktarma dosyası formatı bölümüne bakın.
2. Herhangi bir dosya 1 GB’ı aşıyorsa, yaklaşık 100 satırlık bir veri örneği hazırlayın.
3. Tüm dosyaları Google Drive’a yükleyin (sıkıştırabilirsiniz, ancak ayrı tutun).
4. iOS işlemleri için, StoreKit 1 kullansanı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 Issuer ID ve Key ID Sağlama ve In-App Purchase Key Dosyası Yükleme bölümlerine bakın.
5. Bağlantıları ekibimizle e-posta aracılığıyla veya Adapty Kontrol Paneli’ndeki çevrimiçi sohbet üzerinden paylaşın.

Geçmiş verilerin aktarılması, mevcut Adapty girdileriyle çakışsa bile yinelenen kayıtlar oluşturmaz.

Android için bilinen kısıtlamalar

1. Yalnızca aktif abonelikler geri yüklenecektir; süresi dolmuş işlemler geri yüklenmez.
2. Bir abonelikteki yalnızca en son yenilemeler geri yüklenecektir; satın alma zincirinin tamamı geri yüklenmez.
3. 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.

İçe aktarma dosyası formatı

Lütfen verilerinizi aşağıdaki kurallara uyan bir veya birden fazla dosyada hazırlayın:

• Dosya formatı .CSV olmalıdır.
• Android, iOS ve Stripe içe aktarmaları için ayrı dosyalar hazırlanmalıdır.
• Her içe aktarma dosyası tüm zorunlu sütunları içermelidir.
• İçe aktarma dosyalarındaki sütunların başlıkları olmalıdır.
• Sütun başlıkları aşağıdaki tablodaki Column name sütunuyla birebir aynı olmalıdır. Yazım hatalarını kontrol edin.
• Zorunlu olmayan sütunlar dosyada bulunmayabilir. Verisini almadığınız alanlar için boş sütun eklemeyin.
• İçe aktarma dosyaları tabloda belirtilmeyen ekstra sütunlar içermemelidir. Varsa lütfen silin.
• Değerler virgülle ayrılmalıdır.
• Değerler tırnak içine alınmamalıdır.
• 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 almaları 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	Orijinal işlem kimliği veya OTID (daha fazla bilgi), StoreKit 2 içe aktarma mekanizmasında kullanılır. Bir kullanıcının birden fazla OTID’i olabileceğinden, başarılı bir içe aktarma için en az birini sağlamak yeterlidir. Not: Bu içe aktarmanın çalışması için Adapty Kontrol Paneli’nizde In-app purchase API kimlik bilgilerinin ayarlanmış olması gerekir. Nasıl yapacağınızı buradan öğrenin.
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 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ı	Abonelik bitiş tarihi, yani bir sonraki ödeme tarihi; saat dilimi bilgisiyle birlikte tarih ve saat (2020-12-31T23:59:59-06:00)
created_at	isteğe bağlı	Profil oluşturma 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
email	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ı	ISO 3166-1 alpha-2 formatı
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’ın kullanıcının cihazına atadığı 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 (bu durumda sizin uygulamalarınıza) atanan benzersiz bir koddur. Yalnızca iOS uygulamaları için geçerlidir
advertising_id	isteğe bağlı	Reklam kimliği, reklamverenlerin 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ı profil kimliği
appmetrica_device_id	isteğe bağlı	AppMetrica’daki cihaz kimliği
appsflyer_id	isteğe bağlı	AppsFlyer’dan benzersiz tanımlayıcı
adjust_device_id	isteğe bağlı	Adjust’taki cihaz kimliği
facebook_anonymous_id	isteğe bağlı	Facebook’un, uygulamanız veya web sitenizle Facebook’a giriş yapmadan (anonim olarak) etkileşime giren kullanıcılar için oluşturduğu benzersiz tanımlayıcı
branch_id	isteğe bağlı	Branch’ten 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 yönlendirmedeki etkinliklerini belirlemek için takip edilen bir reklam veya pazarlama kampanyasında kullanılan belirli görsel veya metinsel öğeler
custom_attributes	isteğe bağlı	Anahtar-değer formatında JSON sözlüğü olarak en fazla 30 özel öznitelik tanımlayın: key: (string) Özel özniteliğin adı value: (string, integer, float veya boolean) Özel özniteliğin değeri. Format: "{'string_value': 'some_value', 'float_value': 123.0, 'int_value': 456}". Formatta çift ve tek tırnak kullanımına dikkat edin. Boolean ve tam sayı değerlerinin 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 Aktar

Lütfen bizimle iletişime geçin ve içe aktarma dosyalarınızı [email protected] adresi veya Adapty Kontrol Paneli’ndeki çevrimiçi sohbet aracılığıyla paylaşın.