메인 콘텐츠로 건너뛰기
Liquid 구문 사용을 통해 이벤트 스트림 데이터에 액세스합니다. 원하는 데이터 포인트를 {{ }}로 감싸서 이벤트 스트림에서 해당 데이터를 캡처합니다. 예시를 참조하세요.
메시지 이벤트 데이터 제한Journeys 또는 API를 통해 전송된 메시지에 대한 데이터는 시스템에서 30일 동안만 사용할 수 있습니다. 즉, Journey 또는 API 메시지가 전송된 후 30일 이상 경과한 메시지 이벤트(클릭, 열람, 구독 취소 등)는 이벤트 스트림에서 사용할 수 없습니다. 이는 분석에서 빈 데이터 또는 누락된 데이터로 나타날 수 있습니다.이 제한을 해결하려면 클릭/열람/구독 취소 이벤트의 message_id를 동일한 message_id를 가진 원래 전송 이벤트와 연관시킬 수 있습니다. 원래 sent 이벤트에는 관련 메시지 데이터(제목, 템플릿 등)가 있어야 합니다.

​
event 속성

event 객체에는 다음 속성이 포함됩니다:

​
Kind

타입: String 메시지 유형(push, email, sms, iam)과 이벤트(예: received, sent, clicked, failed, unsubscribed, displayed, pagedisplayed, opened, clicked, unsubscribed, reported_as_spam, hardbounced, failed, supressed). 사용법: {{ event.kind }}
메시지 이벤트 종류 (OneSignal)이벤트 이름 (데이터 세트)이벤트 설명
Push Sentmessage.push.sent푸시 알림이 푸시 서비스(FCM, APNS 등)로 성공적으로 전송되었습니다.
Push Receivedmessage.push.received수신자가 푸시 알림을 받았습니다. 모든 플랫폼에서 사용할 수 없습니다. 자세한 내용은 확인된 전달을 참조하세요.
Push Clickedmessage.push.clicked사용자가 푸시 알림을 탭하여 기기에서 앱을 열었습니다.
Push Failedmessage.push.failed푸시 전송에 실패했습니다. 자세한 내용은 푸시 메시지 리포트를 참조하세요.
Push Unsubscribedmessage.push.unsubscribed사용자가 푸시 구독을 취소했습니다. 푸시 구독 상태는 언제 업데이트되나요?를 참조하세요.
In-App Impressionmessage.iam.displayed인앱 메시지가 기기에 성공적으로 표시되었습니다.
In-App Clickedmessage.iam.clicked사용자가 인앱 메시지의 요소를 탭했습니다.
In-App Page Displayedmessage.iam.pagedisplayed인앱 메시지 페이지가 표시되었습니다. 캐러셀 추적에 유용합니다.
Email Sentmessage.email.sent이메일이 성공적으로 전송되었습니다.
Email Receivedmessage.email.received수신자가 이메일을 받았습니다.
Email Openedmessage.email.opened수신자가 이메일을 열었습니다. 자세한 내용은 이메일 메시지 리포트를 참조하세요.
Email Link Clickedmessage.email.clicked사용자가 이메일의 링크를 탭했습니다.
Email Unsubscribedmessage.email.unsubscribed사용자가 구독 취소 링크를 통해 이메일 구독을 취소했습니다.
Email Reported As Spammessage.email.reported_as_spam사용자가 이메일을 스팸으로 신고했습니다. Gmail은 추적을 위해 Google Postmaster Tools가 필요합니다. 자세한 내용은 이메일 전달성을 참조하세요.
Email Bouncedmessage.email.hardbounced영구 오류로 인해 이메일이 발신자에게 반송되었습니다. 자세한 내용은 이메일 메시지 리포트를 참조하세요.
Email Failedmessage.email.failed이메일을 전달할 수 없습니다. 자세한 내용은 이메일 메시지 리포트를 참조하세요.
Email Suppressedmessage.email.supressed이메일 주소가 차단 목록에 있기 때문에 이메일을 전송할 수 없습니다.
SMS Sentmessage.sms.sentSMS가 수신자에게 전송되었습니다
SMS Failedmessage.sms.failedSMS 전송에 실패했습니다. 자세한 내용은 SMS 메시지 리포트를 참조하세요.
SMS Deliveredmessage.sms.deliveredSMS가 성공적으로 전달되었습니다
SMS Undeliveredmessage.sms.undeliveredSMS를 전송할 수 없습니다. 자세한 내용은 SMS 메시지 리포트를 참조하세요.

​
Event ID

