[GA4] BigQuery Export şeması

Bu makalede, Google Analytics 4 mülkü verilerinin ve BigQuery'ye aktarılan Firebase için Google Analytics verilerinin biçimi ve şeması açıklanmaktadır.

Veri kümeleri

BigQuery'ye bağlı her bir Google Analytics 4 mülkü ve Firebase projesi için BigQuery projenize "analytics_<property_id>" adlı tek bir veri kümesi eklenir. Mülk Kimliği, Google Analytics 4 mülkünüzdeki mülk ayarları ve Firebase'deki uygulama analizi ayarlarında bulabileceğiniz Analytics mülk kimliğinizi ifade eder. BigQuery dışa aktarma işleminin etkinleştirildiği her Google Analytics 4 mülkü ve her uygulama, verilerini bu tek veri kümesine aktarır.

Tablolar

Günlük dışa aktarma seçeneği etkinleştirilirse her gün her veri kümesinde events_YYYYMMDD adlı bir tablo oluşturulur.

Akış dışa aktarma seçeneği etkinleştirildiyse events_intraday_YYYYMMDD adlı bir tablo oluşturulur. Gün boyunca etkinlikler kaydedildikçe bu tablo sürekli olarak doldurulur. events_YYYYMMDD tamamlandığında bu tablo her günün sonunda silinir.

Etkinliklerin tetiklendiği tüm cihazlar, etkinliklerin tetiklendiği gün verilerini Analytics'e göndermez. Analytics, bu gecikmeyi hesaba katmak için günlük tabloları (events_YYYYMMDD) etkinlik tarihlerinden sonraki en fazla üç gün boyunca o tarihlere ilişkin etkinliklerle günceller. Etkinliklerde, geç gelme durumundan bağımsız olarak doğru zaman damgası bulunur. Bu üç günlük aralıktan sonra gelen etkinlikler kaydedilmez.

BigQuery korumalı alanını kullanıyorsanız etkinlikler gün içinde içe aktarılmaz ve ek sınırlar uygulanır.

Gün içinde içe aktarma işlemleri yapmak istiyorsanız korumalı alandan geçiş yapın.

Sütunlar

events_YYYYMMDD tablosundaki her bir sütun, etkinliğe özel bir parametreyi temsil eder. Bazı parametrelerin KAYIT türündeki verilerde iç içe yerleştirilmiş olduğunu ve items ile event_params gibi bazı KAYIT türündeki verilerin de tekrarlanabilir olduğunu unutmayın. Tablo sütunları aşağıda açıklanmıştır.

event
"event" alanlarında etkinliği benzersiz şekilde tanımlayan bilgiler bulunur.
Alan adı Veri türü Açıklama
batch_event_index TAM SAYI Bir gruptaki her etkinliğin cihazda gerçekleşme sırasına göre sıralamasını belirten sayı.
batch_ordering_id TAM SAYI Belirli bir sayfadan bir ağ isteği her gönderildiğinde artan sayı. Bu artış sırayla gerçekleşir.
batch_page_id TAM SAYI Bir sayfaya atanan ve etkileşimdeki her sonraki sayfa için artan sıralı sayı.
event_date STRING Etkinliğin günlüğe kaydedildiği tarih (uygulamanızın kayıtlı saat diliminde, YYYYAAGG biçiminde gösterilir).
event_timestamp TAM SAYI Etkinliğin istemcide günlüğe kaydedildiği zaman (mikrosaniye cinsinden, UTC saat diliminde).
event_previous_timestamp TAM SAYI Etkinliğin istemcide daha önce günlüğe kaydedildiği zaman (mikrosaniye cinsinden, UTC saat diliminde).
event_name STRING Etkinliğin adı.
event_value_in_usd KAYAN NOKTALI Etkinliğin "value" (değer) parametresinin para birimi dönüştürülmüş değeri (ABD Doları cinsinden).
event_bundle_sequence_id TAM SAYI Bu etkinliklerin yüklendiği paketin sıralı kimliği.
event_server_timestamp_offset TAM SAYI Toplama zamanı ile yükleme zamanı arasındaki zaman damgası farkı (mikrosaniye cinsinden).

Veri türü KAYIT olan event_params

Veri türü KAYIT olan event_params, kampanya düzeyindeki ve içeriğe dayalı etkinlik parametrelerinin yanı sıra kullanıcı tanımlı etkinlik parametrelerini de depolayabilir. Veri türü KAYIT olan event_params, bir etkinlikle ilişkilendirilen her anahtar için tekrarlanır.

Veri türü KAYIT olan event_params içinde depolanan parametre grubu, uygulanan her etkinlik parametresi için benzersizdir. Kendi uygulamanızdaki etkinlik parametrelerinin tam listesini görmek için etkinlik parametresi listesini sorgulayın.

Alan adı Veri türü Açıklama
event_params.key STRING Etkinlik parametresinin adı.
event_params.value KAYIT Etkinlik parametresi değerini içeren bir kayıt.
event_params.value.string_value STRING Etkinlik parametresi, URL veya kampanya adı gibi bir dizeyle temsil ediliyorsa bu alanda doldurulur.
event_params.value.int_value TAM SAYI Etkinlik parametresi, tam sayı ile temsil ediliyorsa bu alanda doldurulur.
event_params.value.double_value KAYAN NOKTALI Etkinlik parametresi, çift değerle temsil ediliyorsa bu alanda doldurulur.
event_params.value.float_value KAYAN NOKTALI Etkinlik parametresi, kayan nokta değeriyle temsil ediliyorsa bu alanda doldurulur. Bu alan şu anda kullanımda değildir.

Veri türü KAYIT olan item_params

Veri türü KAYIT olan item_params, öğe parametrelerinin yanı sıra kullanıcı tanımlı öğe parametrelerini de depolayabilir. Veri türü KAYIT olan item_params içinde depolanan parametre grubu, uygulanan her öğe parametresi için benzersizdir.

