Araç referansı — Veri & Site

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üğü özgün İngilizce metinlerdir.

Okuma araçları10 araç

list_ga4_properties

Okuma1 kredi

GA4 properties (id, name, account) the connected Google account can read, plus the default property used when property_id is omitted.

Bu araç parametre almaz.

ga4_report

Okuma1 kredi

Custom GA4 report (runReport): any dimensions × metrics for a date range with filters, ordering and limit. Rows carry conversion_rate (keyEvents/sessions %) when both are present. 'conversions' are GA4 key events (metric keyEvents). Requires a connected Google account; otherwise connected=false.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`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)	window ending today when dates are omitted (default 30)
`metrics`İsteğe bağlı	array<string>	GA4 Data API metric names, default [sessions, totalUsers, keyEvents]
`dimensions`İsteğe bağlı	array<string>	GA4 dimension names, e.g. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
`filters`İsteğe bağlı	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`order_by`İsteğe bağlı	string	a metric or dimension in the request
`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 kredi

Overview totals for the period: sessions, users, new users, engaged sessions, key events (conversions), revenue, page views, with engagement and conversion rates; compare_previous adds the preceding equal period and change.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`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)	window ending today when dates are omitted (default 30)
`compare_previous`İsteğe bağlı	boolean	—

ga4_realtime

Okuma1 kredi

Active users right now (last 30 minutes) and where they are — by page/screen title by default.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`dimensions`İsteğe bağlı	array<string>	realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform
`metrics`İsteğe bağlı	array<string>	realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents
`limit`İsteğe bağlı	integer (1–1000)	—

ga4_landing_pages

Okuma1 kredi

Landing pages with sessions, engaged sessions, key events (conversions), revenue and conversion rate, ordered by key events by default.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`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)	window ending today when dates are omitted (default 30)
`filters`İsteğe bağlı	array<object>	AND-combined dimension filters, e.g. {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 kredi

Sessions, engaged sessions, users, key events (conversions), revenue and rates by default channel group (or source/medium/campaign).

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`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)	window ending today when dates are omitted (default 30)
`filters`İsteğe bağlı	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`dimension`İsteğe bağlı	string	sessionDefaultChannelGroup (default), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
`limit`İsteğe bağlı	integer (1–1000)	—

ga4_vs_google_ads

Okuma2 kredi

GA4 'Paid Search' channel (sessions, key events, revenue) next to Google Ads spend, clicks, conversions and CPA for the same last-N-days window, with the attribution gap. If Google Ads is not connected the Ads side is null with a note.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`days`İsteğe bağlı	integer (1–90)	—

list_ga4_google_ads_links

Okuma1 kredi

Google Ads accounts linked to the GA4 property (customer id, personalization flag, creator, created time); linked=false flags a property with no link.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_conversion_events

Okuma1 kredi

Conversion (key) events defined on the property with counting method and custom/deletable flags.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_custom_dimensions

Okuma1 kredi

Custom dimensions on the property (parameter name, display name, scope).

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

Yazma araçları3 araç

create_ga4_conversion_event

Yazma2 kredi

Mark a GA4 event as a conversion (key event). Creates an approval item with a preview; applied via the Admin API only after approval and only with a connected account that has edit access.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`event_name`Zorunlu	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

Create a custom dimension (event, user or item scope). Goes through preview and approval before the Admin API call.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`parameter_name`Zorunlu	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 kredi

Link a Google Ads account to the GA4 property so conversions flow to Google Ads. Goes through preview and approval; requires edit access on both sides.

Parametre	Tip	Açıklama
`property_id`İsteğe bağlı	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`customer_id`Zorunlu	string	Google Ads customer id, 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.