타입: UUID UUID v4 형식의 각 개별 이벤트에 대한 고유한 OneSignal 생성 식별자입니다. 멱등성 전달 추적에 이 ID를 사용하세요. 특정 메시지 또는 템플릿 식별자를 찾고 있다면 message.id 또는 message.template_id를 사용하세요. 사용법: {{ event.id }}

​
Timestamp

타입: Integer 이벤트의 UNIX 타임스탬프입니다. 사용법: {{ event.timestamp }}

​
UTC datetime

타입: String UTC로 표시된 이벤트의 사람이 읽을 수 있는 시간(특히 “2024-02-21T23:45:15.228Z”와 같은 ISO 문자열)입니다. 사용법: {{ event.datetime }}

​
App ID

타입: UUID OneSignal App ID입니다. 사용법: {{ event.app_id }}

​
Subscription type

타입: String 구독 유형(예: iOS, Android, Chrome, Email, SMS 등)입니다. 사용법: {{ event.subscription_device_type }}

​
Subscription ID

타입: UUID OneSignal Subscription ID입니다. 사용법: {{ event.subscription_id }}

​
OneSignal User ID

타입: UUID OneSignal이 생성한 User ID입니다. 사용법: {{ event.onesignal_id }}

​
External User ID

타입: String OneSignal External ID 별칭으로 설정된 사용자 ID입니다. OneSignal에서 설정되지 않은 경우 비어 있을 수 있습니다. 사용법: {{ event.external_id }}

​
In-app message page name

타입: String 특정 인앱 메시지 이벤트에 대해 표시되는 페이지 또는 카드의 이름입니다. 자세한 내용은 인앱 메시지 이벤트 스트림을 참조하세요. 사용법: {{ event.data.page_name }}

​
In-app message page ID

타입: String 특정 인앱 메시지 이벤트에 대해 표시되는 페이지 또는 카드의 고유 식별자입니다. 자세한 내용은 인앱 메시지 이벤트 스트림을 참조하세요. 사용법: {{ event.data.page_id }}

​
In-app message target name

타입: String 클릭한 버튼 또는 이미지 블록 요소의 이름입니다. 인앱 클릭 작업을 포함해야 합니다. 자세한 내용은 인앱 메시지 이벤트 스트림을 참조하세요. 사용법: {{ event.data.target_name }}

​
In-app message target ID

타입: String 클릭한 버튼 또는 이미지 블록 요소의 고유 식별자입니다. 인앱 클릭 작업을 포함해야 합니다. 자세한 내용은 인앱 메시지 이벤트 스트림을 참조하세요. 사용법: {{ event.data.target_id }}

​
입력 예시

{
  "event.kind": "{{ event.kind }}",
  "event.id": "{{ event.id }}",
  "event.timestamp": "{{ event.timestamp }}",
  "event.datetime": "{{ event.datetime }}",
  "event.app_id": "{{ event.app_id }}",
  "event.subscription_device_type": "{{ event.subscription_device_type }}",
  "event.subscription_id": "{{ event.subscription_id }}",
  "event.onesignal_id": "{{ event.onesignal_id }}",
  "event.external_id": "{{ event.external_id }}",
  "event.data.page_name": "{{ event.data.page_name}}",
  "event.data.page_id": "{{ event.data.page_id}}",
  "event.data.target_name": "{{ event.data.target_name}}",
  "event.data.target_id": "{{ event.data.target_id}}"
}

​
메시지 속성

message 객체는 최종 사용자에게 전송된 메시지에 대한 정보를 제공하도록 설계되었습니다. 여기에는 메시지의 실제 텍스트가 포함된 id, template_id, content와 같은 속성이 포함됩니다.

​
Message ID

타입: UUID OneSignal에서 생성한 메시지 ID입니다. 사용법: {{ message.id }}

​
Message Name

타입: String 대시보드에서 설정하거나 API name 속성을 사용하여 설정한 메시지 이름입니다. 사용법: {{ message.name }}

​
Message Title

타입: Object 대시보드에서 설정하거나 API headings 또는 email_subject 속성을 사용하여 설정한 푸시 메시지 제목 또는 이메일 제목입니다. 사용법: {{ message.title }}

​
Message Contents

타입: Object 대시보드에서 설정하거나 API contents 속성을 사용하여 설정한 푸시 또는 SMS 메시지의 내용입니다(50자로 잘림). 이메일 내용(email_body)은 제공되지 않습니다. 사용법: {{ message.contents }}

​
Template ID

타입: UUID Journeys 또는 API template_id 속성을 통해 전송된 메시지의 템플릿 ID입니다. 사용법: {{ message.template_id }}