Alan adı Veri türü Açıklama
item_params.key STRING Öğe parametresinin adı.
item_params.value KAYIT Öğe parametresinin değerini içeren bir kayıt.
item_params.value.string_value STRING Öğe parametresi, dizeyle temsil ediliyorsa bu alanda doldurulur.
item_params.value.int_value TAM SAYI Öğe parametresi, tam sayı ile temsil ediliyorsa bu alanda doldurulur.
item_params.value.double_value KAYAN NOKTALI Öğe parametresi, çift değerle temsil ediliyorsa bu alanda doldurulur.
item_params.value.float_value KAYAN NOKTALI Öğe parametresi, kayan nokta değeriyle temsil ediliyorsa bu alanda doldurulur.
user
"user" alanları, etkinlikle ilişkilendirilen kullanıcıyı benzersiz şekilde tanımlayan bilgileri içerir.
Alan adı Veri türü Açıklama
is_active_user BOOLE

Takvim gününün herhangi bir noktasında kullanıcının etkin olup (Doğru) olmadığı (Yanlış).

Yalnızca günlük tablolara (events_YYYYMMDD)) dahil edilir.

user_id STRING Bir kullanıcıya atanan benzersiz kimlik.
user_pseudo_id STRING Kullanıcının belirsizleştirilmiş kimliği (ör. uygulama örneği kimliği). Kullanıcı uygulamayı ilk açtığında veya siteyi ziyaret ettiğinde kullanıcıya atanan benzersiz tanımlayıcı.
user_first_touch_timestamp TAM SAYI Kullanıcının uygulamayı ilk açtığı veya siteyi ilk ziyaret ettiği zaman (mikrosaniye cinsinden).

privacy_info alanları

"privacy_info" alanları, kullanıcının izin modu etkinleştirildiği andaki mevcut izin durumuna dayalı bilgiler içerir.
Alan adı Veri türü Açıklama
privacy_info.ads_storage STRING

Reklam hedeflemenin bir kullanıcı için etkin olup olmadığı.

Olası değerler: Evet, Hayır, Ayarlanmadı

privacy_info.analytics_storage STRING

Analytics depolama alanının kullanıcı için etkinleştirilip etkinleştirilmediği.

Olası değerler: Evet, Hayır, Ayarlanmadı

privacy_info.uses_transient_token STRING

Bir web kullanıcısının Analytics depolama alanını reddedip reddetmediği ve geliştiricinin, çerezlerden yararlanılmadan sunucu verilerindeki geçici jetonlar kullanılacak şekilde ölçümü etkinleştirip etkinleştirmediği.

Olası değerler: Evet, Hayır, Ayarlanmadı

Veri türü KAYIT olan user_properties

Veri türü KAYIT olan user_properties, ayarladığınız tüm kullanıcı özelliklerini içerir. Bir kullanıcıyla ilişkilendirilen her anahtar için tekrarlanır.
Alan adı Veri türü Açıklama
user_properties.key STRING Kullanıcı özelliğinin adı.
user_properties.value KAYIT Kullanıcı özelliğinin değeriyle ilgili kayıt.
user_properties.value.string_value STRING Kullanıcı özelliğinin dize değeri.
user_properties.value.int_value TAM SAYI Kullanıcı özelliğinin tamsayı değeri.
user_properties.value.double_value KAYAN NOKTALI Kullanıcı özelliğinin çift değeri.
user_properties.value.float_value KAYAN NOKTALI Bu alan şu anda kullanılmamaktadır.
user_properties.value.set_timestamp_micros TAM SAYI Kullanıcı özelliğinin son ayarlandığı zaman (mikrosaniye cinsinden).

Veri türü KAYIT olan user_ltv

Veri türü KAYIT olan user_ltv, kullanıcı hakkındaki yaşam boyu değer bilgilerini içerir. Gün içi tablolarda bu KAYIT doldurulmaz.
Alan adı Veri türü Açıklama
user_ltv.revenue KAYAN NOKTALI Kullanıcının Yaşam Boyu Değeri (gelir). Gün içi tablolarda bu alan doldurulmaz.
user_ltv.currency STRING Kullanıcının Yaşam Boyu Değeri (para birimi). Gün içi tablolarda bu alan doldurulmaz.
device
Veri türü KAYIT olan "device", etkinliğin gerçekleştiği cihazla ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
device.category STRING Cihaz kategorisi (mobil cihaz, tablet, masaüstü).
device.mobile_brand_name STRING Cihazın markasının adı.
device.mobile_model_name STRING Cihazın modelinin adı.
device.mobile_marketing_name STRING Cihazın pazarlama adı.
device.mobile_os_hardware_model STRING Doğrudan işletim sisteminden alınan cihaz modeli bilgisi.
device.operating_system STRING Cihazın işletim sistemi.
device.operating_system_version STRING İşletim sisteminin sürümü.
device.vendor_id STRING IDFV (yalnızca IDFA toplanmamışsa bulunur).
device.advertising_id STRING Reklam Kimliği/IDFA.
device.language STRING İşletim sisteminin dili.
device.time_zone_offset_seconds TAM SAYI GMT saat dilimine saniye cinsinden uzaklık.
device.is_limited_ad_tracking BOOLE

Cihazın "Reklam İzlemeyi Sınırla" ayarı.

iOS14 ve sonraki sürümlerde IDFA sıfır dışındaki bir değerse false (yanlış) değerini döndürür.

device.web_info.browser STRING Kullanıcının içeriği görüntülediği tarayıcı.
device.web_info.browser_version STRING Kullanıcının içeriği görüntülediği tarayıcının sürümü.
device.web_info.hostname STRING Günlüğe kaydedilen işlemle ilişkilendirilen ana makinenin adı.

geo

