Adapty Attribution'da Özel S3
Adapty Attribution’ın özel S3 uyumlu depolama ile entegrasyonu, kullanıcı edinme kampanya verilerini kendi S3 uyumlu depolama çözümünüzde güvenli bir şekilde saklamanıza olanak tanır. Kampanya performans verilerinizi, attribution verilerinizi ve kullanıcı edinme etkinliklerinizi özel S3 bucket’ınıza .csv dosyaları olarak kaydedebileceksiniz. Bu entegrasyonu kurmak için S3 uyumlu depolama konsolunuzda ve Adapty Attribution kontrol panelinde birkaç basit adımı izlemeniz gerekecek.
Adapty Attribution dışa aktarımları, her takvim günü için bir dosya seti oluşturur. Dışa aktarma zamanlayıcısı günde üç kez çalışır — 02:00, 04:00 ve 06:00 UTC. Her çalıştırma, bir önceki günün dışa aktarma işini henüz oluşturulmadıysa oluşturur ya da daha önceki bir çalıştırma başarısız olduysa yeniden dener. Bu nedenle verileriniz genellikle 02:00 çalıştırmasının ardından gelir; sonraki çalıştırmalar ise veri eklemek için değil, başarısız işlemleri kurtarmak için oradadır.
Her dosya, UTC saatine göre önceki takvim günü boyunca oluşturulan etkinliklere ait verileri içerecektir. Örneğin, 8 Mart’ta dışa aktarılan veriler, 7 Mart’ta 00:00:00 ile 23:59:59 UTC saatleri arasında oluşturulan tüm etkinlikleri içerecektir.
Zamanlanmış dışa aktarma yalnızca ücretli plana sahip veya deneme sürecindeki şirketler için çalışır. Şirketiniz bu iki kategoriden birine girmiyorsa, zamanlayıcı işlemi atlar ve kontrol panelinde entegrasyon etkin görünse bile hiçbir dosya yazmaz. Bucket’ınız boşsa ve yapılandırma doğru görünüyorsa önce plan durumunuzu kontrol edin.
Özel S3 entegrasyonunu kurma
Veri almaya başlamak için Adapty Attribution’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 Attribution profilleri arasındaki bağlantıyı 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 aktarımı
Otomatik etkinlik verisi dışa aktarımına ek olarak, Adapty Attribution; özel S3 depolama alanınıza manuel dosya dışa aktarımı da sunar. Bu özellik sayesinde kullanıcı edinim verilerini dilediğiniz tarihe göre seçerek S3 bucket’ınıza manuel olarak aktarabilirsiniz. Böylece hangi verileri ne zaman dışa aktaracağınız konusunda tam kontrol sizde olur.
Tablo yapısı
Özel S3 entegrasyonunda Adapty Attribution, kurulum olaylarına ait geçmişe dönük verileri depolamak için bir tablo sağlar. Bu tablo; kullanıcı profili, gelir ve kazanç bilgileri ile kaynak mağaza gibi çeşitli veri noktalarını içerir.
Bu yapının zamanla büyüyebileceğini unutmayın; bizim tarafımızdan veya birlikte çalıştığımız üçüncü taraflar tarafından yeni veriler eklenebilir. Bu yapıyı işleyen kodunuzun yeterince dayanıklı olduğundan ve yapının tamamına değil, belirli alanlara dayandığından emin olun.
Olaylara 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 kurulum tanımlayıcısı |
created_at | Kayıt oluşturma zaman damgası (ISO 8601) |
installed_at | Uygulama kurulum 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 için Tanımlayıcı |
idfv | iOS Satıcılar için Tanımlayıcı |
gaid | Google Reklam Kimliği (Android) |
android_id | Android cihaz kimliği |
app_set_id | Android App Set Kimliği |
bundle_id | Uygulama bundle tanımlayıcısı (ör. com.example.app) |
device_brand | Cihaz markası (ör. Apple, Samsung) |
device_model | Cihaz modeli (ör. iPhone15,2) |
os_version | Ana işletim sistemi sürümü |
app_version | Adapty SDK tarafından raporlanan uygulama sürümü |
sdk_version | Adapty SDK sürümü |
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 term parametresi |
utm_content | UTM içerik parametresi |
click_time | Attribution edilen tıklamanın Unix saniye cinsinden zaman damgası. Kuruluma atfedilen tıklama yoksa boştur. |