Amplitude 통합

개발자 지원 필요

통합을 설정하려면 개발팀의 도움이 필요합니다. 이 가이드를 개발팀과 공유하세요.

강력한 제품 분석 플랫폼인 Amplitude는 기업이 실시간으로 사용자 행동을 이해하고, 제품 내 상호작용을 추적하며, 사용자 참여, 리텐션 및 수익에 대한 귀중한 인사이트를 얻을 수 있도록 지원합니다.

Amplitude를 Pushwoosh와 통합하면 Amplitude 데이터로 Pushwoosh 캠페인을 개인화하고, 사용자 행동에 기반한 자동화된 캠페인을 트리거하며, 지속적인 개선을 위해 성과를 분석하고, 궁극적으로 참여도 향상, 이탈 감소 및 수익 증대를 이끌어낼 수 있습니다.

통합 개요

통합 유형

대상: 데이터는 Amplitude에서 Pushwoosh로 전송됩니다.

전제 조건

Amplitude에서 Pushwoosh로 이벤트 스트리밍 및 코호트 동기화 통합을 설정하려면 다음 전제 조건이 충족되어야 합니다:

• 활성 Pushwoosh 계정이 필요합니다.
• 데이터를 전송하려면 Pushwoosh에서 API 액세스 토큰을 생성해야 합니다.
• 통합을 구성하기 전에 Pushwoosh 앱 코드를 찾아야 합니다.
• 이 통합은 유료 플랜을 사용하는 Amplitude 고객만 사용할 수 있습니다.
• 이 통합을 사용하려면 유료 Pushwoosh 플랜이 있어야 합니다.

용어집 (엔티티 이름이 다른 경우 매핑)

Amplitude의 코호트(Cohorts) = Pushwoosh의 세그먼트(Segments)

동기화된 엔티티

• 이벤트
• 태그
• 세그먼트

통합은 어떻게 작동하나요?

Pushwoosh와의 Amplitude 통합은 두 플랫폼 간의 데이터를 동기화하여 사용자 참여 및 세분화를 향상시키는 방식으로 작동합니다. 작동 방식에 대한 자세한 내용은 다음과 같습니다:

데이터 전송

• 이벤트: Amplitude는 이벤트 데이터를 Pushwoosh로 전송합니다. 각 이벤트에는 사용자 ID(external_id), 애플리케이션 코드(app_id), 타임스탬프(created_at) 및 추가 속성(attributes)이 포함됩니다.

• 태그: Pushwoosh는 사용자 프로필과 연결된 태그를 수신합니다. 이 태그는 사용자 ID(external_id), 애플리케이션 코드(app_id) 및 태그 속성(properties)과 함께 전송됩니다.

• 세그먼트: 세그먼트는 Pushwoosh가 CSV 가져오기를 처리하는 방식과 유사하게 가져옵니다. 사용자는 요청을 통해 세그먼트에 추가되거나 제거됩니다.

데이터 흐름

• 이벤트 및 태그: 데이터는 Amplitude에서 추적된 사용자 상호작용 또는 속성을 기반으로 Amplitude에서 Pushwoosh로 전송됩니다. 이벤트와 태그는 Amplitude에서 설정된 구성 및 매핑에 따라 Pushwoosh에서 생성되거나 업데이트됩니다.

• 세그먼트: Amplitude가 요청을 할 때 Pushwoosh에서 세그먼트가 생성됩니다. Pushwoosh는 각 세그먼트에 대해 고유 식별자를 생성하며, Amplitude는 이 식별자를 사용하여 사용자를 추가하거나 제거함으로써 세그먼트를 조작합니다.

요청

요청은 이벤트, 사용자 속성 및 세그먼트 업데이트를 처리하기 위해 Pushwoosh의 특정 엔드포인트로 전송됩니다. 각 요청에는 인증이 필요하며 특정 헤더 및 페이로드 형식이 있습니다.

사용 사례

이벤트 추적

Amplitude에서 사용자 행동 및 상호작용을 추적하고 이러한 이벤트를 Pushwoosh로 전송하여 알림 또는 업데이트를 트리거합니다.

사용자 태그 지정

Amplitude에서의 행동 또는 속성을 기반으로 사용자에게 태그를 할당합니다. 이 태그는 Pushwoosh에서 타겟 메시징 또는 세분화에 사용될 수 있습니다.

세그먼트 관리

Amplitude에서 구성된 데이터 및 세그먼트를 기반으로 Pushwoosh에서 사용자 세그먼트를 생성하고 관리합니다. 이는 특정 사용자 그룹에게 개인화된 메시지를 타겟팅하는 데 도움이 됩니다.

