Custom S3
Adapty UA’nın özel S3 uyumlu depolama entegrasyonu, kullanıcı edinme kampanya verilerini kendi S3 uyumlu depolama çözümünüzde güvenli şekilde saklamanızı sağlar. Kampanya performans verilerinizi, attribution verilerinizi ve kullanıcı edinme etkinliklerini özel S3 bucket’ınıza .csv dosyaları olarak kaydedebilirsiniz.
Bu entegrasyonu kurmak için S3 uyumlu depolama konsolunuzda ve Adapty UA kontrol panelinde birkaç basit adımı izlemeniz gerekir.
Adapty UA verilerinizi her 24 saatte bir, UTC 04:00’da gönderir.
Her dosya, UTC’de önceki tam takvim günü boyunca oluşturulan etkinliklerin verilerini içerir. Örneğin 8 Mart’ta UTC 04:00’da otomatik olarak dışa aktarılan veriler, 7 Mart’ta UTC 00:00:00 ile 23:59:59 arasında oluşturulan tüm etkinlikleri kapsar.
Custom S3 entegrasyonunu kurma
Veri almaya başlamak için Adapty UA’da entegrasyonu yapılandırın:
- Integrations -> Custom S3 bölümüne gidin.
- Export install events to custom S3 geçiş düğmesini açın.
- Özel S3 depolama alanınızla Adapty UA profilleri arasında bağlantı kurmak için gerekli alanları doldurun.
| Alan | Açıklama |
|---|---|
| Access Key ID | S3 uyumlu depolama hizmetinize bir kullanıcı veya uygulamanın erişimini doğrulamak için kullanılan benzersiz tanımlayıcı. Bu kimliği depolama sağlayıcınızın konsolunda bulabilirsiniz. |
| Secret Access Key | S3 uyumlu depolama hizmetinize erişimi doğrulamak için Access Key ID ile birlikte kullanılan özel anahtar. Bu anahtarı depolama sağlayıcınızın konsolunda bulabilirsiniz. |
| S3 Bucket Name | Depolama ortamınızdaki belirli bir S3 bucket’ını tanımlayan, küresel olarak benzersiz ad. S3 bucket’ları, kullanıcıların dosyalar ve görseller gibi veri nesnelerini bulutta depolamasına ve almasına olanak tanıyan basit bir depolama hizmetidir. |
| Region (İsteğe bağlı) | Bölgenizi Yönetim Konsolu’ndan alabilirsiniz. |
| Folder Inside the Bucket (İsteğe bağlı) | Seçili S3 bucket’ının içinde oluşturmak istediğiniz klasörün adı. S3’ün klasörleri, nesne anahtar önekleri kullanarak simüle ettiğini unutmayın; bu önekler aslında klasör adlarıdır. |
| Custom Endpoint URL | S3 uyumlu depolama hizmetinizin endpoint URL’si. Bu, depolama sağlayıcınız tarafından sağlanmalıdır (ör. MinIO, DigitalOcean Spaces, Wasabi vb.). |
S3 bucket adı alanında iç içe dizinler de belirtebilirsiniz, ör. adapty-ua-events/com.sample-app
Manuel veri dışa aktarma
Özel S3 depolama alanınıza otomatik etkinlik verisi dışa aktarmanın yanı sıra Adapty UA, manuel dosya dışa aktarma işlevi de sunar. Bu özellikle, kullanıcı edinme verilerinin tarihini seçerek S3 bucket’ınıza manuel olarak aktarabilirsiniz. Bu sayede hangi verileri ne zaman dışa aktardığınız üzerinde daha fazla kontrol sahibi olursunuz.
Tablo yapısı
Custom S3 entegrasyonunda Adapty UA, yükleme etkinliklerine ait geçmiş verileri depolamak için bir tablo sunar. Tablo; kullanıcı profili, gelir ve kazanç, kaynak mağaza ve daha pek çok veri noktasına ilişkin bilgiler içerir.
Bu yapının zamanla büyüyebileceğini unutmayın; bizim ya da birlikte çalıştığımız üçüncü tarafların yeni veriler eklemesiyle tablo genişleyebilir. Bu yapıyı işleyen kodunuzun yeterince sağlam olduğundan ve belirli alanlara dayandığından, tüm yapıya değil, emin olun.
Etkinliklere ait tablo yapısı aşağıdaki gibidir:
| Sütun | Açıklama |
|---|---|
adapty_profile_id | Benzersiz Adapty profil tanımlayıcısı |
install_id | Benzersiz yükleme tanımlayıcısı |
created_at | Kayıt oluşturma zaman damgası (ISO 8601) |
installed_at | Uygulama yükleme zaman damgası (ISO 8601) |
store | Uygulama mağazası (ios, android) |
country | Kullanıcının ülke kodu (ISO 3166-1 alpha-2) |
ip_address | İstemci IP adresi |
idfa | iOS Reklamverenler İçin Tanımlayıcı |
idfv | iOS Satıcılar İçin Tanımlayıcı |
gaid | Google Reklam Kimliği (Android) |
android_id | Android cihaz kimliği |
app_set_id | Android Uygulama Seti Kimliği |
channel | Attribution kanalı |
campaign_id | Kampanya tanımlayıcısı |
campaign_name | Kampanya adı |
adset_id | Reklam seti tanımlayıcısı |
adset_name | Reklam seti adı |
ad_id | Reklam tanımlayıcısı |
ad_name | Reklam adı |
keyword_id | Anahtar kelime tanımlayıcısı |
keyword_name | Anahtar kelime adı |
asa_org_id | Apple Search Ads organizasyon kimliği |
asa_keyword_match_type | ASA anahtar kelime eşleşme türü (Exact, Broad) |
asa_attribution | ASA attribution verisi (JSON dizesi) |
asa_conversion_type | ASA dönüşüm türü |
asa_country_or_region | ASA ülke veya bölge |
asa_creative_set_name | ASA kreatif set adı |
fbclid | Facebook Tıklama Kimliği |
ttclid | TikTok Tıklama Kimliği |
utm_source | UTM kaynak parametresi |
utm_medium | UTM medium parametresi |
utm_campaign | UTM kampanya parametresi |
utm_term | UTM terim parametresi |
utm_content | UTM içerik parametresi |