이 페이지에서

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.

Amazon S3(코호트)

코호트를 Amazon S3 버킷으로 전송하도록 이 연동을 설정하십시오. 이 내보내기 기능은 Amplitude에서 사용자 그룹을 내보내 Amazon S3 버킷을 기반으로 구축된 다른 데이터베이스 또는 저장 프로시저와 동기화할 수 있도록 합니다. 그런 다음 내부 분석 대시보드와 개인화 엔진에서 Amplitude 코호트를 사용할 수 있습니다.

Amplitude는 AWS 모범 사례에 더 잘 부합하도록 보안 모델을 업데이트했습니다. 이 목적지의 새 인스턴스는 보안을 강화하고 과도한 권한을 방지하기 위해 기본적으로 IAM 역할 기반 액세스를 사용합니다. 기존 S3 대상은 중단을 방지하기 위해 변경되지 않은 채로 유지됩니다.

기존 목적지를 IAM 역할로 업데이트하려면 기존 연결을 삭제하고 업데이트된 보안 모델을 사용하도록 코호트 동기화 목적지를 재구성하십시오.

사전 조건

  • Amazon S3 콘솔에서 Amplitude를 동기화할 S3 버킷을 찾으십시오. 해당 이름, 경로 및 지역을 복사합니다.

연동 설정

Amplitude 설정

  1. Amplitude 데이터에서 카탈로그를 클릭하고 대상 탭을 선택합니다.
  2. 코호트 섹션에서 **Amazon S3(코호트)**를 클릭합니다. 이 연동에 Amazon S3를 선택하지 마십시오.
  3. 버킷 이름을 입력하고, 지역을 선택하고, 버킷 경로를 입력하고(선택 사항), 목적지 이름을 입력합니다. Amplitude는 코호트를 동기화할 때 이름을 사용합니다.
  4. Amplitude 사용자 속성을 선택하여 Amazon S3와 Amplitude 간의 사용자를 일치시킵니다.
  5. 버킷 정책 복사를 클릭합니다.

Amazon S3 설정

  1. Amazon S3 콘솔에서 S3 버킷으로 이동한 후 권한 관리 → 버킷 정책으로 이동합니다. Amplitude 버킷 정책을 Amazon S3 콘솔에 붙여넣으십시오.
  2. 필요에 따라 버킷에 대해 다음 두 가지 매개 변수를 설정하십시오.
    • 접미사 필요: 설정된 경우 사용자는 S3로 내보낸 모든 파일의 끝에 문자열을 추가할 수 있습니다.
    • 사용자 속성: 내보낸 각 파일에서 각 사용자와 함께 추가 열로 동기화할 단일 사용자 속성을 선택합니다.

코호트 보내기

S3 버킷을 Amplitude에 연결한 후에는 모든 코호트를 해당 버킷에 동기화할 수 있습니다.

  1. Amplitude의 코호트 페이지에서 전송할 코호트를 클릭하거나 코호트를 생성하십시오.
  2. 동기화를 클릭합니다.
  3. Amazon S3를 선택하고 다음을 클릭합니다.
  4. S3 위치를 선택합니다. 이 이름은 연동을 설정할 때 버킷에 지정한 이름입니다.
  5. (선택 사항). 다음 두 가지 선택적 매개변수를 설정합니다.
    • 사용자 속성: 이 코호트에서 내보낸 각 사용자에게 사용자 속성을 추가합니다. 사용자 속성은 내보낸 CSV 파일에 열로 나타납니다.
    • 라우팅 키: S3의 코호트 파일 이름 끝에 추가할 문자열을 입력합니다.
  6. 동기화 케이던스를 선택합니다.
  7. 완료되면 동기화를 클릭합니다.

S3의 코호트

Amplitude는 사용자가 지정한 버킷에 코호트를 CSV로 동기화합니다. 폴더 내에는 CSV 파일 목록이 있습니다.

각 동기화는 세 개의 CSV 파일을 생성합니다.

  • 하나는 마지막 동기화 날짜 이후 코호트에 참여한 사용자들입니다.
  • 하나는 마지막 동기화 날짜 이후 코호트에서 나간 사용자들입니다.
  • 마지막 동기화 시점에 코호트에 존재했던 사용자를 포함하는 항목입니다. 이러한 방식으로 항상 S3 코호트 멤버십에 대한 완전한 기록 로그를 보유할 수 있습니다.

CSV 파일은 모두 다음 명명 규칙을 사용합니다.

path/projectID_cohortID_YYYY-MM-DDTHH:SS_difftype_routingkey.csv

위치:

  • path: 파일을 기록해야 할 경로의 선택적 폴더 접두어입니다.
  • projectID: 코호트가 속한 Amplitude 프로젝트를 식별합니다.
  • cohortID: 귀하의 코호트에 대한 고유 식별자입니다. 이 숫자는 Amplitude에서 귀하의 코호트 URL에서 확인할 수 있습니다.
  • YYYY-MM-DDTHH-SS: 코호트가 동기화되었을 때의 타임스탬프입니다.
  • difftype: CSV 파일에 포함된 세 사용자 그룹 중 어느 그룹을 사용하는지 설명합니다. 허용되는 값은 entering, exiting, 또는 existing입니다.
  • routingkey: 이전에 입력한 선택적 문자열 접미사입니다.

CSV 이름의 타임스탬프는 코호트가 동기화된 날짜/시간을 나타냅니다. 매시간 또는 매일 예약된 동기화를 사용하는 경우, Amplitude는 각 동기화에 대해 해당 시점에 해당 코호트에 속한 자격을 갖춘 사용자의 전체 목록을 포함한 새 파일을 생성합니다. 오디언스 멤버십에 대한 기록을 보관할 수 있습니다.

각 CSV 파일에는 사용자 목록이 포함되어 있으며 데이터는 다음 열로 구분됩니다.

  • amplitudeID: 사용자의 내부 Amplitude 식별자입니다.
  • userID: 사용자의 고유한 데이터베이스 식별자입니다.
  • userProperty: 코호트 전송 섹션의 3단계에서 추가한 사용자 속성의 값입니다. 각 사용자 속성에는 하나의 열이 있습니다. 포트폴리오 프로젝트에는 각 소스 앱에 대한 별도의 열이 있습니다.

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