[GA4] BigQuery Export 사용자 데이터 스키마

설정

BigQuery Export를 설정하면 사용자 데이터의 일일 내보내기를 포함할 수 있습니다.

데이터 테이블

사용자 데이터를 내보내면 애널리틱스가 BigQuery 프로젝트에 두 개의 새 테이블을 만듭니다.

  • 가명 ID
    • 모든 가명 식별자에 대한 행이 포함됩니다. 필드 중 하나가 변경되면 사용자의 데이터가 업데이트됩니다.
    • 동의하지 않은 사용자의 데이터는 이 테이블로 내보내지 않습니다.
    • 사용자 ID는 이 테이블로 내보내지 않습니다.
    • 마지막 활성 타임스탬프를 이 테이블로 내보냅니다.
  • 사용자 ID
    • 모든 사용자 ID에 대한 행이 포함됩니다. 필드 중 하나가 변경되면 사용자의 데이터가 업데이트됩니다.
    • 동의하지 않은 사용자의 데이터는 사용자 ID가 포함된 경우 이 테이블로 내보낼 수 있습니다.
    • 가명 ID는 이 테이블로 내보내지 않습니다.
    • 마지막 활성 타임스탬프를 이 테이블로 내보냅니다.

활성 사용자 및 사용자 데이터 내보내기의 모든 사용자 비교

이 내보내기에는 해당 날짜에 데이터가 변경된 모든 사용자가 포함됩니다. 예를 들어 사용자가 세션을 시작하여 user_ltv.sessions의 평생 가치를 증가시키면 이 사용자는 내보내기에 포함됩니다. 사용자가 이 날짜에 잠재고객에 대한 포함 조건과 더 이상 일치하지 않아(예: 지난 7일 동안 구매한 적이 없음) 잠재고객에서 삭제된 경우, 해당 사용자의 데이터가 변경되어 내보내기에 포함됩니다.

사용자는 활동뿐 아니라 데이터 변경사항을 기반으로도 포함되므로, 내보내기에 포함된 사용자 수가 특정 날짜 또는 기간에 활성 사용자 측정항목 값을 초과할 수 있습니다. (활성 사용자 측정항목은 보고서에 사용자로 표시됩니다.)

내보낸 데이터를 쿼리하여 활성 사용자 수만 가져오려면 개발자 문서에 설명된 예시 쿼리를 일부 사용할 수 있습니다.

스키마

다음 섹션에서는 애널리틱스에서 가명 ID 및 사용자 ID 테이블로 내보내는 사용자 데이터를 설명합니다(위 섹션에 열거된 차이점이 적용됨).

감사

필드 이름 데이터 유형 설명
occurrence_date 문자열 레코드 변경이 트리거된 날짜입니다.
last_updated_date 문자열 테이블에서 레코드가 업데이트된 날짜입니다.

사용자

필드 이름 데이터 유형 설명
user_id 문자열 보고 ID의 User-ID 네임스페이스의 ID입니다(사용자 ID 테이블만 해당).
pseudo_user_id 문자열 가명 네임스페이스의 ID입니다(가명 ID 테이블만 해당).
stream_id INTEGER 데이터 스트림 ID입니다(가명 ID 테이블만 해당).

 

사용자 정보

필드 이름 데이터 유형 설명
user_info.last_active_timestamp_micros INTEGER 사용자의 마지막 활동 날짜입니다(마이크로초 단위의 타임스탬프).
user_info.user_first_touch_timestamp_micros INTEGER 사용자의 first_open 이벤트 또는 first_visit 이벤트 중 더 빠른 날짜입니다(마이크로초 단위의 타임스탬프).
user_info.first_purchase_date 문자열 사용자의 첫 구매 날짜입니다(YYYYMMDD).

 

개인 정보 보호 정보

필드 이름 데이터 유형 설명
privacy_info RECORD 개인 정보 보호 관련 정보
privacy_info.is_ads_personalization_allowed 문자열

사용자가 광고 개인 최적화를 사용할 수 있는 경우 isAdsPersonalizationAllowed는 'true'를 반환합니다. 사용자가 광고 개인 최적화를 사용할 수 없는 경우 isAdsPersonalizationAllowed는 'false'를 반환합니다.

Google 애널리틱스에서 현재 사용자가 광고 개인 최적화 대상인지 여부를 반환할 수 없는 경우 isAdsPersonalizationAllowed는 '(not set)'을 반환합니다. isAdsPersonalizationAllowed가 '(not set)'을 반환하는 사용자는 개인 맞춤 광고 게재 대상일 수도 있고 아닐 수도 있습니다. 개인 맞춤 광고의 경우 isAdsPersonalizationAllowed = '(not set)'인 사용자를 isAdsPersonalizationAllowed = 'false'로 취급해야 합니다. 대부분의 경우 '(not set)' 행에 광고 게재 대상이 아닌 사용자가 포함되기 때문입니다.

