Adapty’nin Amazon S3 entegrasyonu, etkinlik ve paywall ziyaret verilerini tek bir merkezi konumda güvenli biçimde saklamanıza olanak tanır. Abonelik etkinliklerinizi Amazon S3 bucket’ınıza .csv dosyaları olarak kaydedebileceksiniz.
Bu entegrasyonu kurmak için AWS Console ve Adapty Kontrol Paneli’nde birkaç basit adımı takip etmeniz gerekecek.

Amazon S3 entegrasyonunu nasıl kurarsınız

Veri almaya başlamak için aşağıdaki bilgilere ihtiyacınız olacak:

1. Access key ID
2. Secret access key
3. S3 bucket adı
4. S3 bucket içindeki klasör adı

Amazon S3 entegrasyonu için Integrations -> Amazon S3 sayfasına gidin, toggle’ı açık konuma getirin ve alanları doldurun.

Her şeyden önce, Amazon S3 ile Adapty profilleri arasında bağlantı kurmak için kimlik bilgilerini girin.

Adapty Kontrol Paneli’nde bağlantıyı kurmak için aşağıdaki alanlar gereklidir:

Alan	Açıklama
Access Key ID	AWS hizmetine erişimi doğrulamak için kullanılan benzersiz tanımlayıcı. Bu kimliği indirilen csv dosyasında bulabilirsiniz.
Secret Access Key	AWS hizmetine erişimi doğrulamak için Access Key ID ile birlikte kullanılan özel anahtar. Bu anahtarı indirilen csv dosyasında bulabilirsiniz.
S3 Bucket Name	AWS bulutundaki belirli bir S3 bucket’ını tanımlayan, küresel olarak benzersiz ad. S3 bucket’ları, kullanıcıların bulutta dosya ve görsel gibi veri nesnelerini depolamasına ve almasına olanak tanıyan basit bir depolama hizmetidir.
Folder Inside the Bucket	Seçili S3 bucket’ının içinde oluşturmak istediğiniz klasörün adı. S3’ün klasörleri, nesne anahtarı önekleri (yani klasör adları) kullanarak simüle ettiğini unutmayın.

Amazon S3 kimlik bilgileri nasıl oluşturulur

Bu kılavuz, AWS Console’da gerekli kimlik bilgilerini oluşturmanıza yardımcı olacaktır.

1. Erişim Politikası Oluşturun

Önce AWS Console’unuzdaki IAM Policy Dashboard sayfasına gidin ve Create Policy seçeneğini tıklayın.

Policy editor bölümüne aşağıdaki JSON’ı yapıştırın ve adapty-s3-integration-test kısmını kendi bucket adınızla değiştirin:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListObjectsInBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        },
        {
            "Sid": "AllowAllObjectActions",
            "Effect": "Allow",
            "Action": "s3:*Object",
            "Resource": [
                "arn:aws:s3:::adapty-s3-integration-test/*",
                "arn:aws:s3:::adapty-s3-integration-test"
            ]
        },
        {
            "Sid": "AllowBucketLocation",
            "Effect": "Allow",
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        }
    ]
}

Politika yapılandırmasını tamamladıktan sonra etiket eklemeyi seçebilirsiniz (isteğe bağlı) ve ardından son adıma geçmek için Next düğmesine tıklayın. Bu adımda politikanıza bir ad verip Create policy düğmesine tıklayarak oluşturma işlemini tamamlayın.

2. IAM kullanıcısı oluşturun

Adapty’nin ham veri raporlarını bucket’ınıza yükleyebilmesi için, ilgili bucket’a yazma erişimi olan bir kullanıcıya ait Access Key ID ve Secret Access Key bilgilerini sağlamanız gerekir.

Devam etmek için IAM Console’a gidin ve Users bölümünü seçin. Ardından Add users butonuna tıklayın.

Kullanıcıya bir isim verin, Access key – Programmatic access seçeneğini seçin ve izinlere geçin.

Bir sonraki adım için Add user to group seçeneğini işaretleyin ve ardından Create group butonuna tıklayın.

Ardından, Kullanıcı Grubunuza bir ad vermeniz ve daha önce oluşturduğunuz politikayı seçmeniz gerekir. Politikayı seçtikten sonra işlemi tamamlamak için Create group düğmesine tıklayın.

Grubu başarıyla oluşturduktan sonra lütfen seçin ve bir sonraki adıma geçin.

Bu bölümün son adımı olduğundan, Create User düğmesine tıklayarak devam edebilirsiniz.

Son olarak, kimlik bilgilerini .csv formatında indirebilir ya da doğrudan kontrol panelinden kopyalayıp yapıştırabilirsiniz.

Manuel veri dışa aktarımı

Amazon S3’e otomatik etkinlik verisi dışa aktarımına ek olarak, Adapty manuel dosya dışa aktarımı özelliği de sunar. Bu özellik sayesinde etkinlik verileri için belirli bir zaman aralığı seçerek bunları S3 bucket’ınıza manuel olarak aktarabilirsiniz. Bu, hangi verileri ne zaman dışa aktaracağınız konusunda size daha fazla kontrol imkânı tanır.