자동화된 사용자 관리

Amplitude에서의 행동 또는 속성을 기반으로 세그먼트에서 사용자를 자동으로 추가하거나 제거하여 Pushwoosh에서 최신 세분화를 보장합니다.

통합 설정하기

코호트 동기화

Pushwoosh 설정

1. Pushwoosh에서 설정 > 통합으로 이동합니다.

2. 통합 추가를 클릭한 다음 Amplitude를 찾아 추가합니다.

   

3. Pushwoosh API 키와 앱 코드를 클립보드에 복사합니다.

Amplitude 설정

통합을 위해 Amplitude를 구성하려면 다음 단계를 따르세요:

1. Amplitude 데이터에서 카탈로그로 이동하여 대상을 선택합니다.
2. 코호트 섹션에서 Pushwoosh를 찾아 클릭합니다.

3. 다른 대상 추가를 클릭합니다.

4. 이름을 제공하고 Pushwoosh에서 복사한 API 키를 붙여넣습니다.

5. Amplitude 사용자 ID 필드를 Pushwoosh 사용자 ID 필드에 매핑합니다.
6. 완료되면 설정을 저장합니다.

코호트 전송하기

첫 번째 코호트를 동기화하려면 다음 단계를 완료하세요:

1. Amplitude에서 동기화하려는 코호트를 열고 동기화를 클릭합니다.

2. Pushwoosh를 선택하고 동기화할 계정을 선택합니다. 그런 다음 다음을 클릭합니다.

3. 동기화 주기를 결정하고 구성을 저장합니다.

이벤트 스트리밍

Pushwoosh 설정

1. Pushwoosh API 키를 가져옵니다.

2. Pushwoosh 계정에서 앱 코드를 찾습니다.

Amplitude 설정

1. Amplitude에서 데이터 대상으로 이동하여 Pushwoosh - 이벤트 스트림을 찾습니다.

2. 동기화 이름을 입력한 다음 동기화 생성을 클릭합니다.

3. 상태를 비활성화됨에서 활성화됨으로 변경하고 Pushwoosh API 액세스 토큰과 앱 코드를 붙여넣습니다.

4. 왼쪽 드롭다운에서 Pushwoosh UserID에 해당하는 Amplitude 사용자 속성을 선택합니다.
5. (선택 사항) Amplitude가 사용자 속성을 생성하거나 업데이트할 때마다 사용자와 해당 속성을 실시간으로 전송하려면 사용자 생성 및 업데이트 토글을 활성화합니다.

6. 이벤트를 Pushwoosh로 스트리밍하려면 이벤트 전송(“이벤트가 Pushwoosh로 전송됩니다”)을 활성화합니다. 이렇게 하면 이벤트가 Amplitude에 수집될 때 자동으로 Pushwoosh로 전달됩니다. 이 통합을 사용하면 이벤트가 일정에 따라 또는 요청 시 전송되지 않습니다.

8. 그런 다음 이벤트 선택 및 필터링 섹션에서 전송할 이벤트를 선택합니다. Pushwoosh에서 필요한 이벤트만 선택하세요. 변환된 이벤트는 지원되지 않습니다.
9. 완료되면 대상을 활성화하고 저장을 클릭합니다.

통합이 작동하는지 어떻게 알 수 있나요?

Amplitude와 Pushwoosh 통합이 올바르게 작동하는지 확인하려면 다음 방법을 사용할 수 있습니다:

Pushwoosh 대시보드 모니터링

• 이벤트 및 태그: Pushwoosh 대시보드를 확인하여 Amplitude에서 보낸 이벤트와 태그가 예상대로 나타나는지 확인합니다. 이벤트 및 태그와 관련된 최근 활동이나 업데이트를 찾아보세요.
• 세그먼트: Amplitude의 데이터를 기반으로 세그먼트가 생성, 업데이트 또는 수정되고 있는지 확인합니다. 사용자 수와 세그먼트 멤버십이 예상된 변경 사항을 반영하는지 확인하세요.

API 응답 확인

• 성공적인 응답: Pushwoosh API 엔드포인트에서 200 OK 응답을 받는지 확인합니다. 항상 응답 본문이 있는 것은 아니지만, 200 OK 상태는 요청이 성공적으로 수신되었음을 나타냅니다.
• 오류 응답: 작동하지 않는 경우 단서를 찾기 위해 200 OK 이외의 오류 응답이나 상태 코드를 검토합니다. 일반적인 오류에는 400 Bad Request, 401 Unauthorized 또는 500 Internal Server Error가 포함될 수 있습니다.

