이벤트 수집 연동 생성

예비 작업 요구 사항

이 가이드는 귀하가 Amplitude 연동 포털에 나열된 파트너 연동 구축을 위한 전제 조건을 완료했다고 가정합니다. Amplitude는 기본적으로 이벤트 수집 연동 생성을 비활성화합니다. 이벤트 수집 연동을 생성하려면 Org ID를 포함하여 integrations@amplitude.com으로 이메일을 보내십시오.

이벤트 수집 연동을 구축하면 Amplitude 연동 포털이 플랫폼에서 발생한 이벤트를 수락하도록 구성된 다음 해당 구성을 Amplitude 고객이 사용할 수 있는 소스 타일로 패키징합니다. 플랫폼에서 이벤트를 데이터 소스로 Amplitude에 전송할 때 이벤트 수집 연동을 사용하십시오. Amplitude가 이벤트를 플랫폼으로 전달하도록 하려면 대신 이벤트 스트리밍 연동을 구축하십시오. 이 가이드에서는 연동을 구축하거나 Amplitude로 이벤트를 전송하는 방법에 대해서는 설명하지 않습니다. Amplitude로 이벤트를 전송하는 방법에 대한 자세한 내용은 HTTP v2 API 문서를 참조하십시오.

설정 > 개발자 포털로 이동합니다.
연결 정보 추가를 클릭합니다.
연결 정보를 입력하십시오.
- 표시 이름: 연동의 표시 이름입니다. 이 이름은 연동 카탈로그와 연동 타일에 표시되는 이름입니다.
- 범주: 범주를 선택합니다. 연동 카탈로그는 필터에 해당 범주를 사용합니다.
- 요약: 귀사의 제품에 대한 간략한 요약입니다.
- 전체 설명: 연동에 대한 자세한 설명입니다. 일반적인 사용 사례를 포함시켜 사용자가 연동을 사용해야 하는 이유를 이해할 수 있도록 하십시오.
- 연동 로고: 연동 로고를 PNG 형식으로 업로드하십시오.

연동 설정

Amplitude가 연동을 검증한 후 Amplitude의 소스 페이지에 표시되는 연동 타일을 구성합니다.

이 페이지는 두 개의 섹션으로 구성됩니다.

왼쪽 패널: 왼쪽의 구성 섹션에서는 데이터 소스에 대한 설정 지침을 작성하고 연동 타일을 구성할 수 있습니다.

오른쪽 패널: 데이터 소스 설정 페이지 미리 보기 섹션은 사용자가 보는 설정 지침의 모양을 보여줍니다.

연동 포털 페이지(설정 > 개발자 포털)에서 새 소스 추가를 클릭합니다.
연결 정보 섹션은 표시 이름을 제어합니다.
부제목을 입력하십시오. 이 정보는 사용자가 연동을 설정할 때 제목 아래에 표시됩니다.

자막 예제

Braze를 사용하는 경우 이제 이벤트를 Amplitude로 전송할 수 있습니다.
RudderStack을 사용하여 데이터를 수집하는 경우, 몇 단계를 거쳐 이벤트를 Amplitude로 가져올 수 있습니다.
기능 플래그 지정 및 실험에 Split을 사용한다면, 간단한 구성으로 데이터를 Amplitude로 추적할 수 있습니다.

필요한 만큼 설정 단계를 추가하되 5~8개 이하로 설정하십시오. 사용자의 이해를 돕는 이미지를 포함할 수 있습니다. 프로젝트 API 키 표시를 선택하면 사용자를 대신하여 관련 프로젝트 API를 자동으로 가져옵니다. Amplitude의 모든 소스와 목적지는 조직 수준이 아닌 프로젝트 수준에서 설정합니다.

Amplitude에서 설정 단계 예제 보기

데이터 소스로 이동한 후 Amplitude로 데이터 가져오기를 클릭합니다. 여기에서 아무 연동 타일이나 클릭하여 해당 설정 지침을 확인하십시오.

추가 리소스에서 문서에 대한 링크를 추가합니다. 예를 들어, Refer to the Amplitude [documentation](/docs/get-started) for more details and instructions.
완료되면 다음을 클릭하여 테스트 탭으로 이동합니다.

연동 테스트 및 제출

소스 정보를 구성한 후에는 테스트하고 검토를 위해 제출할 수 있습니다.

테스트 소스 탭에서 연동을 테스트할 Amplitude 프로젝트를 선택합니다.
이 소스 연동에 대해 할당된 파트너 ID의 값을 복사하십시오. 이벤트를 Amplitude로 전송할 때 이 값을 partner_id 매개변수에 포함해야 합니다. Amplitude는 파트너로부터 오는 이벤트를 추적하고 연동 사용자 수를 확인하기 위해 이 정보를 필요로 합니다.
시스템에서 테스트 이벤트를 전송합니다.

페이로드 예제

json

{
  "api_key": "2a0d30356cbb278eee1a69b2bbe81c37",
  "events": [
    {
      "user_id": "test@example.com",
      "partner_id": "integration_name",
      "event_type": "Product Viewed",
      "time": 1663940508564,
      "event_properties": {
        "message_type": "push",
        "message_title": "Sample Message title",
        "message_id": "68b32868-b6ab-4511-b552-cf668a1c0e59",
        "message_contents": "Sample message content"
      }
    }
  ]
}

Amplitude가 이벤트를 확인할 때까지 기다립니다.

테스트를 마친 후 제출을 클릭하여 연동을 Amplitude 팀에 제출하십시오. 검토 과정은 약 1주일이 소요됩니다. Amplitude가 연동을 승인하면 이메일로 알림을 보내며, Amplitude의 소스 섹션에 연동 타일이 나타납니다.

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