메인 콘텐츠로 건너뛰기

OneSignal Segment 통합 개요

​
개요

OneSignal + Segment 통합을 통해 다음을 수행할 수 있습니다:
  • Segment에서 OneSignal로 사용자 특성 및 이벤트를 보내 사용자 프로필을 강화하고 세그먼테이션을 강화하며 메시징을 트리거합니다.
  • OneSignal에서 Segment로 메시지 전달 및 참여 이벤트를 보내 중앙 집중식 Analytics 및 데이터 웨어하우징을 수행합니다.
이 양방향 설정은 모든 주요 OneSignal 채널을 지원합니다: Push, In-App, Email 및 SMS.

​
요구 사항

  • Growth, Professional 또는 Enterprise OneSignal 계정.
  • Segment 관리자 권한
  • 데이터를 보내려는 OneSignal Mobile SDK 및/또는 Web SDK. Email 또는 SMS 전용 통합은 SDK가 필요하지 않습니다.
  • Segment.com userId에 매핑되는 OneSignal 속성: External ID.

​
설정

​
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를 모두 보내므로 데이터 태그를 참조하는 기존 템플릿을 업데이트할 필요가 없습니다.

Data In 인증 설정

Authenticate를 클릭하면 Segment.com 웹 페이지가 열리고 Segment.com 계정에 로그인하라는 메시지가 표시됩니다. 그런 다음 Segment.com 계정에서 새 데이터 대상을 구성하라는 메시지가 표시됩니다.

Segment 설정 구성 화면

​
데이터 발신

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로 이동하세요.

Data Out API 키 구성

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도 이미 표시되어야 합니다.

Segment의 OneSignal 대상 구성

API 키와 앱 ID가 설정되지 않은 경우 OneSignal 대시보드로 이동하여 앱을 선택하고 Settings > Keys & IDs로 이동합니다. “App ID”와 “API key”를 Segment.com에 복사하여 붙여넣습니다.

​
여러 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에 데이터 태그로 저장됩니다. 예시:

사용자 identify 호출 예시

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]
)

Track 호출 속성 예시

사용자 특성 및 속성 인터페이스

​
Personas Audience 및 Computed Traits

Persona Audiences는 자동으로 OneSignal의 세그먼트로 표시됩니다. Computed traits는 OneSignal 사용자 레코드의 Data Tags로 업데이트됩니다. Audience

Persona audience 및 computed traits 인터페이스

Segment의 Track 호출을 사용하여 전송된 Audiences는 Audience Name으로 OneSignal 세그먼트를 생성합니다. Segment의 Identify 호출을 사용하여 전송된 Audiences는
  • Audience Name으로 OneSignal 세그먼트 생성
  • 일치하는 모든 사용자 레코드에 데이터 태그 추가 (Identify 호출에 추가 속성이 있는 경우)

Segment에서 OneSignal에 생성된 세그먼트

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 DisplayedIn-App Message가 장치에 성공적으로 표시됨
In-App Message Clicked장치에서 In-App Message를 클릭함
In-App Message Page DisplayedIn-App Message 페이지가 표시됨
Email SentEmail이 성공적으로 전송됨
Email Opened수신자가 Email을 열람함
Email Unsubscribed수신자가 Email 구독을 취소함
Email Received수신자가 Email을 수신함
Email Reported As Spam수신자가 Email을 스팸으로 신고함
Email Hardbounced영구적인 오류로 인해 Email이 발신자에게 반송됨
Email Failed수신자의 받은 편지함에 Email을 전달할 수 없음
SMS Sent수신자에게 SMS를 보냄
SMS DeliveredSMS가 성공적으로 전달됨
SMS FailedSMS 전송 실패

​
이벤트 속성

OneSignal에서 Segment.com으로 전송된 이벤트에 있는 속성입니다
PROPERTY NAME설명
userId메시지와 연결된 external_id
anonymousIdsubscription_id
messageId개별 메시지의 식별자
campaign_idmessageId와 동일한 값
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 사용자 레코드에서 제거됩니다. 이는 데이터 태그 제한 내에 있는지 확인하기 위해 수행됩니다.