​
Launch URL

타입: String 메시지의 실행 URL(웹 및 앱에 구애받지 않는 하나의 URL만 사용하는 경우)입니다. 자세한 내용은 URL, 링크 및 딥링크를 참조하세요. 사용법: {{ message.url }}

​
App-Specific URL

타입: String 웹 및 앱별 URL을 모두 사용하는 경우 메시지의 실행 URL입니다. 자세한 내용은 URL, 링크 및 딥링크를 참조하세요. 사용법: {{ message.app_url }}

​
Web-Specific URL

타입: String 웹 및 앱별 URL을 모두 사용하는 경우 메시지의 실행 URL입니다. 자세한 내용은 URL, 링크 및 딥링크를 참조하세요. 사용법: {{ message.web_url }}

​
메시지 객체 예시

{
  "message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
  "message.name": "the-name-you-set",
  "message.title": "Claim 50% Off Today", // email subject example
  "message.title": "{'en':'the message title/headings'}", // push title example
  "message.contents": "{'en':'the message content'}",
  "message.template_id": "the-template-uuid-if-set",
  "message.url": "the-message-url",
  "message.app_url": "the-message-app-url",
  "message.web_url": "the-message-web-url"
}

​
사용자 속성

​
OneSignal ID

타입: String 사용자의 OneSignal ID입니다. 사용법 {{ user.onesignal_id }}

​
External ID

타입: String 사용자의 External ID입니다. 사용법: {{ user.external_id }}

​
Tags

타입: Object 사용자의 태그입니다. 사용법:
  • Tags 객체: {{ user.tags }}
  • 특정 태그 문자열: {{ user.tags.your_tag }}
  • 모든 태그를 가져오려는 경우 {{ user.tags}}와 같이 태그 객체를 참조하세요.
  • 특정 태그를 가져오려는 경우 "{{ user.tags.your_tag | default: '' }}"와 같이 태그를 문자열로 참조하세요.

​
Language

타입: String 사용자의 언어입니다. 사용법: {{ user.language }}

​
구독 속성

​
Subscription ID

타입: String 메시지가 전송된 구독의 ID입니다. 사용법: {{ user.subscription.id }}

​
App ID

타입: String 앱의 ID입니다. 사용법: {{ user.subscription.app_id }}

​
Subscription Token

타입: String 메시지가 전송된 구독의 토큰입니다.
  • 유형이 Email인 경우 토큰은 이메일 주소입니다.
  • 유형이 SMS인 경우 토큰은 E.164 형식의 전화번호입니다.
  • 유형이 Push 옵션 중 하나인 경우 토큰은 푸시 토큰입니다.
사용법: {{ user.subscription.subscription_token }}

​
Session Count

타입: Number 메시지가 전송된 구독의 세션 수입니다. 사용법: {{ user.subscription.session_count }}

​
Language

타입: String 메시지가 전송된 구독에 설정된 언어입니다. 사용법: {{ user.subscription.language }}

​
Game Version

타입: String 메시지가 전송된 구독에 설정된 게임 버전입니다. 사용법: {{ user.subscription.game_version }}

​
Last Active

타입: Number 메시지가 전송된 구독에 설정된 마지막 활성 시간입니다. 사용법: {{ user.subscription.last_active }}

​
Play Time

타입: Number 메시지가 전송된 구독에 설정된 플레이 시간입니다. 사용법: {{ user.subscription.play_time }}

​
Amount Spent

타입: Number 메시지가 전송된 구독에서 지출한 금액입니다. 사용법: {{ user.subscription.amount_spent }}

​
Created At

타입: Number 메시지가 전송된 구독의 생성 시간입니다. 사용법: {{ user.subscription.created_at }}

​
Subscribed

타입: Boolean 메시지가 전송된 구독이 현재 구독 중인지 여부를 나타냅니다. 사용법: {{ user.subscription.subscribed }}

​
SDK

타입: String 메시지가 전송된 구독에 설정된 SDK 버전입니다. 사용법: {{ user.subscription.sdk }}

​
Device Model

타입: String 메시지가 전송된 구독에 설정된 기기 모델입니다. 사용법: {{ user.subscription.device_model }}

​
Device OS

타입: String 메시지가 전송된 구독에 설정된 기기 운영 체제입니다. 사용법: {{ user.subscription.device_os }}

​
Tags

타입: Object 사용자의 태그입니다. 전체 객체 또는 특정 태그에 액세스할 수 있습니다. 사용법:
  • 모든 태그: {{ user.tags }}
  • 특정 태그: {{ user.tags.your_tag }}