이 페이지에서

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Google Pub/Sub(이벤트 스트림)

Amplitude 데이터의 Google Pub/Sub 연동을 통해 Amplitude 이벤트 데이터를 Pub/Sub로 바로 스트리밍할 수 있습니다.

고려 사항

  • Amplitude는 user_id, event_name, 및 created_at를 모든 사용자, 그룹 및 이벤트 속성과 함께 Pub/Sub로 전송합니다.
  • Amplitude가 Pub/Sub에 게시하는 데이터는 Amplitude Export API에 설명된 것과 동일한 JSON입니다.
  • 이 대상은 Identify Forwarding을 지원합니다. 사용자가 Amplitude에 대해 Identify 호출을 할 때마다 Amplitude는 해당 사용자 정보를 전달합니다. 자세한 내용은 Identify 문서를 참조하십시오.
  • Google Cloud 서비스 계정을 base64 인코딩된 문자열로 입력합니다.

연동 설정

사전 조건

시작하기 전에 Pub/Sub에 주제를 생성하고 Google IAM 서비스 계정을 생성하십시오.

Amplitude는 연동을 설정하기 위해 Pub/Sub에서 두 가지 요소를 필요로 합니다:

  • Pub/Sub 주제 이름: Google Cloud의 전체 이름이 아닌 주제의 이름입니다. 이 단계에 대한 도움말은 Google Pub/Sub 문서를 참조하십시오.
  • Google 서비스 계정 키: Amplitude Pub/Sub 연동을 위한 전용 서비스 계정을 생성하십시오. 이 단계에 대한 도움말은 Google 문서를 참조하십시오.

Google Pub/Sub 설정

주제와 서비스 역할을 생성한 후, 생성한 주제의 보안 주체로 서비스 계정을 추가하십시오. 자세한 지침은 Google 문서를 참조하십시오.

  1. 주제를 엽니다.
  2. 권한 관리 탭에서 보안 주체 추가를 클릭합니다.
  3. 서비스 계정의 이름을 추가합니다.
  4. 역할로 Pub/Sub Publisher를 선택합니다.

다음으로, 서비스 계정에 대한 키를 생성합니다. 이 정보는 Amplitude 설정을 완료하기 위해 필요합니다. 이 단계에 대한 도움말은 Google 문서를 참조하십시오.

Amplitude 설정

  1. Amplitude 데이터에서 카탈로그를 클릭하고 대상 탭을 선택합니다.
  2. 이벤트 스트리밍 섹션에서 Google Pub/Sub를 클릭합니다.
  3. 동기화 이름을 입력한 다음 동기화 생성을 클릭합니다.
  4. 편집을 클릭한 다음 Pub/Sub 주제 이름과 Google Cloud 서비스 계정 키를 붙여넣습니다.
  5. 이벤트 전송 필터를 사용하여 전송할 이벤트를 선택합니다. Amplitude는 가장 중요한 이벤트만 전송할 것을 권장합니다.
  6. 완료되면 목적지를 활성화하고 저장합니다.

이 내용이 도움이 되었나요?