Veri türü KAYIT olan "geo", etkinliğin başlatıldığı coğrafi konumla ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
geo.continent STRING Etkinliklerin raporlandığı kıta. IP adresine göre belirlenir.
geo.sub_continent STRING Etkinliklerin raporlandığı alt kıta. IP adresine göre belirlenir.
geo.country STRING Etkinliklerin raporlandığı ülke. IP adresine göre belirlenir.
geo.region STRING Etkinliklerin raporlandığı bölge. IP adresine göre belirlenir.
geo.metro STRING Etkinliklerin raporlandığı metropol. IP adresine göre belirlenir.
geo.city STRING Etkinliklerin raporlandığı şehir. IP adresine göre belirlenir.
app_info
Veri türü KAYIT olan app_info, etkinliğin başlatıldığı uygulamayla ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
app_info.id STRING Uygulamanın paket adı veya paket kimliği.
app_info.firebase_app_id STRING Uygulamayla ilişkilendirilen Firebase Uygulama Kimliği.
app_info.install_source STRING Uygulamayı yükleyen mağaza.
app_info.version STRING Uygulamaya ait versionName (Android) veya kısa paket sürümü.
collected_traffic_source

ollected_traffic_source KAYDI, sayfanın ilk etkinliğiyle birlikte toplanan trafik kaynağı verilerini içerir.

Alan adı Veri türü Açıklama
manual_campaign_id STRING Etkinlikle birlikte toplanan manuel kampanya kimliği (utm_id).
manual_campaign_name STRING Etkinlikle birlikte toplanan manuel kampanya adı (utm_campaign).
manual_source STRING Etkinlikle birlikte toplanan manuel kampanya kaynağı (utm_source). Ayrıca, yalnızca UTM (Urchin trafik izleme) değerlerini değil, yönlendirme parametrelerinden ayrıştırılan parametreleri de içerir.
manual_medium STRING Etkinlikle birlikte toplanan manuel kampanya aracısı (utm_medium). Ayrıca, yalnızca UTM (Urchin trafik izleme) değerlerini değil, yönlendirme parametrelerinden ayrıştırılan parametreleri de içerir.
manual_term STRING Etkinlikle birlikte toplanan manuel kampanya anahtar kelimesi/terimi (utm_term).
manual_content STRING Etkinlikle birlikte toplanan ek manuel kampanya meta verileri (utm_content).
manual_creative_format STRING Etkinlikle birlikte toplanan manuel kampanya reklam öğesi biçimi (utm_creative_format).
manual_marketing_tactic STRING Etkinlikle birlikte toplanan manuel kampanya pazarlama taktiği (utm_marketing_tactic).
manual_source_platform STRING Etkinlikle birlikte toplanan manuel kampanya kaynak platformu (utm_source_platform).
gclid STRING Etkinlikle birlikte toplanan Google tıklama kimliği.
dclid STRING Display & Video 360 ve Campaign Manager 360 için etkinlikle birlikte toplanan DoubleClick tıklama kimliği.
srsltid STRING Etkinlikle birlikte toplanan Google Merchant Center kimliği.
session_traffic_source_last_click

Veri türü KAYIT olan session_traffic_source_last_click, Google Ads ve mevcut olduğunda manuel bağlamlar genelinde son tıklamayla ilişkilendirilen oturum trafik kaynağı verilerini barındırır.

