Google Vertex AI 검색

Amplitude Data의 Google Vertex AI 연동은 Amplitude 이벤트 데이터를 Google Cloud Vertex AI Search for Commerce로 스트리밍합니다.

고려 사항

• Amplitude는 이벤트 데이터를 Vertex AI의 userEvents.write 엔드포인트에 게시하고 FreeMarker 템플릿을 사용하여 각 Amplitude 이벤트를 필요한 Vertex AI 스키마에 매핑합니다.
• 목적지를 활성화하기 전에 매핑이 Google Cloud 사용자 이벤트 스키마와 일치하는지 확인하십시오.

연동 설정

사전 조건

시작하기 전에 적절한 액세스 권한을 가진 Google IAM 서비스 계정을 생성하십시오.

Amplitude는 연동을 설정하기 위해 Vertex AI의 네 가지 요소를 필요로 합니다.

• Google 서비스 계정 JSON: Amplitude Vertex AI 연동을 위한 전용 서비스 계정을 생성합니다. 이 단계에 대한 도움말은 Google 문서를 참조하십시오.
• GCP 프로젝트 ID: 리테일 카탈로그가 존재하는 GCP 프로젝트의 이름입니다.
• 리테일 위치: 지역 카탈로그가 없는 경우 global 사용하십시오.
• 리테일 카탈로그 ID: 추가 카탈로그를 생성하지 않은 경우 default_catalog사용하십시오.

Google Vertex AI 설정

Vertex AI userEvents.write 엔드포인트를 활성화하고 서비스 계정을 생성한 후, 서비스 계정에 대한 키를 생성하십시오. 이 키는 Amplitude 설정을 완료하기 위해 필요합니다. 이 단계에 대한 도움말은 Google 문서를 참조하십시오.

Amplitude 설정

1. Amplitude 데이터에서 카탈로그 > 대상으로 이동하십시오.
2. 이벤트 스트리밍 섹션에서 Google Vertex AI를 클릭하십시오.
3. 동기화 이름을 입력한 다음 동기화 생성을 클릭합니다.
4. 편집을 클릭한 다음 서비스 계정 JSON을 업로드합니다.
5. 필요한 경우 GCP 프로젝트 ID, 리테일 위치 및 리테일 카탈로그 ID를 업데이트합니다.
6. Apache FreeMarker 템플릿을 사용하여 페이로드를 사용자 정의합니다. FreeMarker 템플릿 언어 섹션을 참조하십시오.
7. 이벤트 전송 필터를 사용하여 전송할 이벤트를 선택합니다.
8. 완료되면 목적지를 활성화하고 저장을 클릭합니다.

프리마커 템플릿 언어

Amplitude는 Apache FreeMarker 템플릿을 사용하여 Amplitude 이벤트를 Vertex AI 사용자 이벤트 스키마와 일치하는 JSON으로 변환합니다. 이 input 변수는 Amplitude의 내보내기 형식에서 각 이벤트를 참조합니다.

날짜/시간 형식 및 선택적 필드를 포함한 고급옵션 FreeMarker 패턴에 대한 자세한 내용은 웹후크 스트리밍 목적지를 참조하십시오.

예제 템플릿

{
      <#if input.user_id??>
      "visitorId" : "${input.user_id}",
      </#if>
      "eventType" : "${input.event_type}",
      "eventTime" : "${input.event_time}",
      "productDetails" : [{
            "product" : {
                  "id" : "${input.event_properties.product_id!}"
            }
      }]
}

이 템플릿을 사용하면 다음 JSON 페이로드가 Vertex AI userEvents.write 엔드포인트로 전송됩니다.

{
  "visitorId": "some user id",
  "eventType": "detail-page-view",
  "eventTime": "2022-10-24T20:07:32.123Z",
  "productDetails": [
    {
      "product": {
        "id": "product-123"
      }
    }
  ]
}

필드 이름과 중첩된 객체를 사용자가 전송하는 이벤트 유형 및 속성과 일치하도록 조정합니다. Amplitude event_properties 및 user_properties를 카탈로그에 필요한 Vertex AI 필드에 매핑하십시오.