Google Analytics 4 araçları
Genel bakış, kanal ve açılış sayfası raporları, gerçek zamanlı veri, dönüşüm olayları ve Google Ads bağlantıları.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları11 araç
list_ga4_properties
Okuma1 krediBağlı Google hesabının okuyabildiği GA4 mülkleri (id, ad, hesap) ve property_id verilmediğinde kullanılan varsayılan mülk.
Bu araç parametre almaz.
ga4_report
Okuma1 krediÖzel GA4 raporu (runReport): bir tarih aralığı için istenen boyut × metrik birleşimi; filtre, sıralama ve limit ile. İkisi de varsa satırlar conversion_rate (keyEvents/sessions %) taşır. 'conversions' GA4 önemli olaylarıdır (keyEvents metriği). Bağlı bir Google hesabı gerektirir; yoksa connected=false.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–730) | tarihler verilmediğinde bugün biten pencere (varsayılan 30) |
metricsİsteğe bağlı | array<string> | GA4 Data API metrik adları, varsayılan [sessions, totalUsers, keyEvents] |
dimensionsİsteğe bağlı | array<string> | GA4 boyut adları, ör. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri, ör. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
order_byİsteğe bağlı | string | istekteki bir metrik ya da boyut |
orderİsteğe bağlı | asc | desc | — |
limitİsteğe bağlı | integer (1–10000) | — |
offsetİsteğe bağlı | integer (0–…) | — |
ga4_overview
Okuma1 krediDönemin genel toplamları: oturum, kullanıcı, yeni kullanıcı, etkileşimli oturum, önemli olay (dönüşüm), gelir, sayfa görüntüleme; etkileşim ve dönüşüm oranlarıyla. compare_previous önceki eşit dönemi ve değişimi ekler.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–730) | tarihler verilmediğinde bugün biten pencere (varsayılan 30) |
compare_previousİsteğe bağlı | boolean | — |
all_propertiesİsteğe bağlı | boolean | true: every selected property of this project in one call (per-property rows + grand total); use for 'all my sites today' (days=1) |
ga4_realtime
Okuma1 krediŞu anda (son 30 dakika) etkin kullanıcılar ve nerede oldukları — varsayılan olarak sayfa/ekran başlığına göre.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
dimensionsİsteğe bağlı | array<string> | gerçek zamanlı boyutlar: unifiedScreenName (varsayılan), country, city, deviceCategory, eventName, platform |
metricsİsteğe bağlı | array<string> | gerçek zamanlı metrikler: activeUsers (varsayılan), screenPageViews, eventCount, keyEvents |
limitİsteğe bağlı | integer (1–1000) | — |
ga4_landing_pages
Okuma1 krediAçılış sayfaları; oturum, etkileşimli oturum, önemli olay (dönüşüm), gelir ve dönüşüm oranıyla, varsayılan olarak önemli olaya göre sıralı.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–730) | tarihler verilmediğinde bugün biten pencere (varsayılan 30) |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri, ör. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
with_query_stringİsteğe bağlı | boolean | — |
order_byİsteğe bağlı | keyEvents | sessions | engagedSessions | totalRevenue | — |
limitİsteğe bağlı | integer (1–1000) | — |
ga4_channel_report
Okuma1 krediVarsayılan kanal grubuna (ya da kaynak/ortam/kampanyaya) göre oturum, etkileşimli oturum, kullanıcı, önemli olay (dönüşüm), gelir ve oranlar.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–730) | tarihler verilmediğinde bugün biten pencere (varsayılan 30) |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri, ör. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
dimensionİsteğe bağlı | string | sessionDefaultChannelGroup (varsayılan), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium |
limitİsteğe bağlı | integer (1–1000) | — |
ga4_vs_google_ads
Okuma2 krediAynı son N günlük pencere için GA4 'Paid Search' kanalı (oturum, önemli olay, gelir) ile Google Ads harcama, tıklama, dönüşüm ve CPA yan yana; atıf farkıyla birlikte. Google Ads bağlı değilse Ads tarafı null olur ve not düşülür.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
daysİsteğe bağlı | integer (1–90) | — |
list_ga4_google_ads_links
Okuma1 krediGA4 mülküne bağlı Google Ads hesapları (müşteri id'si, kişiselleştirme işareti, oluşturan, oluşturulma zamanı); linked=false bağlantısı olmayan mülkü işaretler.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
list_ga4_conversion_events
Okuma1 krediMülkte tanımlı dönüşüm (önemli) olayları; sayma yöntemi ve özel/silinebilir işaretleriyle.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
list_ga4_custom_dimensions
Okuma1 krediMülkteki özel boyutlar (parametre adı, görünen ad, kapsam).
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
ga4_list_data_streams
Okuma1 krediBir GA4 mülkünün veri akışları (web, Android, iOS): akış id'si, adı, varsayılan URI ve web akışları için Tag Manager'da GA4 etiketi kurmak üzere gereken ölçüm kimliği (G-XXXXXXX). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Boş bırakılırsa bağlı varsayılan kullanılır; seçenekleri list_ga4_properties gösterir. |
Yazma araçları4 araç
connect_ga4
Yazma0 krediGoogle Analytics 4 bağlantısını başlatır: kullanıcının açacağı tek kullanımlık bir yetkilendirme bağlantısı döndürür (connect_account ile aynı akış). Kullanıcı oturum açana kadar hiçbir şey bağlanmaz.
Bu araç parametre almaz.
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_ga4_conversion_event
Yazma2 krediBir GA4 olayını dönüşüm (önemli olay) olarak işaretler. Önizlemeli bir onay öğesi oluşturur; Admin API ile yalnızca onaydan sonra ve yalnızca düzenleme yetkisi olan bağlı hesapla uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
event_nameZorunlu | string | — |
counting_methodİsteğe bağlı | ONCE_PER_EVENT | ONCE_PER_SESSION | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_ga4_custom_dimension
Yazma2 krediÖzel boyut oluşturur (olay, kullanıcı ya da öğe kapsamı). Admin API çağrısından önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
parameter_nameZorunlu | string | — |
display_nameİsteğe bağlı | string | — |
scopeİsteğe bağlı | EVENT | USER | ITEM | — |
descriptionİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_ga4_google_ads_link
Yazma2 krediDönüşümler Google Ads'e aksın diye bir Google Ads hesabını GA4 mülküne bağlar. Önizleme ve onaydan geçer; iki tarafta da düzenleme yetkisi gerektirir.
| Parametre | Tip | Açıklama |
|---|---|---|
property_idİsteğe bağlı | string | GA4 mülk id'si (rakamlar ya da properties/123). Bağlı varsayılanı kullanmak için boş bırakılır; seçenekleri list_ga4_properties gösterir. |
customer_idZorunlu | string | Google Ads müşteri id'si, 123-456-7890 |
ads_personalizationİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.