Belirlenen tarih aralığı, A Tarihi 00:00:00 UTC ile B Tarihi 23:59:59 UTC arasında oluşturulan etkinlikleri dışa aktarmak için kullanılır.

Tablo yapısı

AWS S3 entegrasyonunda Adapty, işlem olayları ve paywall ziyaretlerine ait geçmiş verileri saklamak için bir tablo sunar. Tablo; kullanıcı profili, gelir ve kazançlar ile kaynak mağaza gibi birçok veri noktasını içerir. Temelde bu tablolar, bir uygulamanın belirli bir zaman diliminde oluşturduğu tüm işlemleri kaydeder.

İşte event’ler için tablo yapısı:

Sütun	Açıklama
profile_id	Adapty kullanıcı ID’si.
event_type	Küçük harfli event adı. Event türlerini öğrenmek için Events bölümüne bakın.
event_datetime	ISO 8601 tarihi.
transaction_id	Satın alma veya yenileme gibi bir işlem için benzersiz tanımlayıcı.
original_transaction_id	Orijinal satın almanın işlem tanımlayıcısı.
subscription_expires_at	Aboneliğin sona erme tarihi. Genellikle gelecekte bir tarihtir.
environment	Sandbox veya Production olabilir.
revenue_usd	USD cinsinden gelir. Boş olabilir.
proceeds_usd	USD cinsinden net hasılat. Boş olabilir.
net_revenue_usd	USD cinsinden net gelir (vergiler düşüldükten sonra). Boş olabilir.
tax_amount_usd	USD cinsinden kesilen vergi tutarı. Boş olabilir.
revenue_local	Yerel para biriminde gelir. Boş olabilir.
proceeds_local	Yerel para biriminde net hasılat. Boş olabilir.
net_revenue_local	Yerel para biriminde net gelir (vergiler düşüldükten sonra). Boş olabilir.
tax_amount_local	Yerel para biriminde kesilen vergi tutarı. Boş olabilir.
customer_user_id	Geliştirici kullanıcı ID’si. Örneğin kullanıcı UUID’niz, e-postanız veya başka bir ID olabilir. Ayarlamadıysanız null döner.
store	app_store veya play_store olabilir.
product_id	Apple App Store, Google Play Store veya Stripe’taki ürün ID’si. 12 aylık taahhüt planı için değer <product_id>:monthly şeklindedir.
base_plan_id	Google Play Store’daki Base plan ID veya Stripe’taki fiyat ID’si.
developer_id	İşlemin gerçekleştiği paywall’ın geliştirici (SDK) ID’si.
ab_test_name	İşlemin gerçekleştiği A/B testinin adı. Çapraz placement A/B testi için tek bir placement’taki testin adı (<test name> child-N). Çapraz placement testini placement’lar genelinde gruplandırmak için ab_test_id kullanın.
ab_test_revision	İşlemin gerçekleştiği A/B testinin revizyonu.
paywall_name	İşlemin gerçekleştiği paywall’ın adı. Bir flow için paywall ekranının ID’si (scr_...). Flow adı flow_name alanındadır.
paywall_revision	İşlemin gerçekleştiği paywall’ın revizyonu.
profile_county	Adapty tarafından IP’ye göre belirlenen profil ülkesi.
install_date	Kurulumun gerçekleştiği ISO 8601 tarihi.
idfv	iOS cihazlarda identifierForVendor
idfa	iOS cihazlarda advertisingIdentifier
advertising_id	Advertising ID, Android işletim sistemi tarafından atanan ve reklamcıların kullanıcının cihazını benzersiz şekilde tanımlamak için kullanabileceği benzersiz bir koddur.
ip_address	Cihaz IP’si (IPv4 veya IPv6 olabilir; mevcut olduğunda IPv4 tercih edilir). Cihazın IP’si her değiştiğinde güncellenir.
cancellation_reason	Kullanıcının aboneliği iptal etme nedeni. Şunlar olabilir: iOS & Android voluntarily_cancelled, billing_error, refund iOS price_increase, product_was_not_available, unknown, upgraded Android new_subscription_replace, cancelled_by_developer
android_app_set_id	Bir AppSetId — para kazanmayan reklam kullanım senaryoları için cihaz başına, geliştirici hesabı başına, kullanıcı tarafından sıfırlanabilir benzersiz ID.
android_id	Android 8.0 (API seviye 26) ve üzeri sürümlerde, uygulama imzalama anahtarı, kullanıcı ve cihaz kombinasyonuna özgü 64 bitlik bir sayı (onaltılık dize olarak ifade edilir). Daha fazla bilgi için Android geliştirici belgelerine bakın.
device	Son kullanıcıya görünen cihaz modeli adı.
currency	İşlemin 3 harfli para birimi kodu (ISO-4217).
store_country	Apple/Google mağazası tarafından belirlenen profil ülkesi.
attribution_source	Attribution kaynağı.
attribution_network_user_id	Attribution kaynağı tarafından kullanıcıya atanan ID.
attribution_status	organic, non_organic veya unknown olabilir.
attribution_channel	Pazarlama kanalı adı.
attribution_campaign	Pazarlama kampanyası adı.
attribution_ad_group	Attribution reklam grubu.
attribution_ad_set	Attribution reklam seti.
attribution_creative	Attribution kreatif anahtar kelimesi.
attributes	Özel kullanıcı attribute’larının JSON’ı. Mobil uygulamanızdan gönderecek şekilde ayarladığınız tüm özel attribute’ları içerir. Göndermek için Integrations -> Webhooks sayfasındaki Send User Attributes seçeneğini etkinleştirin.
integration_ids	Bir profille ilişkili tüm entegrasyon ID’leri. Sözlük. Örnek: {‘mixpanel_user_id’: ‘mixpanelUserId-test’, ‘facebook_anonymous_id’: ‘facebookAnonymousId-test’}
variation_id	İşlemin gerçekleştiği paywall’ın benzersiz ID’si. Bir flow için, A/B testi varyantı değil, flow içindeki paywall ekranının ID’si.
flow_id	İşlemin gerçekleştiği flow’un ID’si.
flow_name	İşlemin gerçekleştiği flow’un adı.
flow_variation_id	Bu placement’taki flow varyantının ID’si; SDK’daki flow.variationId ile aynıdır.
ab_test_id	İşlemin gerçekleştiği A/B testinin ID’si. Çapraz placement A/B testi için her placement’ta aynıdır.
ab_test_variant_id	İşlemin gerçekleştiği A/B testi varyantının ID’si. İşlemleri test varyantına göre ayırt etmek için kullanın.
ab_test_variant_name	A/B testi varyantının adı.
ab_test_parent_name	Çapraz placement A/B testinin adı. Diğer A/B testleri için boştur.