Alan Adı Veri Türü Açıklama
session_traffic_source_last_click. manual_campaign.campaign_id STRING Son tıklanan manuel kampanyanın kimliği
session_traffic_source_last_click. manual_campaign.campaign_name STRING Son tıklanan manuel kampanyanın adı
session_traffic_source_last_click. manual_campaign.medium STRING Son tıklanan manuel kampanyanın aracısı (ör. ücretli arama, organik arama, e-posta)
session_traffic_source_last_click. manual_campaign.term STRING Son tıklanan manuel kampanyanın anahtar kelimesi veya arama terimi
session_traffic_source_last_click. manual_campaign.content STRING En son tıklanan manuel kampanyanın ek meta verileri
session_traffic_source_last_click. manual_campaign.source_platform STRING Son tıklanan manuel kampanyanın platformu (ör. arama motoru, sosyal medya)
session_traffic_source_last_click. manual_campaign.source STRING Son tıklanan manuel kampanyanın platformu içindeki belirli kaynak
session_traffic_source_last_click. manual_campaign.creative_format STRING Son tıklanan manuel kampanyanın reklam öğesi biçimi
session_traffic_source_last_click. manual_campaign.marketing_tactic STRING Son tıklanan manuel kampanyanın pazarlama taktiği
session_traffic_source_last_click. google_ads_campaign.customer_id STRING Google Ads hesabıyla ilişkili müşteri kimliği
session_traffic_source_last_click. google_ads_campaign.account_name STRING Google Ads hesabının adı
session_traffic_source_last_click. google_ads_campaign.campaign_id STRING Google Ads kampanyasının kimliği
session_traffic_source_last_click. google_ads_campaign.campaign_name STRING Google Ads kampanyasının adı
session_traffic_source_last_click. google_ads_campaign.ad_group_id STRING Google Ads kampanyasındaki reklam grubunun kimliği
session_traffic_source_last_click. google_ads_campaign.ad_group_name STRING Google Ads kampanyasındaki reklam grubunun adı
session_traffic_source_last_click.
cross_channel_campaign.campaign_name
STRING Son tıklanan çok kanallı kampanyanın adı
session_traffic_source_last_click.
cross_channel_campaign.campaign_id
STRING Son tıklanan çok kanallı kampanyanın kimliği
session_traffic_source_last_click.
cross_channel_campaign.source_platform
STRING Son tıklanan çok kanallı kampanyanın platformu
session_traffic_source_last_click.
cross_channel_campaign.source
STRING Son tıklanan çok kanallı kampanyanın platformu içindeki belirli kaynak
session_traffic_source_last_click.
cross_channel_campaign.medium
STRING Son tıklanan çok kanallı kampanyanın aracısı
session_traffic_source_last_click.
sa360_campaign.campaign_name
STRING Son tıklanan SA360 kampanyasının adı
session_traffic_source_last_click.
sa360_campaign.source
STRING Son tıklanan SA360 kampanyasının platformu içindeki belirli kaynak
session_traffic_source_last_click.
sa360_campaign.medium
STRING Son tıklanan SA360 kampanyasının aracısı
session_traffic_source_last_click.
sa360_campaign.ad_group_id
STRING SA360 kampanyasındaki reklam grubunun kimliği
session_traffic_source_last_click.
sa360_campaign.ad_group_name
STRING SA360 kampanyasındaki reklam grubunun adı
session_traffic_source_last_click.
sa360_campaign.campaign_id
STRING Son tıklanan SA360 kampanyasının kimliği
session_traffic_source_last_click.
sa360_campaign.creative_format
STRING Son tıklanan SA360 kampanyasının reklam öğesi biçimi
session_traffic_source_last_click.
sa360_campaign.engine_account_name
STRING SA360 arama motoru hesabının adı
session_traffic_source_last_click.
sa360_campaign.engine_account_type
STRING SA360 kampanyasını içeren arama motoru hesabının türü
session_traffic_source_last_click.
sa360_campaign.manager_account_name
STRING SA360 yönetici hesabının adı
session_traffic_source_last_click.
dv360_campaign.advertiser_id
STRING DV360 reklamvereninin kimliği
session_traffic_source_last_click.
dv360_campaign.advertiser_name
STRING DV360 reklamvereninin adı
session_traffic_source_last_click.
dv360_campaign.campaign_id
STRING Son tıklanan DV360 kampanyasının kimliği
session_traffic_source_last_click.
dv360_campaign.campaign_name
STRING Son tıklanan DV360 kampanyasının adı
session_traffic_source_last_click.
dv360_campaign.creative_id
STRING Son tıklanan DV360 kampanyasının reklam öğesinin kimliği
session_traffic_source_last_click.
dv360_campaign.creative_format
STRING Son tıklanan DV360 kampanyasının reklam öğesi biçimi
session_traffic_source_last_click.
dv360_campaign.creative_name
STRING Son tıklanan DV360 kampanyasının reklam öğesinin adı
session_traffic_source_last_click.
dv360_campaign.marketing_tactic
STRING Son tıklanan DV360 kampanyasının pazarlama taktiği
session_traffic_source_last_click.
dv360_campaign.exchange_id
STRING Son tıklanan DV360 kampanyasının exchange kimliği
session_traffic_source_last_click.
dv360_campaign.exchange_name
STRING Son tıklanan DV360 kampanyasının exchange adı
session_traffic_source_last_click.
dv360_campaign.insertion_order_id
STRING Son tıklanan DV360 kampanyasındaki kampanya siparişinin kimliği
session_traffic_source_last_click.
dv360_campaign.insertion_order_name
STRING Son tıklanan DV360 kampanyasındaki kampanya siparişinin adı
session_traffic_source_last_click.
dv360_campaign.line_item_id
STRING Son tıklanan DV360 kampanyasındaki satır öğesinin kimliği
session_traffic_source_last_click.
dv360_campaign.line_item_name
STRING Son tıklanan DV360 kampanyasındaki satır öğesinin adı
session_traffic_source_last_click.
dv360_campaign.partner_id
STRING DV360 iş ortağının kimliği
session_traffic_source_last_click.
dv360_campaign.partner_name
STRING DV360 iş ortağının adı
session_traffic_source_last_click.
dv360_campaign.source
STRING Son tıklanan DV360 kampanyasının platformu içindeki belirli kaynak
session_traffic_source_last_click.
dv360_campaign.medium
STRING Son tıklanan DV360 kampanyasının aracısı
session_traffic_source_last_click.
cm360_campaign.account_id
STRING CM360 hesabının kimliği
session_traffic_source_last_click.
cm360_campaign.account_name
STRING CM360 hesabının adı
session_traffic_source_last_click.
cm360_campaign.advertiser_id
STRING CM360 reklamvereninin kimliği
session_traffic_source_last_click.
cm360_campaign.advertiser_name
STRING CM360 reklamvereninin adı
session_traffic_source_last_click.
cm360_campaign.campaign_id
STRING Son tıklanan CM360 kampanyasının kimliği
session_traffic_source_last_click.
cm360_campaign.campaign_name
STRING Son tıklanan CM360 kampanyasının adı
session_traffic_source_last_click.
cm360_campaign.creative_id
STRING Son tıklanan CM360 kampanyasının reklam öğesinin kimliği
session_traffic_source_last_click.
cm360_campaign.creative_format
STRING Son tıklanan CM360 kampanyasının reklam öğesi biçimi
session_traffic_source_last_click.
cm360_campaign.creative_name
STRING Son tıklanan CM360 kampanyasının reklam öğesinin adı
session_traffic_source_last_click.
cm360_campaign.creative_type
STRING Son tıklanan CM360 kampanyasının reklam öğesi türü
session_traffic_source_last_click.
cm360_campaign.creative_type_id
STRING Son tıklanan CM360 kampanyasının reklam öğesi türü kimliği
session_traffic_source_last_click.
cm360_campaign.creative_version
STRING Son tıklanan CM360 kampanyasının reklam öğesi sürümü
session_traffic_source_last_click.
cm360_campaign.placement_id
STRING Son tıklanan CM360 kampanyasının yerleşiminin kimliği
session_traffic_source_last_click.cm360
_campaign.placement_cost_structure
STRING Son tıklanan CM360 kampanyasının yerleşim maliyeti yapısı
session_traffic_source_last_click.
cm360_campaign.placement_name
STRING Son tıklanan CM360 kampanyasının yerleşiminin adı
session_traffic_source_last_click.
cm360_campaign.rendering_id
STRING Son tıklanan CM360 kampanyasının oluşturma kimliği
session_traffic_source_last_click.
cm360_campaign.site_id
STRING Son tıklanan CM360 kampanyasının site kimliği
session_traffic_source_last_click.
cm360_campaign.site_name
STRING Son tıklanan CM360 kampanyasının site adı
session_traffic_source_last_click.
cm360_campaign.source
STRING Son tıklanan CM360 kampanyasının belirli kaynağı
session_traffic_source_last_click.
cm360_campaign.medium
STRING Son tıklanan CM360 kampanyasının aracısı
traffic_source

Veri türü KAYIT olan traffic_source, kullanıcıyı ilk edinen trafik kaynağıyla ilgili bilgileri içerir. Gün içi tablolarda bu kayıt doldurulmaz.

Not: Kullanıcı, yüklemenin ardından gelen kampanyalarla etkileşime geçerse traffic_source değerleri değişmez.

