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

  1. Google Cloud hesabınızın IAM bölümüne gidin ve ilgili projeyi seçin ya da yeni bir proje oluşturun
30a81ef-CleanShot_2023-03-17_at_15.22.142x.webp
  1. Ardından, ”+ CREATE SERVICE ACCOUNT” düğmesine tıklayarak Adapty Attribution için yeni bir hizmet hesabı oluşturun
98f8ebf-CleanShot_2023-03-17_at_15.40.062x.webp
  1. 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.
2190c50-CleanShot_2023-03-17_at_15.48.552x.webp
  1. Özel bir JSON anahtarı oluşturmak ve indirmek için KEYS bölümüne gidin ve “ADD KEY” düğmesine tıklayın
8a45468-CleanShot_2023-03-17_at_15.58.092x.webp
  1. 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.
6ccd0f0-CleanShot_2023-03-17_at_16.03.162x.webp

2.2. Bucket İzinlerini Yapılandırın

  1. 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.
  2. PERMISSIONS bölümüne gidin ve GRANT ACCESS seçeneğini belirleyin.
3cdd937-CleanShot_2023-03-17_at_16.14.232x.webp
  1. 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
  2. Son olarak, değişiklikleri uygulamak için SAVE’e tıklayın
62801f4-CleanShot_2023-03-17_at_16.17.312x.webp
  1. Bucket adını ileride kullanmak üzere not almayı unutmayın

  2. 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

c967e16-CleanShot_2023-03-17_at_16.23.332x.webp

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

  1. Integrations -> Google Cloud Storage sayfasına gidin
  2. Export install events to Google Cloud Storage seçeneğini açın
  3. 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. |
ua-google-cloud.webp

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ütunAçıklama
adapty_profile_idBenzersiz Adapty profil tanımlayıcısı
install_idBenzersiz kurulum tanımlayıcısı
created_atKayıt oluşturma zaman damgası (ISO 8601)
installed_atUygulama kurulum zaman damgası (ISO 8601)
storeUygulama mağazası (ios, android)
countryKullanıcının ülke kodu (ISO 3166-1 alpha-2)
ip_addressİstemci IP adresi
idfaiOS Reklamverenler için Tanımlayıcı
idfviOS Satıcılar için Tanımlayıcı
gaidGoogle Reklamcılık Kimliği (Android)
android_idAndroid cihaz kimliği
app_set_idAndroid App Set Kimliği
channelAttribution kanalı
campaign_idKampanya tanımlayıcısı
campaign_nameKampanya adı
adset_idReklam seti tanımlayıcısı
adset_nameReklam seti adı
ad_idReklam tanımlayıcısı
ad_nameReklam adı
keyword_idAnahtar kelime tanımlayıcısı
keyword_nameAnahtar kelime adı
asa_org_idApple Search Ads organizasyon kimliği
asa_keyword_match_typeASA anahtar kelime eşleşme türü (Exact, Broad)
asa_attributionASA attribution verisi (JSON dizesi)
asa_conversion_typeASA dönüşüm türü
asa_country_or_regionASA ülkesi veya bölgesi
asa_creative_set_nameASA kreatif set adı
fbclidFacebook Tıklama Kimliği
ttclidTikTok Tıklama Kimliği
utm_sourceUTM kaynak parametresi
utm_mediumUTM medium parametresi
utm_campaignUTM kampanya parametresi
utm_termUTM term parametresi
utm_contentUTM içerik parametresi