Flow ve A/B testi sütunları dosyanın son sütunlarıdır. Adapty bunları dışa aktarma sırasında hesapladığından, A/B testini, varyantı veya flow’u yeniden adlandırdıysanız dışa aktarmadaki ad daha önceki bir webhook olayındaki addan farklı olabilir. Her A/B testi türünde her sütunun ne içerdiğini görmek için Flow ve A/B testi alanları bölümüne bakın.

Paywall ziyaretlerine ait tablo yapısı aşağıdadır:

Sütun	Açıklama
profile_id	Adapty kullanıcı ID’si.
customer_user_id	Geliştirici kullanıcı ID’si. Örneğin kullanıcı UUID’niz, e-postanız veya başka bir ID olabilir. Ayarlamadıysanız null.
profile_country	Apple/Google store tarafından belirlenen profil ülkesi.
install_date	Kurulumun gerçekleştiği ISO 8601 tarih değeri.
store	app_store veya play_store olabilir.
paywall_showed_at	Paywallın kullanıcıya gösterildiği tarih.
developer_id	İşlemin gerçekleştiği paywallın geliştirici (SDK) ID’si.
ab_test_name	İşlemin gerçekleştiği A/B testinin adı.
ab_test_revision	İşlemin gerçekleştiği A/B testinin revizyonu.
paywall_name	İşlemin gerçekleştiği paywallın adı.
paywall_revision	İşlemin gerçekleştiği paywallın revizyonu.

Etkinlikler ve etiketler

İntegrasyon tarafından iletilen verileri yönetebilirsiniz. İntegrasyon aşağıdaki yapılandırma seçeneklerini sunar:

Ayar	Açıklama
Exclude Historical Events	Adapty SDK’nın yüklendiği günden önce gerçekleşen etkinlikleri dışarıda bırakmak için bu seçeneği işaretleyin. Bu sayede etkinlik tekrarının önüne geçilir ve raporlama doğruluğu korunur. Örneğin, bir kullanıcı 10 Ocak’ta aylık abonelik başlattıysa ve uygulamayı Adapty SDK ile 6 Mart’ta güncelledi ise Adapty, 6 Mart öncesindeki etkinlikleri atlar ve sonraki etkinlikleri saklar.
Include events without profile	Adapty’de bir kullanıcı profiline bağlı olmayan işlemleri dahil etmek için bu seçeneği işaretleyin. Bunlar; Adapty SDK yüklenmeden önce yapılan satın almalar ya da mağaza sunucu bildirimlerinden gelen ve belirli bir kullanıcıyla hemen ilişkilendirilemeyen işlemler olabilir.
Send User Attributes	Dil tercihleri gibi kullanıcıya özgü öznitelikleri göndermek istiyorsanız ve OneSignal planınız 10’dan fazla etiketi destekliyorsa bu seçeneği etkinleştirin. Etkinleştirildiğinde varsayılan 10 etiketin ötesinde ek bilgiler gönderilebilir. Etiket sınırının aşılması hatalara yol açabileceğini unutmayın.

Entegrasyon ayarlarının altında, Adapty’den Amazon S3’e aktarıp depolayabileceğiniz üç grup etkinlik bulunur. İhtiyacınız olanları açmanız yeterli. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz.