Google Analytics

Verfügbare Tools 19

Tools, die sich schwer rückgängig machen lassen, etwa Senden oder destruktive Aktionen, benötigen vor der Ausführung Ihre Freigabe.

• google_analytics__delete_resourceDestruktivFreigabe erforderlich

  GA 관리 리소스 하나를 지운다(resource 로 종류 지정). ⚠️ 되돌릴 수 없다 — 계정·속성은 휴지통으로 가 GA 화면에서만 약 35일 안에 복원할 수 있고, 맞춤 측정기준·측정항목·오디언스는 삭제 대신 보관(archive)되며 보관도 되돌릴 수 없다. 데이터 스트림을 지우면 수집이 멈춘다. 사용자가 분명히 요청했을 때만 쓴다. resource_id 는 google_analytics__list_resources 결과의 items[].id. 결과: 무엇을 지웠거나 보관했는지 한 줄.

• google_analytics__manage_accessDestruktivFreigabe erforderlich

  GA 사용자 권한을 부여(create)·역할 변경(update)·회수(delete)한다 — 계정 또는 속성 단위, bindings 배열이면 여러 명을 한 번에. 역할: viewer · analyst · editor · admin (+ no-cost-data · no-revenue-data). ⚠️ 바로 적용된다 — 회수한 권한은 다시 부여하면 새 id 로 되돌릴 수 있지만 update 는 이전 역할을 돌려주지 않으니, 먼저 google_analytics__list_resources 의 resource:"access_bindings" 로 지금 권한을 본다. 연결에 사용자 관리 권한이 필요하다. 결과: action · id · user · roles (회수면 한 줄).

• google_analytics__submit_user_deletionDestruktivFreigabe erforderlich

  방문자 한 명의 데이터를 GA 에서 지우도록 요청한다(개인정보 삭제 요청 대응, 알파 API). ⚠️ 되돌릴 수 없고, GA 가 접수한 뒤 처리까지 시간이 걸린다. 식별자는 user_id · client_id · app_instance_id · user_provided_data 중 정확히 하나 — 사용자가 준 값을 그대로 쓴다. property 는 google_analytics__list_properties 결과의 property. 결과: property · 식별자 · deletion_request_time · note.

• google_analytics__update_data_retentionDestruktivFreigabe erforderlich

  GA4 속성의 데이터 보관 기간 변경. ⚠️ 기간을 줄이면 그보다 오래된 사용자·이벤트 데이터가 탐색 분석에서 지워져 되돌릴 수 없다(값 자체는 다시 바꿀 수 있다). 지금 값은 google_analytics__get_resource 의 resource:"data_retention_settings" 로 먼저 본다. property 는 google_analytics__list_properties 결과의 property. 결과: property · before · after.

• google_analytics__create_resourceSchreiben

  GA 관리 리소스 만들기 — 속성·데이터 스트림·맞춤 측정기준/측정항목·주요 이벤트·오디언스·링크 등. fields 는 GA Admin API 필드(camelCase). 예: custom_dimensions {parameterName, displayName, scope:"EVENT"} · key_events {eventName, countingMethod:"ONCE_PER_EVENT"} · data_streams {type:"WEB_DATA_STREAM", displayName, webStreamData:{defaultUri}}. 다른 리소스는 fields 없이 부르면 주요 필드를 알려 준다. ⚠️ 연결에 편집 권한이 필요하다

• google_analytics__resource_actionSchreiben

  GA 관리 리소스의 특수 동작(알파) — Display & Video 360 링크 제안 승인(approve_link_proposal)·취소(cancel_link_proposal), 이벤트 수정 규칙 순서 바꾸기(reorder_event_edit_rules)

• google_analytics__update_resourceSchreiben

  GA 관리 리소스·설정 고치기 — 바꿀 필드만 fields 에 담는다(updateMask 는 자동). 계정·속성 이름/시간대/통화, 스트림, 맞춤 정의, 주요 이벤트, 링크, 기여·Google 신호·향상된 측정·데이터 가리기 설정 등. 보관 기간은 google_analytics__update_data_retention, 사용자 권한은 google_analytics__manage_access

• google_analytics__audience_exportsLesen

  오디언스 내보내기 — 오디언스에 지금 속한 사용자(기기 ID·사용자 ID) 목록 스냅샷. action: list(목록) · get(상태) · create(만들기, 비동기) · query(행 읽기). kind: export(1회, 72시간 보관) · recurring(매일 새 목록, 알파) · list(일별 목록 — recurring 이 만든 것, 알파). 오디언스 번호는 google_analytics__list_resources 의 resource:"audiences"

• google_analytics__get_propertyLesen

  속성 상세 — 시간대·통화·데이터 스트림. 리포트 날짜가 어느 시간대 기준인지 확인할 때 쓰고, include_quota 면 API 할당량 잔량도 준다. 결과: property · name · account_id · time_zone · currency · data_streams[](id · name · type · measurement_id · uri).

• google_analytics__get_resourceLesen

  GA 관리 리소스 하나 또는 설정 하나 — 리소스는 resource_id(또는 전체 이름), 설정(data_retention_settings · attribution_settings · google_signals_settings · enhanced_measurement_settings · data_redaction_settings · global_site_tag 등)은 상위 id 만. 결과: resource · id · GA 원본 필드(camelCase).

• google_analytics__list_dimensions_metricsLesen

  이 속성에서 쓸 수 있는 차원·지표 이름을 찾는다(맞춤 정의 포함). 종류가 300가지를 넘으므로 search 로 좁혀서 부를 것 (예: search:"conversion"). metrics·dimensions 를 주면 그 조합이 함께 쓰일 수 있는지(호환성)를 검사한다

• google_analytics__list_propertiesLesen

  접근 가능한 GA4 속성 목록 — 다른 Google Analytics 도구의 property·account 인자를 여기서 얻는다. account 를 주면 그 계정의 속성만, show_deleted 면 휴지통 항목까지. 결과: 줄마다 property · property_name · account · account_id (account·show_deleted 를 주면 속성 상세와 deleted · purge_after).

• google_analytics__list_resourcesLesen

  GA 관리 리소스 목록 — 계정·속성·데이터 스트림·맞춤 측정기준/측정항목·주요 이벤트·오디언스·각종 링크·사용자 권한(access_bindings) 등. 상위는 resource 에 따라 account · property · data_stream. 결과: resource · count · items[](id — get/update/delete 에 쓴다 · name · 원본 필드) · next_page_token.

• google_analytics__realtimeLesen

  실시간 지표 — 기본 지난 30분 활성 사용자 수. 배포 직후 영향을 볼 때 쓴다. minute_ranges 로 분 범위를 나눠 비교

• google_analytics__report_tasksLesen

  리포트 작업(알파) — 행이 많은 큰 리포트를 비동기로 만들고 나중에 읽는다. action: create(정의는 run_report 와 같은 인자) · list · get(상태) · query(행 읽기, offset 으로 페이지)

• google_analytics__run_access_reportLesen

  데이터 접근 리포트 — 누가 언제 어떤 방식으로 이 계정·속성의 데이터를 읽었는지 (감사). 차원 예: userEmail · accessedPropertyName · reportType · date · accessMechanism, 지표 예: accessCount

• google_analytics__run_funnel_reportLesen

  퍼널 리포트 — 단계별 활성 사용자·완료율·이탈 (GA 퍼널 탐색과 같은 계산, Data API 알파). 각 단계는 event_name(그 이벤트를 한 사용자)과 filters(그 단계의 차원 조건)로 정한다

• google_analytics__run_reportLesen

  트래픽·사용자·이벤트 지표를 기간·차원별로 조회한다. pivots 를 주면 피벗 리포트, reports 배열이면 최대 5개를 한 번에. 지표/차원 이름이 확실하지 않으면 google_analytics__list_dimensions_metrics 로 먼저 확인할 것

• google_analytics__search_change_historyLesen

  변경 기록 — 계정 아래 설정을 누가 언제 무엇을 바꿨는지. 기본은 변경 요약, detail 이면 변경 전·후 전체. ⚠️ GA 가 이 조회에도 편집 권한(analytics.edit)을 요구한다