Adapty Attribution’ın Amazon S3 ile entegrasyonu, kullanıcı edinme kampanya verilerini güvenli bir şekilde tek bir merkezi konumda saklamanıza olanak tanır. Kampanya performans verilerinizi, attribution verilerinizi ve kullanıcı edinme etkinliklerinizi Amazon S3 bucket’ınıza .csv dosyaları olarak kaydedebilirsiniz. Bu entegrasyonu kurmak için AWS Console ve Adapty Attribution kontrol panelinde birkaç basit adım izlemeniz 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 Attribution’ı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 gerekecektir.

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 Attribution’da entegrasyonu yapılandırın

1. Integrations -> Amazon S3 bölümüne gidin.
2. Export install events to Amazon S3 geçişini etkinleştirin.
3. Amazon S3 ile Adapty Attribution profillerini bağlamak 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 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 bir anahtar. Bu anahtarı indirilen csv dosyasında bulabilirsiniz. | | S3 Bucket Name | AWS bulutundaki belirli bir S3 bucket’ını tanımlayan, küresel ölçekte benzersiz bir ad. S3 bucket’ları, kullanıcıların dosya ve resim gibi veri nesnelerini bulutta depolamasına ve almasına olanak tanıyan basit bir depolama hizmetidir. | | Folder Inside the Bucket | Seçilen 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. | | Region (İsteğe bağlı) | Region bilginizi AWS Management Console’da IAM kullanıcı hesabınızdan alabilirsiniz. |

Manuel veri dışa aktarımı

Adapty Attribution, Amazon S3’e otomatik olay verisi dışa aktarımına ek olarak manuel dosya dışa aktarma özelliği de sunar. Bu özellik sayesinde kullanıcı edinme verileri için belirli bir tarih seçerek bu verileri S3 bucket’ınıza manuel olarak aktarabilirsiniz. Böylece hangi verileri ne zaman dışa aktaracağınız üzerinde daha fazla kontrol sahibi olursunuz.

Tablo yapısı

AWS S3 entegrasyonunda Adapty Attribution, kurulum etkinliklerine ait geçmiş verileri depolamak için bir tablo sunar. Bu tablo; kullanıcı profili, gelir ve kazançlar ile kaynak mağaza gibi çeşitli veri noktalarına ilişkin bilgiler içerir.

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 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 Uygulama Seti Kimliği
bundle_id	Uygulama paket 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 kuruluş 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 ülkesi veya bölgesi
asa_creative_set_name	ASA kreatif seti adı
fbclid	Facebook Tıklama Kimliği
ttclid	TikTok Tıklama Kimliği
utm_source	UTM kaynak parametresi
utm_medium	UTM ortam parametresi
utm_campaign	UTM kampanya parametresi
utm_term	UTM terim parametresi
utm_content	UTM içerik parametresi
click_time	Attribution’a bağlı tıklamanın Unix saniye cinsinden zaman damgası. Kuruluma atfedilen tıklama yoksa boş bırakılır.