요청 및 응답 기록

• 요청 로그: Amplitude에서 나가는 요청과 Pushwoosh에서 들어오는 응답의 로그를 유지합니다. 이 로그를 확인하여 요청이 올바르게 형식화되었고 응답이 예상대로인지 확인합니다.
• 오류 로깅: 데이터 전송 또는 통합 프로세스 중 발생하는 문제를 캡처하기 위해 오류 로깅을 구현합니다.

샘플 데이터로 테스트

• 테스트 이벤트/태그 전송: Amplitude에서 Pushwoosh로 테스트 이벤트와 태그를 생성하여 보냅니다. 이러한 테스트 항목이 Pushwoosh에 올바르게 나타나고 예상된 동작을 트리거하는지 확인합니다.
• 사용자 행동 시뮬레이션: Pushwoosh에서 특정 이벤트나 업데이트를 트리거해야 하는 작업을 Amplitude에서 수행합니다. 이러한 작업이 Pushwoosh에서 예상된 변경을 초래하는지 확인합니다.

모니터링 도구 사용

• 통합 모니터링: 통합의 상태와 성능을 추적할 수 있는 모니터링 도구나 서비스를 활용합니다. 이러한 도구는 문제나 장애를 실시간으로 알려줄 수 있습니다.
• 분석 및 보고: Amplitude와 Pushwoosh 모두의 분석 기능을 사용하여 데이터 흐름과 통합 성능을 검토합니다.

통합 문서 검토

• 구성 검토: Amplitude와 Pushwoosh의 통합 구성을 다시 확인하여 모든 설정과 매핑이 올바르게 적용되었는지 확인합니다.
• 문서 업데이트: 기능에 영향을 줄 수 있는 통합 문서의 변경 사항이나 업데이트를 최신 상태로 유지합니다.

지원팀에 문의

지속적인 문제나 불일치가 발생하는 경우 Amplitude 또는 Pushwoosh의 지원팀에 문의하여 도움을 요청하세요. 더 빠른 해결을 위해 통합 설정 세부 정보와 오류 로그를 제공하세요.

문제 해결

통합 문제

• Pushwoosh에 이벤트가 나타나지 않음: 이벤트가 올바르게 매핑되었는지 확인하고 Pushwoosh 애플리케이션 코드와 API 토큰이 올바르게 구성되었는지 확인합니다.

• 태그가 동기화되지 않음: 태그가 올바르게 형식화되었고 모든 필요한 인증 세부 정보가 요청에 포함되었는지 확인합니다.

세그먼트 문제

• 세그먼트가 생성되지 않음: 세그먼트를 생성하는 요청이 올바르게 형식화되었고 Pushwoosh API 토큰이 유효한지 확인합니다.

• 사용자가 추가/제거되지 않음: 사용자 ID가 올바르게 지정되었고 세그먼트 ID가 유효한지 확인합니다. 요청 페이로드가 올바르게 형식화되었는지 확인합니다.

응답 문제

• 응답 본문 없음: 200 OK 응답을 받았지만 응답 본문이 없는 경우, 요청이 올바르게 형식화되었고 데이터가 올바르게 전송되었는지 확인합니다.

자주 묻는 질문

400 Bad Request 오류가 발생하면 어떻게 해야 하나요?

요청 페이로드에서 형식 오류나 누락된 필드가 있는지 검토하세요. 모든 필수 필드가 포함되고 올바르게 형식화되었는지 확인하세요.

통합이 작동하는지 어떻게 확인할 수 있나요?

Pushwoosh 대시보드에서 들어오는 이벤트, 태그 및 세그먼트 업데이트를 확인하세요. 또한 성공적인 데이터 전송을 위해 API 엔드포인트의 로그나 응답을 모니터링할 수 있습니다.

Pushwoosh로 전송되는 이벤트나 태그를 사용자 정의할 수 있나요?

예, Amplitude 구성 내에서 이벤트와 태그를 사용자 정의할 수 있습니다. 데이터가 예상되는 Pushwoosh 형식을 준수하는지 확인하세요.

Amplitude와 Pushwoosh 간의 데이터는 얼마나 자주 동기화되나요?

데이터는 Amplitude에서 이루어진 요청을 기반으로 실시간 또는 거의 실시간으로 동기화됩니다. 구성이 원하는 업데이트 빈도를 지원하는지 확인하세요.

이 통합에 대한 추가 정보나 지원은 어디서 찾을 수 있나요?

Amplitude와 Pushwoosh의 공식 문서를 참조하세요. 추가 지원이 필요한 경우 각 지원팀에 문의하세요.