Adapty UA’nın Amazon S3 entegrasyonu, kullanıcı edinme kampanya verilerinizi güvenli bir şekilde tek bir merkezi konumda saklamanıza olanak tanır. Kampanya performans verilerinizi, attribution verilerinizi ve kullanıcı edinme olaylarını Amazon S3 bucket’ınıza .csv dosyaları olarak kaydedebilirsiniz.
Bu entegrasyonu kurabilmek için AWS Console ve Adapty UA kontrol panelinde birkaç basit adımı takip etmeniz gerekecek.

Amazon S3 entegrasyonu nasıl kurulur

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ı

Adım 1. Amazon S3 kimlik bilgilerini oluşturun

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

1.1. Erişim Politikası Oluşturma

1. AWS Console’unuzda IAM Policy Dashboard sayfasına gidin
2. Create Policy seçeneğini seçin

3. Politika düzenleyicisine 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"
        }
    ]
}

4. Politika yapılandırmasını tamamladıktan sonra isteğe bağlı olarak etiket ekleyebilir, ardından son adıma geçmek için Next düğmesine tıklayabilirsiniz
5. Bu adımda politikanıza bir ad verin ve oluşturma işlemini tamamlamak için Create policy düğmesine tıklayın

1.2. IAM kullanıcısı oluşturma

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

1. IAM Console’a gidin ve Users bölümünü seçin
2. Add users düğmesine tıklayın

3. Kullanıcıya bir ad verin, Access key – Programmatic access seçeneğini işaretleyin ve izinler adımına geçin

4. Bir sonraki adımda Add user to group seçeneğini belirleyin ve ardından Create group düğmesine tıklayın

5. Kullanıcı Grubuna bir ad verin ve daha önce oluşturduğunuz politikayı seçin
6. Politikayı seçtikten sonra işlemi tamamlamak için Create group düğmesine tıklayın

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

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

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

Adım 2. Adapty UA’da entegrasyonu yapılandırın

1. Integrations -> Amazon S3 sayfasına gidin
2. Export install events to Amazon S3 geçiş düğmesini açın.
3. Amazon S3 ile Adapty UA profilleri arasındaki bağlantıyı kurmak için aşağıdaki alanları doldurun:

Alan	Açıklama
Access Key ID	AWS hizmetine erişimi doğrulamak için kullanılan benzersiz bir tanımlayıcı. Bu ID’yi indirilen csv dosyasında bulabilirsiniz.
Secret Access Key	AWS hizmetine erişimi doğrulamak için Access Key ID ile birlikte kullanılan özel bir anahtar. Bu anahtarı indirilen csv dosyasında bulabilirsiniz.
S3 Bucket Name	AWS bulutunda belirli bir S3 bucket’ını tanımlayan küresel olarak benzersiz ad. S3 bucket’ları, dosyalar ve resimler gibi veri nesnelerini bulutta depolamanızı ve almanızı sağlayan basit bir depolama hizmetidir.
Folder Inside the Bucker	Seçili S3 bucket’ı içinde oluşturmak istediğiniz klasörün adı. S3’ün klasörleri, nesne anahtar ön ekleri kullanarak simüle ettiğini, bunların temelde klasör adları olduğunu unutmayın.
Region (İsteğe bağlı)	Region bilginizi AWS Management Console’da IAM kullanıcı hesabınızdan alabilirsiniz.

Manuel veri dışa aktarma

Amazon S3’e otomatik olay verisi dışa aktarmanın yanı sıra, Adapty UA manuel dosya dışa aktarma özelliği de sunar. Bu özellik sayesinde kullanıcı edinme verileri için belirli bir tarih seçip 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.

Tablo yapısı

AWS S3 entegrasyonunda Adapty UA, kurulum olaylarına ait geçmiş verileri saklamak için bir tablo sunar. Tablo; kullanıcı profili, gelir ve kazançlar ile kaynak mağaza gibi bilgileri içerir.

Olaylar için tablo yapısı şu şekildedir:

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
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 yaratıcı 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