Google Pub/Sub(코호트 동기화)

Amplitude 데이터의 Google Pub/Sub 코호트 연동을 사용하면 코호트 멤버십 업데이트를 Pub/Sub 주제로 바로 스트리밍할 수 있습니다.

고려 사항

• 이 연동은 유료 Amplitude 플랜을 사용하는 고객에게만 제공됩니다.
• 이 연동을 사용하려는 각 Amplitude 프로젝트에 대해 활성화해야 합니다.
• 이 연동을 설정하기 전에 Amplitude 활성화 및 행동 코호트를 검토하십시오.
• Amplitude는 지원되는 모든 케이던스(매일, 매시간, 실시간)를 통해 코호트 업데이트를 전송합니다.
• 기존의 모든 실시간 코호트 동기화 제한이 적용됩니다.

페이로드

Pub/Sub로 전송되는 페이로드는 JSON 객체입니다. 예:

{
  "cohort_name": "Test Cohort",
  "cohort_id": "gs72ns",
  "in_cohort": true,
  "computed_time": "1685748245",
  "message_id": "some-message-id:54",
  "users": [{
    "user_id": "user1@amplitude.com"
    },
    {
      "user_id": "user2@amplitude.com"
    }]
}

• cohort_name: 문자열입니다. 대상의 이름입니다.
• cohort_id: 문자열입니다. 대상의 고유 ID로, Amplitude에서 대상을 볼 때 URL에도 표시됩니다.
• in_cohort: 부울입니다. 이 사용자 배치가 대상에 진입하는지 아니면 탈퇴하는지를 나타냅니다. 각 메시지는 하나의 상태를 포함하며 둘 다 포함하지 않습니다.
• compute_time: 문자열입니다. Amplitude가 대상을 재계산할 때의 에포크 타임스탬프입니다. Kinesis 스트리밍은 수신 메시지에 대한 순서를 적용할 수 없습니다. 이 타임스탬프를 사용하여 순서를 복원하십시오.
  • Amplitude는 이 값을 숫자가 아닌 문자열로 전송합니다. 이는 일부 언어와 플랫폼이 JSON 숫자를 부동 소수점 수로 해석하여 정밀도를 잃기 때문입니다.
• message_id: 문자열입니다. 각 메시지의 고유 ID입니다.
• users: 목록입니다. 사용자 배치입니다. 각 사용자는 JSON 객체로 나타납니다.
  • user_id: 문자열입니다. 사용자의 ID입니다.

연동 설정

사전 조건

시작하기 전에 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. 이 목적지에 대한 표시 이름을 입력합니다. 이 이름은 코호트를 동기화할 때 목적지를 식별합니다.
5. Pub/Sub 주제 ID를 입력합니다.
6. 위의 설정에 따라 서비스 계정 키를 .json 형식으로 업로드합니다.
7. 목적지를 저장합니다.

Amplitude는 코호트 데이터 동기화의 목적지를 생성합니다.

코호트 보내기

1. Amplitude에서 내보낼 코호트를 엽니다.
2. 동기화를 클릭하고 Google Pub/Sub를 선택합니다.
3. 생성한 목적지를 선택합니다.
4. 필요한 동기화 빈도를 선택합니다.