OneSignal + Segment 통합을 통해 다음을 수행할 수 있습니다:
- Segment에서 OneSignal로 사용자 특성 및 이벤트를 보내 사용자 프로필을 강화하고 세그먼테이션을 강화하며 메시징을 트리거합니다.
- OneSignal에서 Segment로 메시지 전달 및 참여 이벤트를 보내 중앙 집중식 Analytics 및 데이터 웨어하우징을 수행합니다.
이 양방향 설정은 모든 주요 OneSignal 채널을 지원합니다: Push, In-App, Email 및 SMS.
요구 사항
1. OneSignal 설정
OneSignal 대시보드에서 기존 앱을 사용하거나 새 앱을 만듭니다. 그런 다음 선호하는 채널을 설정합니다:
2. Segment을 OneSignal에 연결
OneSignal 대시보드에서 Data > Integrations로 이동하고 Segment.com 카드 내에서 Active를 클릭합니다. 그런 다음 설정 옵션을 계속 진행합니다.
데이터 수신
OneSignal로의 “Data In”을 사용하면 Segment.com 계정에서 OneSignal로 OneSignal 세그먼트, 태그 및 사용자 지정 이벤트를 보낼 수 있습니다. OneSignal 대시보드의 Segment.com 설정 페이지의 Data In 섹션에서 Authenticate를 클릭합니다.
사용자 지정 이벤트는 현재 베타 버전입니다.
액세스를 요청하려면 다음 정보와 함께 support@onesignal.com에 문의하세요:
- 회사 이름
- OneSignal Organization ID
- 활성화하려는 앱 ID
사용자 지정 이벤트 추적을 활성화하면 Segment.com 통합에서 Data Tags 및 Events를 모두 보내므로 데이터 태그를 참조하는 기존 템플릿을 업데이트할 필요가 없습니다.
데이터 발신
Segment.com에 “Data Out”을 활성화하면 생성된 메시지 이벤트가 Segment.com 계정으로 다시 동기화됩니다. 이러한 메시지 이벤트는 OneSignal 플랫폼에서 사용자에게 메시지를 보낼 때 생성됩니다. 생성될 수 있는 이벤트 종류 및 전송되는 속성에 대한 자세한 내용은 아래에서 확인할 수 있습니다.
먼저 Segment.com 계정에서 OneSignal을 소스로 추가해야 합니다. Segment Connections Catalogue의 OneSignal Source 목록으로 이동하면 됩니다.
거기에서 OneSignal 대시보드에 Segment.com API 토큰을 추가할 수 있습니다. Segment API 키를 추가하려면 OneSignal 대시보드에서 Data > Integrations > Segment로 이동하세요.
API 키를 설정한 후 Segment.com의 Data Policy 설정을 확인하여 Segment의 EU Residency Endpoint로 이벤트를 보내야 하는지 확인하세요.
모든 설정이 완료되면 OneSignal에서 사용하는 채널에 따라 Segment 계정과 동기화할 이벤트를 선택할 수 있습니다.
3. Segment에 OneSignal 대상 추가
Segment.com Dashboard > Destinations 내에서 OneSignal이 표시되어야 합니다. 표시되지 않으면 OneSignal을 새 대상으로 추가합니다.
OneSignal Destination을 활성화하면 OneSignal API Key와 App ID도 이미 표시되어야 합니다.
API 키와 앱 ID가 설정되지 않은 경우 OneSignal 대시보드로 이동하여 앱을 선택하고 Settings > Keys & IDs로 이동합니다. “App ID”와 “API key”를 Segment.com에 복사하여 붙여넣습니다.
여러 소스가 있는 경우 Segment의 Personas > Spaces 기능을 사용하여 여러 소스를 대상에 바인딩할 수 있습니다.
4. Segment에서 OneSignal로 데이터 전송
OneSignal은 채널 수준 레코드를 저장합니다: Push/IAM, Email 및 SMS. 이러한 레코드는 이미 OneSignal에서 생성되어 있어야 하며 Segment.com에서 보낸 userID 필드와 일치하도록 OneSignal에서 External ID 별칭을 설정해야 합니다.
Segment User ID <—> OneSignal External ID 매핑이 없는 레코드는 삭제됩니다.
사용자 특성 또는 속성
Segment의 모든 고객 접점에서 데이터를 집계한 다음 이러한 사용자 속성을 실시간으로 Data Tags로 OneSignal에 보낼 수 있습니다.
참고: OneSignal은 중첩된 객체 또는 배열을 사용자 속성으로 허용할 수 없습니다.
Identify - Segment의 Identify 호출을 사용하여 전송된 사용자 특성 또는 속성은 OneSignal에 데이터 태그로 저장됩니다. 예시:
Track - Segment의 Track 호출을 사용하여 전송된 이벤트 및 관련 속성의 경우 OneSignal은 모든 이벤트 속성을 데이터 태그로 저장하지만 태그를 저장하는 동안 이벤트 이름은 삭제합니다. 이벤트 이름을 데이터 태그에 유지하려면 OneSignal로 보내기 전에 속성에 이벤트 이름을 추가할 수 있습니다. 예시:
let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convert to string since Segment adds decimals to end
//name will be dropped and only properties will be sent to OneSignal as tag "last opened: timestampInSeconds"
analytics.track(
name: "iOS App Last Opened",
properties: ["last opened": timestampInSeconds]
)
Personas Audience 및 Computed Traits
Persona Audiences는 자동으로 OneSignal의 세그먼트로 표시됩니다.
Computed traits는 OneSignal 사용자 레코드의 Data Tags로 업데이트됩니다.
Audience
Segment의 Track 호출을 사용하여 전송된 Audiences는 Audience Name으로 OneSignal 세그먼트를 생성합니다.
Segment의 Identify 호출을 사용하여 전송된 Audiences는
- Audience Name으로 OneSignal 세그먼트 생성
- 일치하는 모든 사용자 레코드에 데이터 태그 추가 (Identify 호출에 추가 속성이 있는 경우)
Identify 및 Track 호출은 사용자가 Audience에 들어가거나 나갈 때마다 OneSignal로 자동으로 전송됩니다.
Computed Traits Personas Computed Traits는 Identify 호출 또는 Track 호출로 OneSignal에 전달되는지 여부에 관계없이 OneSignal 사용자 레코드의 Data Tags로 저장됩니다. 그런 다음 이러한 데이터 태그를 사용하여 수동으로 OneSignal 세그먼트를 생성하고 메시징 워크플로를 자동화할 수 있습니다.
메시지 이벤트
이벤트 종류
OneSignal이 Segment로 보내는 메시지 이벤트 종류입니다
| MessageEvent Kind | 이벤트 설명 |
|---|
| Push Sent | 푸시 알림이 성공적으로 전송됨 |
| Push Received | 푸시 알림이 성공적으로 수신됨 |
| Push Clicked | 장치에서 푸시 알림을 터치함 |
| In-App Message Displayed | In-App Message가 장치에 성공적으로 표시됨 |
| In-App Message Clicked | 장치에서 In-App Message를 클릭함 |
| In-App Message Page Displayed | In-App Message 페이지가 표시됨 |
| Email Sent | Email이 성공적으로 전송됨 |
| Email Opened | 수신자가 Email을 열람함 |
| Email Unsubscribed | 수신자가 Email 구독을 취소함 |
| Email Received | 수신자가 Email을 수신함 |
| Email Reported As Spam | 수신자가 Email을 스팸으로 신고함 |
| Email Bounced | 영구적인 오류로 인해 Email이 발신자에게 반송됨 |
| Email Failed | 수신자의 받은 편지함에 Email을 전달할 수 없음 |
| SMS Sent | 수신자에게 SMS를 보냄 |
| SMS Delivered | SMS가 성공적으로 전달됨 |
| SMS Failed | SMS 전송 실패 |
이벤트 속성
OneSignal에서 Segment.com으로 전송된 이벤트에 있는 속성입니다
| PROPERTY NAME | 설명 |
|---|
userId | 메시지와 연결된 external_id |
anonymousId | subscription_id |
messageId | 개별 메시지의 식별자 |
campaign_id | messageId와 동일한 값 |
message_name | 메시지 이름 |
message_title | 메시지 제목 |
message_contents | 메시지 내용 |
| |
subscription_type | 메시지가 전송된 채널 |
template_id | 사용된 메시지 템플릿 |
subscription_id. | OneSignal에서 설정한 장치/Email/SMS 식별자 |
device_type | 메시지를 수신한 장치 유형 |
language | 장치의 2자 언어 코드 |
message_type | 전송된 메시지 유형, push, in-app, email, SMS |
자주 묻는 질문
구독 이벤트를 어떻게 전달할 수 있나요?
구독 이벤트는 현재 자동으로 전송되지 않습니다. OneSignal SDK Subscription Observer Methods로 수행할 수 있습니다. 자세한 내용은 Subscription Tracking을 참조하세요.
OneSignal에서 Segment의 예약된 및 사용자 지정 사용자 속성 관리
- 모든 Segment의 사용자 특성은 데이터 태그로 OneSignal로 전송됩니다. OneSignal에서 허용되는 데이터 태그 수는 OneSignal 가격 플랜에 따라 다릅니다. 권한이 부여된 수를 초과하는 태그는 삭제됩니다.
- OneSignal은 일치하는 사용자에 대해 항상 firstName 및 lastName 속성을 업데이트합니다. 다른 모든 특성은 선착순으로 추가/업데이트됩니다. firstName 및 lastName 태그는 “first_name” 및 “last_name”으로 저장됩니다.
- 빈/null 값이 있는 OneSignal로 전송된 사용자 속성은 OneSignal 사용자 레코드에서 제거됩니다. 이는 데이터 태그 제한 내에 있는지 확인하기 위해 수행됩니다.
