Adapty Attribution'da Google Cloud Storage
Adapty Attribution’ın Google Cloud Storage ile entegrasyonu, kullanıcı edinme kampanya verilerinizi tek bir merkezi konumda güvenli bir şekilde saklamanızı sağlar. Kampanya performans verilerinizi, attribution verilerinizi ve kullanıcı edinme etkinliklerinizi Google Cloud Storage bucket’ınıza .csv dosyaları olarak kaydedebilirsiniz. Bu entegrasyonu kurmak için Google Cloud Console ve Adapty Attribution Kontrol Paneli’nde birkaç basit adımı izlemeniz gerekecek.
Zamanlama
Adapty Attribution, verilerinizi her gün UTC 04:00’te Google Cloud Storage’a gönderir. Her dosya, UTC’de önceki takvim gününün tamamına ait olay verilerini içerir. Örneğin, 8 Mart’ta 04:00 UTC’de otomatik olarak dışa aktarılan veriler, 7 Mart’ta 00:00:00 ile 23:59:59 UTC arasında oluşturulan tüm olayları kapsar.
Google Cloud Storage entegrasyonu nasıl kurulur
Adım 1. Google Cloud Storage kimlik bilgilerini oluşturma
Bu kılavuz, Google Cloud Platform Console’da gerekli kimlik bilgilerini oluşturmanıza yardımcı olacaktır.
Adapty Attribution’ın ham veri raporlarını belirlediğiniz bucket’a yükleyebilmesi için servis hesabının anahtarı ve ilgili bucket’a yazma erişimi gereklidir. Servis hesabı anahtarını sağlayarak ve bucket’a yazma erişimi vererek, Adapty Attribution’ın ham veri raporlarını kendi platformundan depolama ortamınıza güvenli ve verimli bir şekilde aktarmasına izin vermiş olursunuz.
Lütfen dikkat edin: yalnızca Service Account HMAC key yetkilendirmesini destekliyoruz. Bu nedenle, Google Cloud Storage’a düzgün erişim sağlamak için Service Account HMAC key’inizin “Storage Object Viewer”, “Storage Legacy Bucket Writer” ve “Storage Object Creator” rollerine sahip olduğundan emin olmanız gerekmektedir.
2.1. Service Account Oluşturma
- Google Cloud hesabınızın IAM bölümüne gidin ve ilgili projeyi seçin ya da yeni bir proje oluşturun
- Ardından, ”+ CREATE SERVICE ACCOUNT” düğmesine tıklayarak Adapty Attribution için yeni bir hizmet hesabı oluşturun
- Erişim daha sonraki bir aşamada verileceğinden, ilk adımdaki alanları doldurun. Bu sayfa hakkında daha fazla ayrıntı okumak için belgelere buradan ulaşabilirsiniz.
- Özel bir JSON anahtarı oluşturmak ve indirmek için KEYS bölümüne gidin ve “ADD KEY” düğmesine tıklayın
- DETAILS bölümünde, yeni oluşturulan servis hesabına bağlı Email değerini bulun ve kopyalayın. Bu bilgi, ilerleyen adımlarda hesabı yetkilendirmek ve bucket’a yazma izni vermek için gerekli olacaktır.
2.2. Bucket İzinlerini Yapılandırın
- Google Cloud Storage’ın Buckets sayfasına gidin ve mevcut bir bucket seçin ya da Adapty Attribution’dan gelen kullanıcı edinme verisi raporlarını depolamak için yeni bir tane oluşturun.
- PERMISSIONS bölümüne gidin ve GRANT ACCESS seçeneğini belirleyin.
- PERMISSIONS bölümünde, daha önce beşinci adımda elde edilen hizmet hesabının E-posta adresini girin, ardından Storage Object Creator rolünü seçin
- Son olarak, değişiklikleri uygulamak için SAVE’e tıklayın
-
Bucket adını ileride kullanmak üzere not almayı unutmayın
-
Bu adımları tamamladıktan sonra Google Cloud Console’daki gerekli kurulum adımlarını başarıyla bitirmiş olacaksınız! Son adım, bucket adını girmek ve Adapty Attribution’da kullanmak üzere JSON dosyasını indirmektir
Adım 2. Adapty Attribution’da entegrasyonu yapılandırın
- Integrations -> Google Cloud Storage sayfasına gidin
- Export install events to Google Cloud Storage seçeneğini açın
- Google Cloud Storage ile Adapty Attribution arasında bağlantı kurmak için gerekli alanları doldurun: | Alan | Açıklama | |:------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Google Cloud service account key file | İndirilen özel JSON anahtar dosyası. | | Google Cloud bucket name | Verilerinizi depolamak istediğiniz Google Cloud Storage’daki bucket adı. Google Cloud Storage ortamında benzersiz olmalı ve boşluk içermemelidir. | | Folder inside the bucket | Verilerinizi depolamak istediğiniz bucket içindeki klasörün adı. Bucket içinde benzersiz olmalı ve verilerinizi düzenlemek için kullanılabilir. Bu alan isteğe bağlıdır. |
Manuel veri dışa aktarma
Google Cloud Storage’a otomatik etkinlik verisi dışa aktarmanın yanı sıra Adapty UA, manuel dosya dışa aktarma özelliği de sunar. Bu özellik sayesinde belirli bir tarih için kullanıcı edinimi verilerini seçip GCS bucket’ınıza manuel olarak aktarabilirsiniz. Bu, hangi verileri ne zaman dışa aktaracağınız konusunda daha fazla kontrol sahibi olmanızı sağlar.
Tablo yapısı
Google Cloud Storage entegrasyonunda Adapty Attribution, kurulum etkinliklerine ait geçmiş verileri depolamak için bir tablo sağlar. Tablo; kullanıcı profili, gelir ve kazançlar ile kaynak mağaza gibi birçok veri noktasına ilişkin bilgiler içerir.
Bu yapının zamanla büyüyebileceğini unutmayın; bizim tarafımızdan veya birlikte çalıştığımız üçüncü taraflarca yeni veriler eklenebilir. Bu yapıyı işleyen kodunuzun yeterince sağlam olduğundan ve belirli alanlara dayandığından, ancak yapının tamamına bağımlı olmadığından emin olun.
Etkinlikler için 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 Reklamcılık 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 ülkesi veya bölgesi |
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 |