사용자 이벤트 구현

사용자 이벤트를 구성하려면 다음 단계를 따르세요.

  1. 이전 사용자 이벤트를 가져옵니다.

  2. 실시간 사용자 이벤트를 기록합니다.

  3. 항목으로 사용자 이벤트에 태그를 지정합니다.

  4. 기여 분석 토큰으로 사용자 이벤트를 신고합니다.

사용자 정보

visitorId 값은 고유한 사용자 식별자를 나타냅니다. 사용자 이벤트를 기록할 때 필요합니다. (UserInfo)는 visitorId 값과 userId 값(있는 경우)이 있는 사용자 이벤트를 기록할 때 포함됩니다.

선택사항인 userId 값은 사용자가 사이트에 로그인할 때마다 여러 기기에서 사용자의 고유한 영구 식별자로 사용할 수 있습니다. 사용자의 userId를 기록할 때 상거래용 Vertex AI Search는 휴대기기와 웹브라우저 등 여러 기기에서 사용자 한 명에 대해 더욱 맞춤설정된 결과를 생성할 수 있습니다.

사용자 이벤트 타임스탬프

사용자 이벤트를 기록할 때는 이벤트가 발생한 시점의 정확한 타임스탬프를 포함해야 합니다. 정확한 타임스탬프를 사용하면 이벤트가 올바른 순서로 저장될 수 있습니다. 태그 관리자 및 JavaScript Pixel을 사용하여 수집된 이벤트의 타임스탬프는 자동으로 기록됩니다. 이벤트를 가져올 때는 eventTime 필드에 RFC 3339로 지정된 형식으로 타임스탬프를 제공해야 합니다.

사용자 이벤트의 맞춤 속성

사용자 이벤트에 대한 추가 맞춤 속성 및 기능을 포함할 수 있습니다. 이를 사용하면 추천을 사용할 때 사용자에게 보다 구체적인 추천이 제공될 수 있습니다. 맞춤 속성을 추가하려면 사용자 이벤트를 기록할 때 attributes를 사용합니다.

수집된 사용자 이벤트에 대해 맞춤 속성을 제공할 경우 예측 요청과 연결된 사용자 이벤트에도 해당 속성을 포함해야 합니다. 맞춤 속성의 형식은 가져온 이벤트와 예측 요청으로 제공된 이벤트 간에 일관되어야 합니다. 이렇게 하면 모델 학습 및 예측 제공 시 이러한 커스텀 속성을 사용할 수 있으므로 추천 품질을 개선할 수 있습니다.

text 필드를 사용하여 커스텀 텍스트 값을 제공하거나 number 필드를 사용하여 커스텀 숫자 값을 제공할 수 있습니다.

예를 들어 다음은 사용자 이벤트 기록 요청의 attributes 섹션을 보여줍니다.

"attributes": {
  "user_age": {"text": ["teen", "young adult"]},
  "user_location": {"text": ["CA"]}
}

가져오기 상태 모니터링

고품질의 결과를 받으려면 사용자 이벤트를 성공적으로 기록하는 것이 중요합니다. 이벤트 기록 오류 비율을 모니터링하고 필요에 따라 조치를 수행해야 합니다. 자세한 내용은 데이터 업로드 문제 알림 설정을 참조하세요.