Alan adı Veri türü Açıklama
traffic_source.name STRING Kullanıcının ilk kazanıldığı pazarlama kampanyasının adı. Gün içi tablolarda bu alan doldurulmaz.
traffic_source.medium STRING Kullanıcının ilk kazanıldığı ortamın (ücretli arama, organik arama, e-posta vb.) adı. Gün içi tablolarda bu alan doldurulmaz.
traffic_source.source STRING Kullanıcıyı ilk kez kazandıran ağın adı. Gün içi tablolarda bu alan doldurulmaz.
stream ve platform
"stream" ve "platform" alanları, akış ve uygulama platformuyla ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
stream_id STRING Etkinliğin gerçekleştiği veri akışının sayısal kimliği.
platform STRING Etkinliğin gerçekleştiği veri akışı platformu (Web, iOS veya Android).
ecommerce
Veri türü KAYIT olan "ecommerce", bir web sitesi veya uygulamada ayarlanmış e-ticaret etkinlikleri ile ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
ecommerce.total_item_quantity TAM SAYI Bu etkinlikteki öğelerin toplam sayısı (items.quantity toplamı).
ecommerce.purchase_revenue_in_usd KAYAN NOKTALI Bu etkinliğin satın alma geliri (standart birimle ABD doları cinsinden belirtilir). Yalnızca satın alma etkinliği için doldurulur.
ecommerce.purchase_revenue KAYAN NOKTALI Bu etkinliğin satın alma geliri (standart birimle yerel para birimi cinsinden belirtilir). Yalnızca satın alma etkinliği için doldurulur.
ecommerce.refund_value_in_usd KAYAN NOKTALI Bu etkinlikle ilgili geri ödeme miktarı (standart birimle ABD doları cinsinden belirtilir). Yalnızca geri ödeme etkinliği için doldurulur.
ecommerce.refund_value KAYAN NOKTALI Bu etkinlikle ilgili geri ödeme miktarı (standart birimle yerel para birimi cinsinden belirtilir). Yalnızca geri ödeme etkinliği için doldurulur.
ecommerce.shipping_value_in_usd KAYAN NOKTALI Bu etkinlikle ilgili gönderim maliyeti (standart birimle ABD doları cinsinden belirtilir).
ecommerce.shipping_value KAYAN NOKTALI Bu etkinlikle ilgili gönderim maliyeti (standart birimle yerel para birimi cinsinden belirtilir).
ecommerce.tax_value_in_usd KAYAN NOKTALI Bu etkinlikle ilgili vergi tutarı (standart birimle ABD doları cinsinden belirtilir).
ecommerce.tax_value KAYAN NOKTALI Bu etkinlikle ilgili vergi tutarı (standart birimle yerel para birimi cinsinden belirtilir).
ecommerce.transaction_id STRING E-ticaret işleminin işlem kimliği.
ecommerce.unique_items TAM SAYI Bu etkinlikteki benzersiz öğelerin sayısı (item_id, item_name ve item_brand'e göre).
items
Veri türü KAYIT olan "items", bir etkinliğe dahil edilen öğelerle ilgili bilgileri içerir. Bu kayıt her öğe için tekrarlanır.
Alan adı Veri türü Açıklama
items.item_id STRING Öğenin kimliği.
items.item_name STRING Öğenin adı.
items.item_brand STRING Öğenin markası.
items.item_variant STRING Öğenin varyantı.
items.item_category STRING Öğenin kategorisi.
items.item_category2 STRING Öğenin alt kategorisi.
items.item_category3 STRING Öğenin alt kategorisi.
items.item_category4 STRING Öğenin alt kategorisi.
items.item_category5 STRING Öğenin alt kategorisi.
items.price_in_usd KAYAN NOKTALI Öğenin fiyatı (standart birimle ABD doları cinsinden belirtilir).
items.price KAYAN NOKTALI Öğenin yerel para birimi cinsinden fiyatıdır.
items.quantity TAM SAYI Öğenin miktarı. Belirtilmezse miktar 1 olarak ayarlanır.
items.item_revenue_in_usd KAYAN NOKTALI Bu öğenin geliri (price_in_usd * quantity olarak hesaplanır). Yalnızca standart birimi ABD doları cinsinden olan satın alma etkinlikleri için doldurulur.
items.item_revenue KAYAN NOKTALI Bu öğenin geliri (price * quantity olarak hesaplanır). Yalnızca standart birimi yerel para birimi cinsinden olan satın alma etkinlikleri için doldurulur.
items.item_refund_in_usd KAYAN NOKTALI Bu öğenin geri ödeme tutarı (price_in_usd * quantity olarak hesaplanır). Yalnızca standart birimi ABD doları cinsinden olan geri ödeme etkinlikleri için doldurulur.
items.item_refund KAYAN NOKTALI Bu öğenin geri ödeme tutarı (price * quantity olarak hesaplanır). Yalnızca standart birimi yerel para birimi cinsinden olan geri ödeme etkinlikleri için doldurulur.
items.coupon STRING Bu öğeye uygulanan kupon kodu.
items.affiliation STRING Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
items.location_id STRING Öğeyle ilişkilendirilen konum.
items.item_list_id STRING Öğenin kullanıcıya sunulduğu girişin kimliği.
items.item_list_name STRING Öğenin kullanıcıya sunulduğu girişin adı.
Items.item_list_index STRING Öğenin bir girişteki konumu.
items.promotion_id STRING Bir ürün tanıtımının kimliği.
items.promotion_name STRING Bir ürün tanıtımının adı.
items.creative_name STRING Tanıtım alanında kullanılan reklam öğesinin adı.
items.creative_slot STRING Reklam öğesi alanının adı.

Veri türü KAYIT olan item_params

Veri türü KAYIT olan item_params, tanımladığınız özel öğe parametrelerini depolar. item_id, item_name vb. önceden tanımlanmış öğe parametreleri buraya eklenmemiş olup açık alanlar olarak dışa aktarılmıştır.

Veri türü KAYIT olan item_params içinde depolanan parametre grubu, uygulanan her öğe parametresi için benzersizdir. E-ticaret uygulamaları ve Google Analytics 4 items dizisi hakkında daha fazla bilgi edinmek için E-ticareti ölçme başlıklı makaleyi inceleyin.

Alan adı Veri türü Açıklama
items.item_params.key STRING Öğe parametresinin adı.
items.item_params.value KAYIT Öğe parametresinin değerini içeren bir kayıt.
items.item_params.value.string_value STRING Öğe parametresi, dizeyle temsil ediliyorsa bu alanda doldurulur.
items.item_params.value.int_value TAM SAYI Öğe parametresi, tam sayı ile temsil ediliyorsa bu alanda doldurulur.
items.item_params.value.double_value KAYAN NOKTALI Öğe parametresi, çift değerle temsil ediliyorsa bu alanda doldurulur.
items.item_params.value.float_value KAYAN NOKTALI Öğe parametresi, kayan nokta değeriyle temsil ediliyorsa bu alanda doldurulur.
publisher (Yalnızca erken erişim)
publisher KAYDI, reklamların görüntülenmesiyle ilgili bir yayıncı entegrasyonundan (ör. AdMob) alınan etkinliklerle ilgili bilgileri içerir.
Alan adı Veri türü Açıklama
publisher KAYIT AdMob'dan gelen yayıncı verilerinin kaydı.
publisher.ad_revenue_in_usd KAYAN NOKTALI Bu etkinlikten elde edilen tahmini reklam geliri (ABD doları cinsinden belirtilir). Yalnızca reklam gösterimi etkinlikleri için doldurulur.
publisher.ad_format STRING Reklamların görünme şeklini ve konumunu tanımlar. Genel biçimler arasında "Geçiş reklamı", "Banner", "Ödüllü" ve "Doğal gelişmiş" reklam biçimleri bulunur.
publisher.ad_source_name STRING Reklamı yayınlayan kaynak ağ. Tipik kaynaklar arasında "AdMob Ağı", "Meta Audience Network" ve "Uyumlulaştırılmış kurum reklamları" bulunur.
publisher.ad_unit_id STRING Bu reklam birimini tanımlamak için seçtiğiniz ad. Reklam birimleri, kullanıcılara reklam göstermek için uygulamalarınıza yerleştirdiğiniz kapsayıcılardır.

Satırlar

Tek bir etkinliğin verileri, tekrarlanan KAYITLAR içerip içermediğine bağlı olarak bir veya daha fazla satırda gösterilebilir. Örneğin, birden fazla page_view içeren page_view etkinliği aşağıdaki tabloya benzer şekilde görünür. İlk satır; etkinlik adını, tarihini, zaman damgasını ve tekrarlanmayan diğer veri öğelerini içerir. Veri türü KAYIT olan event_params, etkinlikle ilişkilendirilen her parametre için tekrarlanır. Tekrarlanan bu KAYITLAR, ilk etkinlik satırının hemen altında gelen satırlarda doldurulur.

event_date event_timestamp event_name event_params.key event_params_value.string_value
20220222 1643673600483790 page_view page_location https://example.com
      page_title Ana Sayfa
      orta yönlendirme
      kaynak google
      page_referrer https://www.google.com
      <parameters...> <values...>

Bu etkinlik verileri, GA4 kullanıcı arayüzünde aşağıdaki gibi gösterilir.

SDK'ları Android 17.2.5 (ya da üzeri) ve/veya iOS 16.20.0 (ya da üzeri) sürümüne güncellerken dikkat edilmesi gereken noktalar

SDK'ların önceki sürümlerini kullandıysanız ve Android 17.2.5 (ya da üzeri) ve/veya iOS 16.20.0 (ya da üzeri) sürümüne geçmeyi planlıyorsanız aşağıdakileri göz önünde bulundurmalısınız:

  • Güncel BigQuery Export şemasını kullanmak için SDK'nızı Android 17.2.5 (ya da üzeri) ve/veya iOS 16.20.0 (ya da üzeri) sürümüne yükseltmeniz gerekir. Önceki SDK sürümleri kullanıldığında, dışa aktarılan veriler eski şemayı yansıtır.
  • Yeni sürüme geçildikten sonra yalnızca tekrarlanan öğe dizisindeki ürün verilerine erişebilirsiniz. Ürün verileri bu SDK sürümlerinden öncesine ait olduğu için artık standart etkinlik parametrelerinde kullanılamaz.
  • Bu değişiklik, birden çok ürün analizini desteklemek için yapılmıştır.
  • Sonuç olarak, öğe/ürün verilerinizle ilgili referanslarınızı düzenlemeniz gerekebilir.
Mevcut BigQuery veri kümelerini eski dışa aktarım şemasından yenisine taşımak için bu komut dosyasını kullanın
  1. Cloud Platform Console >: Yönetici kaynakları sayfasına giriş yapın.
  2. Verilerini taşımak istediğiniz projeyi açın ve sayfanın üst kısmındaki Google Cloud Shell'i etkinleştir'i tıklayın.
  3. Kabuk açıldığında aşağıdaki komutları migration_script.sql adlı bir dosyaya kopyalayın:
    1. cat > migration_script.sql komutunu verin.
    2. Aşağıdaki komut dosyasını kopyalayıp kabuğa yapıştırın.
    3. Kaydedip çıkmak için Ctrl+D tuşlarına basın.
    Komut dosyası (migration_script.sql):
      SELECT
      @date AS event_date,
      event.timestamp_micros AS event_timestamp,
      event.previous_timestamp_micros AS event_previous_timestamp,
      event.name AS event_name,
      event.value_in_usd  AS event_value_in_usd,
       user_dim.bundle_info.bundle_sequence_id AS event_bundle_sequence_id,
      user_dim.bundle_info.server_timestamp_offset_micros as event_server_timestamp_offset,
      (
      SELECT
        ARRAY_AGG(STRUCT(event_param.key AS key,
            STRUCT(event_param.value.string_value AS string_value,
              event_param.value.int_value AS int_value,
              event_param.value.double_value AS double_value, 
              event_param.value.float_value AS float_value) AS value))
      FROM
        UNNEST(event.params) AS event_param) AS event_params,
      user_dim.first_open_timestamp_micros AS user_first_touch_timestamp,
      user_dim.user_id AS user_id,
      user_dim.app_info.app_instance_id AS user_pseudo_id,
      "" AS stream_id,
      user_dim.app_info.app_platform AS platform,
      STRUCT( user_dim.ltv_info.revenue AS revenue,
        user_dim.ltv_info.currency AS currency ) AS user_ltv,
      STRUCT( user_dim.traffic_source.user_acquired_campaign AS name,
          user_dim.traffic_source.user_acquired_medium AS medium,
          user_dim.traffic_source.user_acquired_source AS source ) AS traffic_source,
      STRUCT( user_dim.geo_info.continent AS continent,
        user_dim.geo_info.country AS country,
        user_dim.geo_info.region AS region,
        user_dim.geo_info.city AS city ) AS geo,
      STRUCT( user_dim.device_info.device_category AS category,
        user_dim.device_info.mobile_brand_name,
        user_dim.device_info.mobile_model_name,
        user_dim.device_info.mobile_marketing_name,
        user_dim.device_info.device_model AS mobile_os_hardware_model,
        @platform AS operating_system,
        user_dim.device_info.platform_version AS operating_system_version,
        user_dim.device_info.device_id AS vendor_id,
        user_dim.device_info.resettable_device_id AS advertising_id,
        user_dim.device_info.user_default_language AS language,
        user_dim.device_info.device_time_zone_offset_seconds AS time_zone_offset_seconds,
        IF(user_dim.device_info.limited_ad_tracking, "Yes", "No") AS is_limited_ad_tracking ) AS device,
      STRUCT( user_dim.app_info.app_id AS id,
        @firebase_app_id  AS firebase_app_id,
        user_dim.app_info.app_version AS version,
        user_dim.app_info.app_store AS install_source ) AS app_info,
      (
      SELECT
        ARRAY_AGG(STRUCT(user_property.key AS key,
            STRUCT(user_property.value.value.string_value AS string_value,
              user_property.value.value.int_value AS int_value,
              user_property.value.value.double_value AS double_value,
              user_property.value.value.float_value AS float_value,
              user_property.value.set_timestamp_usec AS set_timestamp_micros ) AS value))
      FROM
        UNNEST(user_dim.user_properties) AS user_property) AS user_properties
    FROM
      `SCRIPT_GENERATED_TABLE_NAME`,
      UNNEST(event_dim) AS event
      
  4. Yeni bir kabuk açın ve aşağıdaki bash komutlarını migration.sh adlı bir dosyaya kopyalayın:
    1. cat > migration.sh komutunu verin.
    2. Aşağıdaki komut dosyasını kopyalayıp kabuğa yapıştırın.
    3. Kaydedip çıkmak için Ctrl+D tuşlarına basın.
    Analytics mülk kimliğinizi, BigQuery proje kimliğinizi, Firebase uygulama kimliğinizi, BigQuery veri kümesinin adını ve istediğiniz verilerin başlangıç ve bitiş tarihlerini eklemek için aşağıdaki komut dosyasını değiştirin.
    Komut dosyası (migration.sh):
    # Projenin Analytics Mülk Kimliği. Bunu Firebase'deki Analytics Ayarlarında bulabilirsiniz.
    PROPERTY_ID=Analytics mülk kimliğiniz
    
    # BigQuery Export Projesi.
    BQ_PROJECT_ID="BigQuery Projenizin Kimliği" (ör. "firebase-public-project")
    
    # Uygulamanızın Firebase Uygulama Kimliği.
    FIREBASE_APP_ID="Firebase Uygulama Kimliğiniz" (ör. "1:300830567303:ios:09b1ab1d3ca29bda")
    
    # İçe aktarma işleminin yapılacağı veri kümesi.
    BQ_DATASET="içe aktarma işlemini yapacağınız BigQuery veri kümesinin adı" (ör. "com_firebase_demo_IOS")
    
    # Platform
    PLATFORM="uygulamanın platformu. ANDROID veya IOS"
    
    # Taşımayı çalıştıracağınız veri aralığı, [START_DATE,END_DATE] tarihleri dahildir.
    START_DATE=20180324
    END_DATE=20180327
    
    # Yeterince bilgi sahibi değilseniz aşağıdaki komut dosyasını değiştirmeyin:)
    startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
    enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
    
    # Tarihleri sırayla tarayın.
    DATE="$startdate"
    while [ "$DATE" -le "$enddate" ]; do
    
            # Yukarıdaki parametrelerden oluşturulan BQ tablosu.
            BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE"
    
            echo "Migrating $BQ_TABLE"
    
            cat migration_script.sql | sed -e "s/SCRIPT_GENERATED_TABLE_NAME/$BQ_TABLE/g" | bq query \
            --debug_mode \
            --allow_large_results \
            --noflatten_results \
            --use_legacy_sql=False \
            --destination_table analytics_$PROPERTY_ID.events_$DATE \
            --batch \
            --append_table \
            --parameter=firebase_app_id::$FIREBASE_APP_ID \
            --parameter=date::$DATE \
            --parameter=platform::$PLATFORM \
            --project_id=$BQ_PROJECT_ID
    
    
            temp=$(date -I -d "$DATE + 1 day")
            DATE=$(date -d "$temp" +%Y%m%d)
    
    done
    exit
    
    # KOMUT DOSYASI SONU
    
    
  5. Yeni bir kabuk açın ve bash migration.sh komutunu verin
Eski dışa aktarım şeması

user_dim

Alan Adı Veri Türü Açıklama
user_dim KAYIT Kullanıcı detaylarının kaydı.
user_dim.user_id STRING setUserId API'siyle ayarlanmış kullanıcı kimliği.
user_dim.first_open_timestamp_micros TAM SAYI Kullanıcının uygulamayı ilk açtığı zaman (mikrosaniye cinsinden).
user_dim.user_properties KAYIT Kullanıcı özelliklerinin setUserProperty API'siyle ayarlanmış tekrarlanan kaydı.
user_dim.user_properties.key STRING Kullanıcı özelliğinin adı.
user_dim.user_properties.value KAYIT Kullanıcı özelliği hakkında bilgi kaydı.
user_dim.user_properties.value.value KAYIT Kullanıcı özelliğinin değeriyle ilgili kayıt.
user_dim.user_properties.value.value.string_value STRING Kullanıcı özelliğinin dize değeri.
user_dim.user_properties.value.value.int_value TAM SAYI Kullanıcı özelliğinin tamsayı değeri.
user_dim.user_properties.value.value.double_value KAYAN NOKTALI Kullanıcı özelliğinin çift değeri.
user_dim.user_properties.value.set_timestamp_usec TAM SAYI Kullanıcı özelliğinin son ayarlandığı zaman (mikrosaniye cinsinden).
user_dim.user_properties.value.index TAM SAYI Kullanıcı özelliğinin dizini (0-24).
user_dim.device_info KAYIT Cihaz bilgilerinin kaydı.
user_dim.device_info.device_category STRING Cihaz kategorisi (mobil cihaz, tablet, masaüstü).
user_dim.device_info.mobile_brand_name STRING Cihazın markasının adı.
user_dim.device_info.mobile_model_name STRING Cihazın modelinin adı.
user_dim.device_info.mobile_marketing_name STRING Cihazın pazarlama adı.
user_dim.device_info.device_model STRING Cihazın modeli.
user_dim.device_info.platform_version STRING İşletim sisteminin sürümü.
user_dim.device_info.device_id STRING IDFV (yalnızca IDFV kullanılamıyorsa bulunur).
user_dim.device_info.resettable_device_id STRING Reklam Kimliği/IDFA.
user_dim.device_info.user_default_language STRING İşletim sisteminin dili.
user_dim.device_info.device_time_zone_offset_seconds TAM SAYI GMT saat dilimine saniye cinsinden uzaklık.
user_dim.device_info.limited_ad_tracking BOOLE Cihazın "Reklam İzlemeyi Sınırla" ayarı.
user_dim.geo_info KAYIT Kullanıcının coğrafi bilgilerinin kaydı.
user_dim.geo_info.continent STRING Etkinliklerin raporlandığı kıta. IP adresine göre belirlenir.
user_dim.geo_info.country STRING Etkinliklerin raporlandığı ülke. IP adresine göre belirlenir.
user_dim.geo_info.region STRING Etkinliklerin raporlandığı bölge. IP adresine göre belirlenir.
user_dim.geo_info.city STRING Etkinliklerin raporlandığı şehir. IP adresine göre belirlenir.
user_dim.app_info KAYIT Uygulamaya ait bilgilerin kaydı.
user_dim.app_info.app_version STRING Uygulamaya ait versionName (Android) veya kısa paket sürümü.
user_dim.app_info.app_instance_id STRING Uygulamanın bu örneği için benzersiz kimlik.
user_dim.app_info.app_store STRING Bu uygulamayı yükleyen mağaza.
user_dim.app_info.app_platform STRING Bu uygulamanın çalıştırıldığı platform.
user_dim.traffic_source KAYIT Kullanıcıyı kazanmak için kullanılan trafik kaynağının adı. Gün içi tablolarda bu alan doldurulmaz.
user_dim.traffic_source.user_acquired_campaign STRING Kullanıcıyı kazandıran pazarlama kampanyasının adı. Gün içi tablolarda bu alan doldurulmaz.
user_dim.traffic_source.user_acquired_medium STRING Kullanıcının kazanıldığı ortamın (ücretli arama, organik arama, e-posta vb.) adı. Gün içi tablolarda bu alan doldurulmaz.
user_dim.traffic_source.user_acquired_source STRING Kullanıcıyı kazandıran ağın adı. Gün içi tablolarda bu alan doldurulmaz.
user_dim.bundle_info KAYIT Bu etkinliklerin yüklendiği paketle ilgili bilgilerin bir kaydı.
user_dim.bundle_info.bundle_sequence_id TAM SAYI Bu etkinliklerin yüklendiği paketin sıralı kimliği.
user_dim.ltv_info KAYIT Bu kullanıcı hakkındaki bilgilerin yaşam boyu değer kaydı. Gün içi tablolarda bu alan doldurulmaz.
user_dim.ltv_info.revenue KAYAN NOKTALI Bu kullanıcının Yaşam Boyu Değeri (gelir). Gün içi tablolarda bu alan doldurulmaz.
user_dim.ltv_info.currency STRING Bu kullanıcının Yaşam Boyu Değeri (para birimi). Gün içi tablolarda bu alan doldurulmaz.

event_dim

Alan Adı Veri Türü Açıklama
event_dim KAYIT Bu pakette yer alan etkinliklerle ilgili bilgilerin tekrarlanan kaydı.
event_dim.date STRING Bu etkinliğin kaydedildiği tarih (uygulamanızın kaydedildiği saat diliminde, YYYYAAGG biçiminde gösterilir).
event_dim.name STRING Bu etkinliğin adı.
event_dim.params KAYIT Bu etkinlikle ilişkilendirilen parametrelerin tekrarlanan kaydı.
event_dim.params.key STRING Etkinlik parametresinin anahtarı.
event_dim.params.value KAYIT Etkinlik parametresi değerinin kaydı.
event_dim.params.value.string_value STRING Etkinlik parametresinin dize değeri.
event_dim.params.value.int_value TAM SAYI Etkinlik parametresinin tam sayı değeri.
event_dim.params.value.double_value KAYAN NOKTALI Etkinlik parametresinin çift değeri.
event_dim.timestamp_micros TAM SAYI Bu etkinliğin istemcide günlüğe kaydedildiği zaman (mikrosaniye cinsinden, UTC saat diliminde).
event_dim.previous_timestamp_micros TAM SAYI Bu etkinliğin istemcide günlüğe daha önce kaydedildiği zaman (mikro saniye cinsinden, UTC saat diliminde).

Bu size yardımcı oldu mu?

Bunu nasıl iyileştirebiliriz?
Arama
Aramayı temizle
Aramayı kapat
Ana menü
8477746686020439430
true
Yardım Merkezinde Arayın
true
true
true
true
true
69256
false
false