isAdsPersonalizationAllowed = 'false'인 사용자도 A/B 테스트 및 데이터 탐색 분석과 같은 비광고 사용 사례에 계속 사용할 수 있습니다.

privacy_info.is_limited_ad_tracking 문자열 기기의 광고 추적 제한 설정 가능한 값은 'true', 'false', '(not set)'입니다. Google 애널리틱스가 현재 이 기기의 광고 추적 제한 설정을 반환할 수 없는 경우 isRestrictedAdTracking은 '(not set)'을 반환합니다.

 

잠재고객

필드 이름 데이터 유형 설명
audiences RECORD 잠재고객 정보입니다.
audiences.id INTEGER 잠재고객의 ID입니다.
audiences.name 문자열 잠재고객의 이름입니다.
audiences.membership_start_timestamp_micros INTEGER 사용자가 처음 잠재고객에 포함된 시점입니다(마이크로초 단위의 타임스탬프).
audiences.membership_expiry_timestamp_micros INTEGER

사용자의 잠재고객 멤버십이 만료되는 시점입니다(마이크로초 단위의 타임스탬프).

새 활동이 사용자를 잠재고객으로 재인증하는 경우 포함 기간이 재설정됩니다.

audience.npa 불리언 잠재고객 정의에 포함된 이벤트 및 사용자 범위 맞춤 측정기준에 대한 NPA 설정에 따라 true 또는 false입니다.

 

속성

필드 이름 데이터 유형 설명
user_properties RECORD 사용자 속성 정보입니다.
user_properties.key 문자열 사용자 속성 측정기준 이름입니다.
user_properties.value.string_value 문자열 사용자 속성 측정기준 값입니다.
user_properties.value.set_timestamp_micros INTEGER 측정기준 값이 마지막으로 설정된 시간입니다(마이크로초 단위의 타임스탬프).
     

 

기기

필드 이름 데이터 유형 설명
device RECORD 기기 정보입니다.
device.operating_system 문자열 기기 운영체제입니다.
device.category 문자열 기기의 카테고리입니다(모바일, 태블릿, 데스크톱).
device.mobile_brand_name 문자열 기기 브랜드 이름입니다.
device.mobile_model_name 문자열 기기 모델 이름입니다.
device.unified_screen_name 문자열 화면 이름입니다.

 

지역

필드 이름 데이터 유형 설명
geo RECORD 지리 정보
geo.city 문자열 이벤트가 보고된 도시입니다.
geo.country 문자열 이벤트가 보고된 국가입니다.
geo.continent 문자열 이벤트가 보고된 대륙입니다.
geo.region 문자열 이벤트가 보고된 지역입니다.

 

전체 기간

필드 이름 데이터 유형 설명
user_ltv RECORD 전체 기간 정보입니다.
user_ltv.revenue_in_usd DOUBLE 전체 기간 총 수익(USD)입니다.
user_ltv.sessions INTEGER 전체 기간 총 세션수입니다.
user_ltv.engagement_time_millis INTEGER 전체 기간 총 참여 시간(밀리초)
user_ltv.purchases INTEGER 전체 기간 총 구매 횟수입니다.
user_ltv.engaged_sessions INTEGER 전체 기간 총 참여 세션수입니다.
user_ltv.session_duration_micros INTEGER 전체 기간 총 세션 시간(밀리초)입니다.

 

예측

필드 이름 데이터 유형 설명
predictions RECORD 예측 정보입니다.
predictions.in_app_purchase_score_7d DOUBLE 지난 28일 동안 앱 또는 사이트에서 활성 상태였던 사용자가 다음 7일 이내에 in_app_purchase 이벤트를 기록할 가능성입니다.
predictions.purchase_score_7d DOUBLE 지난 28일 동안 활성 상태였던 사용자가 다음 7일 이내에 purchase 이벤트를 기록할 가능성입니다.
predictions.churn_score_7d DOUBLE 지난 7일 동안 앱 또는 사이트에서 활성 상태였던 사용자가 다음 7일 동안 활성 상태가 아닐 가능성입니다.
predictions.revenue_28d_in_usd FLOAT 다음 28일 이내에 지난 28일 동안 활성 상태였던 사용자의 모든 구매 이벤트로부터 예상되는 수익(USD)입니다.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?
검색
검색어 지우기
검색 닫기
기본 메뉴
6984038677326535841
true
도움말 센터 검색
true
true
true
true
true
69256
false
false