RudderStack 통합
RudderStack은 앱, 웹사이트, 서버, 데이터 웨어하우스에서 이벤트를 수집하여 다른 도구로 전달하는 고객 데이터 플랫폼입니다. RudderStack의 Pushwoosh destination을 사용하면 이미 RudderStack에서 수집하고 있는 데이터가 앱에 추가 코드 없이 Pushwoosh로 전달됩니다.
- Track 이벤트는 Pushwoosh 이벤트가 됩니다. 이를 사용하여 세그먼트를 만들고 Customer Journey를 시작하거나 분기할 수 있습니다.
- Identify 트레이트는 사용자별(user-specific) 태그가 됩니다. 이를 사용하여 푸시 알림, 인앱 메시지, 이메일을 타겟팅하고 개인화할 수 있습니다.
시작하기 전에
Anchor link todestination은 모든 데이터를 User ID로 매칭하므로 먼저 다음 사전 요구 사항을 확인하세요.
- 앱에 Pushwoosh SDK가 통합되어 있습니다.
- 앱이 RudderStack이
userId로 보내는 값과 동일한 값으로setUserId를 호출합니다. Pushwoosh는 이 값으로 수신 이벤트와 트레이트를 사용자에게 연결합니다. - RudderStack이 사용자에 대한
identify호출을 보내기 전에 각 사용자의 디바이스가 이 User ID로 등록되어 있습니다. Pushwoosh가 아직 알지 못하는 User ID의 트레이트는 삭제됩니다. - API 토큰을 만들 수 있도록 Pushwoosh의 Settings → API Access에 액세스할 수 있습니다.
track또는identify호출을 보내는 소스가 하나 이상 있는 RudderStack workspace가 있습니다.
RudderStack에서 Pushwoosh destination 설정
Anchor link to설정은 두 부분으로 이루어집니다. Pushwoosh에서 두 가지 값을 가져온 다음 RudderStack에서 destination을 만듭니다.
애플리케이션 코드와 Device API token 가져오기
Anchor link toRudderStack이 애플리케이션으로 데이터를 보내려면 애플리케이션 코드와 Device API token, 이 두 가지 값이 필요합니다.
- Pushwoosh에서 데이터를 보낼 애플리케이션을 엽니다.
- 애플리케이션 코드를 복사합니다. 왼쪽 상단의 애플리케이션 이름 아래에 표시되며
XXXXX-XXXXX형식입니다. - Settings → API Access로 이동하여 Generate New Token을 클릭합니다.
- Token type에서
device를 선택합니다. - Name에 토큰 이름을 입력합니다(예:
RudderStack). - Generate를 클릭합니다.
- 토큰 목록에서 새 토큰 옆의 점 3개 메뉴를 클릭하고 **Edit token…**을 선택합니다.
- Applications에서 1단계의 애플리케이션을 선택하고 Save를 클릭합니다.
- 토큰 목록에서 토큰 값을 복사합니다.
destination에는 Device API token이면 충분합니다. Server API token은 필요하지 않습니다.
RudderStack에 destination 추가
Anchor link toPushwoosh destination은 RudderStack 소스를 Pushwoosh 애플리케이션에 연결합니다.
- RudderStack 대시보드에서 Collect → Destinations로 이동합니다.
- New destination을 클릭합니다.
- 목록에서 Pushwoosh를 선택합니다.
- destination 이름을 입력하고 Continue를 클릭합니다.
- Pushwoosh로 보낼 소스를 선택합니다.
- Application Code에 애플리케이션 코드를 붙여넣습니다.
- API Token에 Device API token을 붙여넣습니다.
- 설정을 완료하여 destination을 저장합니다.
RudderStack은 destination이 지원하는 모든 소스 유형에 대해 자체 서버에서 Pushwoosh로 데이터를 보냅니다(cloud mode).
RudderStack 측 설정은 RudderStack 문서의 Pushwoosh destination 가이드를 참조하세요.
RudderStack이 Pushwoosh로 보내는 데이터
Anchor link todestination은 track과 identify, 두 가지 호출 유형을 지원합니다. RudderStack은 이 destination에 대해 page, screen, group, alias 같은 다른 호출 유형을 모두 거부합니다.
모든 호출에는 userId가 있어야 합니다. Pushwoosh는 익명 호출을 사용자에게 귀속할 수 없으므로 RudderStack은 userId가 없는 호출을 보내지 않습니다.
Track 호출은 Pushwoosh 이벤트가 됩니다
Anchor link to각 track 호출은 RudderStack 이벤트와 같은 이름의 Pushwoosh 이벤트가 됩니다.
| RudderStack 필드 | Pushwoosh |
|---|---|
event | 이벤트 이름 |
properties | 이벤트 속성 |
userId | User ID |
timestamp(또는 originalTimestamp) | 이벤트 시간 |
context.device.id | Device ID(있는 경우) |
context.device.type 또는 context.os.name | 플랫폼: android, iOS·iPadOS·watchOS·tvOS는 ios, 그 외 값이거나 값이 없으면 web |
이벤트나 속성이 애플리케이션에 아직 없으면 Pushwoosh가 자동으로 만듭니다.
다음과 같은 경우 Pushwoosh는 이벤트 전체를 삭제합니다. 오류를 반환하지 않으므로 RudderStack은 해당 이벤트를 전달됨으로 보고합니다.
- 호출에 속성(properties)이 100개를 초과합니다.
- 속성 값이 10KB를 초과합니다.
- 이벤트 이름이 255자를 초과합니다.
- 새 이벤트이고 이름이 128자를 초과하거나 제어 문자를 포함합니다.
이벤트는 최대 100개의 속성을 유지합니다. 이벤트에 알려진 속성이 100개가 되면 Pushwoosh는 새 호출을 계속 기록하지만 새 속성 이름은 속성으로 추가되지 않습니다.
properties의 중첩 객체는 JSON 문자열로 전달되며, 값이 null인 속성은 삭제됩니다.
Identify 호출은 사용자별 태그가 됩니다
Anchor link to각 identify 호출은 해당 트레이트를 지정된 userId 사용자의 태그로 설정합니다. 트레이트는 traits에서 가져오며, traits가 비어 있으면 context.traits에서 가져옵니다.
- 사용자별 태그만 기록됩니다. 계정에 태그 자동 생성이 활성화되어 있으면 새 이름의 트레이트가 사용자별 태그를 만듭니다. 같은 이름의 General 태그가 이미 있으면 Pushwoosh는 오류 없이 해당 트레이트를 건너뜁니다.
- 값은 태그 유형과 일치해야 합니다. 태그가 이미 있고 트레이트 값이 해당 유형에 맞지 않으면(예: Integer 태그에 텍스트) Pushwoosh는 오류 없이 해당 트레이트를 건너뜁니다.
- 사용자가 Pushwoosh에 이미 있어야 합니다. 태그는 Pushwoosh SDK가
setUserId를 같은userId로 설정한 디바이스를 등록한 경우에만 적용됩니다. 알 수 없는 사용자의 트레이트는 오류 없이 삭제됩니다. - 신원 및 연락처 트레이트는 태그로 복사되지 않습니다.
email,phone,firstName,lastName,name,address,id,userId,anonymousId는 태그로 전송되지 않습니다. 이 트레이트만 있는identify호출은No traits left to send as Pushwoosh tags오류로 실패합니다. - 빈 값은 태그를 지웁니다. 빈 문자열이나 빈 목록이 있는 트레이트는 사용자의 해당 태그 현재 값을 삭제합니다.
- 중첩 객체는 JSON 문자열로 전달됩니다. 값이
null인 트레이트는 삭제됩니다.
destination이 하지 않는 작업
Anchor link todestination은 track 및 identify 데이터만 보냅니다. 다음 작업은 destination의 범위 밖입니다.
- 디바이스나 이메일 주소를 등록하지 않습니다. 디바이스는 Pushwoosh SDK에서 등록됩니다.
- 사용자를 삭제하지 않습니다. 이 destination에서는 RudderStack 사용자 삭제 요청이 지원되지 않습니다.
통합이 작동하는지 확인
Anchor link todestination을 저장한 후, Pushwoosh에 이미 디바이스가 있는 userId로 소스에서 테스트 track 호출과 identify 호출을 보냅니다.
- 이벤트: Pushwoosh에서 Audience → Events로 이동하여 이벤트를 열고 집계되었는지 확인합니다.
- 태그: Audience → User Explorer로 이동하여 User ID로 사용자를 찾고 태그 값을 확인합니다.
각 호출의 전달 오류는 RudderStack에서 해당 destination의 Live Events 보기에 표시됩니다.
문제 해결
Anchor link toLive Events에서 RudderStack이 destination에 대해 표시하는 오류 메시지를 찾아 원인과 해결 방법을 확인하세요.
Track 호출이 unauthorized로 실패함
Anchor link toAPI 토큰이 애플리케이션 코드와 일치하지 않습니다. 토큰이 애플리케이션과 같은 Pushwoosh 계정에 속하는지 확인하세요.
identify 호출은 토큰을 확인하지 않으므로 잘못된 토큰으로도 계속 성공합니다. 토큰을 테스트하려면 track 호출을 사용하세요.
호출이 application not found 또는 application code is not valid로 실패함
Anchor link to애플리케이션 코드가 잘못되었거나 계정이 app.pushwoosh.com에 호스팅되어 있지 않습니다. track 호출은 application not found로, identify 호출은 application code is not valid로 실패합니다. Pushwoosh Control Panel에서 코드를 확인하세요. 코드가 올바르다면 Customer Success Manager 또는 지원팀에 문의하세요.
호출이 Missing required value from userId로 실패함
Anchor link to호출에 userId가 없습니다. 익명 호출은 Pushwoosh로 전송되지 않습니다. 이후 호출에 userId가 포함되도록 사용자가 로그인한 후 RudderStack 소스에서 identify를 호출하세요.
호출이 Invalid enum value로 실패함
Anchor link to호출 유형이 track 또는 identify가 아닙니다. Pushwoosh는 이 두 유형만 허용합니다. page, screen, group, alias 호출만 보내는 소스를 연결하지 않거나 이 오류를 무시하세요.
Identify 호출이 No traits left to send as Pushwoosh tags로 실패함
Anchor link to호출의 모든 트레이트가 email이나 phone 같은 신원 또는 연락처 트레이트이며, 이는 태그로 복사되지 않습니다. 다른 트레이트를 하나 이상 추가하거나 호출을 건너뛰세요.
Identify 호출은 성공하지만 태그가 표시되지 않음
Anchor link to다음을 순서대로 확인하세요.
- 이 User ID를 가진 디바이스가 Pushwoosh에 등록되어 있습니다. Audience → User Explorer에서 사용자를 검색하세요.
- 앱이 RudderStack이
userId로 보내는 값과 정확히 같은 값으로setUserId를 호출합니다. - 이 이름의 태그가 User-specific입니다. 기존 General 태그에 대한 트레이트는 건너뜁니다. 태그 범위를 변경하거나 트레이트 이름을 바꾸세요.
- 트레이트 값이 기존 태그의 유형과 일치합니다.
- 트레이트가
email이나phone처럼 복사되지 않는 신원 또는 연락처 트레이트가 아닙니다.