Pushwoosh Mendix 모듈 액션

Mendix용 Pushwoosh 모듈은 두 곳에서 기능을 노출합니다: SDK를 시작하고 들어오는 알림을 나노플로우 이벤트로 전환하는 Pushwoosh 이벤트 위젯과, 네이티브 모바일 내비게이션 프로필의 모든 나노플로우에서 호출하는 JavaScript 액션입니다. 이 페이지에서는 두 가지 모두를 나열합니다.

Pushwoosh 이벤트 위젯 속성

이 위젯은 아무것도 렌더링하지 않습니다. 네이티브 모바일 내비게이션 프로필에서 가장 먼저 로드되는 페이지에 한 번만 배치하십시오. 이 위젯은 SDK를 초기화하고, 선택적으로 디바이스를 등록하며, 각 푸시 알림 이벤트에 대해 나노플로우를 트리거합니다.

Setup

이 속성들은 SDK를 시작하고 준비가 되면 보고합니다.

속성	기능
Application Code	앱의 Pushwoosh Application Code입니다. 예: XXXXX-XXXXX. 필수입니다.
Register on load	위젯이 로드되자마자 디바이스를 등록합니다. iOS에서는 시스템 권한 프롬프트가 표시되므로, 나중에 RegisterForPushNotifications 액션으로 요청하려면 이 옵션을 끄십시오.
On initialized	SDK가 시작되면 한 번 실행되는 나노플로우입니다.
On registered	디바이스에 푸시 토큰이 있을 때 실행되는 나노플로우입니다.
Push token	On registered가 실행되기 전에 푸시 토큰이 기록되는 문자열 속성입니다.

Push events

이 속성들은 들어오는 알림을 모델에 전달하고 나노플로우를 트리거합니다.

속성	기능
Payload	전체 알림 페이로드를 JSON으로 수신하는 문자열 속성입니다.
Message	알림 텍스트를 수신하는 문자열 속성입니다.
On push received	앱이 포그라운드에 있을 때 알림이 도착하면 실행되는 나노플로우입니다.
On push opened	사용자가 알림을 탭할 때 실행되는 나노플로우입니다.

Deep links

이 속성들은 앱의 특정 페이지로 연결되는 링크를 포함한 알림을 처리합니다.

속성	기능
Deep link	알림에서 딥 링크 URL을 수신하는 문자열 속성입니다.
On deep link	열린 알림에 링크가 포함되어 있을 때 실행되는 나노플로우입니다. On push opened 외에 추가로 실행됩니다.

속성들은 나노플로우가 실행되기 전에 채워지므로, 나노플로우는 즉시 해당 값을 읽을 수 있습니다.

Setup actions

위젯을 사용하는 대신 직접 SDK를 시작할 때 이 액션들을 사용하십시오.

Initialize

Pushwoosh SDK를 초기화합니다. 다른 Pushwoosh 액션보다 먼저, 일반적으로 홈 페이지의 로드 시 나노플로우에서 한 번 호출하십시오. 페이지에 Pushwoosh 이벤트 위젯이 있는 경우에는 위젯이 직접 SDK를 초기화하므로 이 액션이 필요하지 않습니다.

Android에서는 FCM Sender ID가 네이티브 빌드에서 가져오는 google-services.json에서 옵니다. 이 액션에는 전달되지 않습니다.

파라미터	타입	설명
applicationCode	String	Pushwoosh Application Code입니다. 예: XXXXX-XXXXX. 필수입니다.
notificationHandling	String	선택 사항. default 또는 manual. 기본 동작을 원하시면 비워두십시오.

SDK가 시작되면 true인 Boolean 값을 반환합니다.

Registration actions

이 액션들은 이 디바이스가 알림을 받을지 여부를 제어하고, 디바이스를 주소 지정하는 식별자를 노출합니다.

RegisterForPushNotifications

디바이스를 푸시 알림에 등록하고 푸시 토큰을 반환합니다. iOS에서는 시스템 권한 프롬프트가 트리거되므로, 사용자에게 요청하는 것이 합리적인 흐름의 지점에서 호출하십시오.

푸시 토큰이 포함된 String을 반환합니다.

UnregisterForPushNotifications

디바이스를 등록 해제합니다. RegisterForPushNotifications가 다시 호출될 때까지 알림 수신을 중단합니다.

디바이스가 등록 해제된 토큰이 포함된 String을 반환합니다.

GetPushToken

현재 푸시 토큰을 반환하거나, 디바이스가 아직 등록되지 않은 경우 빈 문자열을 반환합니다.

String을 반환합니다.

GetHwid

Pushwoosh가 디바이스를 주소 지정하는 식별자인 디바이스의 HWID를 반환합니다. Pushwoosh Control Panel이나 서버 API에서 단일 디바이스를 타겟팅하는 데 사용하십시오.

String을 반환합니다.

User identity actions

이 액션들은 디바이스를 사람과 연결하여, 한 사람이 사용하는 모든 디바이스에 하나의 메시지가 도달하도록 합니다.

SetUserId

디바이스를 사용자와 연결합니다. 로그인 후에 호출하십시오.

파라미터	타입	설명
userId	String	사용자에 대한 고유 식별자입니다. 필수입니다.

Boolean 값을 반환합니다.

GetUserId

현재 디바이스와 연결된 사용자 ID를 반환하거나, 설정된 ID가 없으면 빈 문자열을 반환합니다.

String을 반환합니다.

SetEmails

사용자의 이메일 주소를 Pushwoosh에 등록하여, 푸시뿐만 아니라 이메일로도 연락할 수 있도록 합니다.

파라미터	타입	설명
emails	String	하나의 주소 또는 쉼표로 구분된 여러 주소. 필수입니다.

Boolean 값을 반환합니다.

Tag actions

태그는 Pushwoosh Control Panel에서 세그먼트를 구성하는 데 사용되는 디바이스 속성입니다.

SetTags

디바이스에 태그를 설정합니다.

파라미터	타입	설명
tagsJson	String	JSON 객체입니다. 예: {"Language":"en","Level":7,"Premium":true}. 필수입니다.

Boolean 값을 반환합니다.

Mendix 표현식의 따옴표

Mendix 표현식의 문자열은 작은따옴표로 작성되므로, 그 안의 JSON은 큰따옴표를 이스케이프하지 않고 유지합니다: '{"Language":"en"}'. 표현식 내에 "" 또는 \"를 작성하면 액션이 파싱할 수 없는 문자열이 생성됩니다.

GetTags

현재 디바이스에 설정된 태그를 JSON 문자열로 반환합니다.

String을 반환합니다.

Event actions

이벤트는 트리거된 캠페인과 인앱 메시지를 시작하는 데 사용됩니다.

PostEvent

Pushwoosh에 이벤트를 게시합니다.

파라미터	타입	설명
eventName	String	Control Panel에서 구성된 이벤트 이름입니다. 필수입니다.
attributesJson	String	선택 사항. 이벤트 속성의 JSON 객체입니다.

Boolean 값을 반환합니다.

기본 SDK 호출은 성공 또는 실패를 보고하지 않으므로, 호출이 SDK에 전달되는 즉시 액션은 true를 반환합니다.

Local notification actions

로컬 알림은 앱 자체에서 생성되며 네트워크가 필요 없어 리마인더에 적합합니다.

ScheduleLocalNotification

디바이스에 로컬 알림을 예약합니다.

파라미터	타입	설명
message	String	알림 텍스트입니다. 필수입니다.
afterSeconds	Integer/Long	알림을 표시하기 전까지 대기할 시간(초)입니다. 필수이며, 0 이상이어야 합니다.
customDataJson	String	선택 사항. 알림과 함께 다시 전달되는 JSON 객체입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다. SDK는 알림이 실제로 예약되었는지 여부를 보고하지 않습니다.

ClearLocalNotifications

예약되었지만 아직 실행되지 않은 로컬 알림을 취소합니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

ClearNotificationCenter

알림 센터에서 앱의 이미 전달된 알림을 제거합니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

Privacy actions

이 액션들은 앱의 동의 토글을 지원하며, 디바이스에 대한 모든 Pushwoosh 메시징을 켜거나 끕니다.

IsCommunicationEnabled

디바이스가 현재 Pushwoosh로부터 통신을 받을 수 있는지 여부를 알려줍니다. 개인 정보 보호 토글의 상태를 렌더링하는 데 사용하십시오.

Boolean 값을 반환합니다.

SetCommunicationEnabled

디바이스에 대한 Pushwoosh와의 통신을 켜거나 끕니다. 이 기능을 끄면 모든 메시징이 중단되므로, “연락하지 마세요” 토글에 연결할 액션입니다.

파라미터	타입	설명
enabled	Boolean	메시징을 허용하려면 true, 중단하려면 false. 필수입니다.

Boolean 값을 반환합니다.

Settings actions

이 액션들은 이 디바이스에 대한 SDK의 동작 방식을 변경합니다.

SetLanguage

Pushwoosh가 디바이스에 대한 메시지를 현지화하는 데 사용하는 언어를 재정의합니다. 기본적으로 디바이스 언어가 사용됩니다.

파라미터	타입	설명
language	String	en, de, nl과 같은 두 글자 코드. 필수입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

SetReverseProxy

모든 Pushwoosh 트래픽을 자체 엔드포인트를 통해 라우팅합니다. Initialize 전에 호출하십시오. 그렇지 않으면 초기 요청이 여전히 Pushwoosh로 직접 전송됩니다.

파라미터	타입	설명
url	String	프록시 기본 URL. 필수입니다.
headersJson	String	선택 사항. 추가 HTTP 헤더의 JSON 객체입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

SetShowForegroundAlert

앱이 열려 있는 동안 도착하는 알림이 시스템 경고로 표시될지 여부를 제어합니다. 기본값은 켜져 있으므로, 위젯의 On push received 이벤트를 통해 포그라운드 알림을 직접 처리하려면 이 옵션을 끄십시오.

파라미터	타입	설명
showAlert	Boolean	시스템 경고를 표시하려면 true. 필수입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

iOS 전용

Android SDK는 이 설정을 노출하지 않으며, Android에서 이 액션을 호출하면 오류가 발생합니다. iOS에서만 호출하십시오.

GetShowForegroundAlert

앱이 열려 있는 동안 도착하는 알림이 시스템 경고로 표시될지 여부를 알려줍니다. 기본적으로 켜져 있습니다.

Boolean 값을 반환합니다.

iOS 전용

Android SDK는 이 설정을 노출하지 않으며, Android에서 이 액션을 호출하면 오류가 발생합니다. iOS에서만 호출하십시오.

Other channel actions

이 액션들은 Pushwoosh가 푸시 외에 지원하는 메시징 채널에 사용자를 등록합니다.

RegisterSmsNumber

사용자의 전화번호를 등록하여 Pushwoosh가 SMS를 통해 연락할 수 있도록 합니다.

파라미터	타입	설명
phoneNumber	String	국제 형식으로, 예: +31201234567. 필수입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.

RegisterWhatsappNumber

사용자의 전화번호를 등록하여 Pushwoosh가 WhatsApp을 통해 연락할 수 있도록 합니다.

파라미터	타입	설명
phoneNumber	String	국제 형식으로, 예: +31201234567. 필수입니다.

호출이 SDK에 전달되는 즉시 Boolean 값을 반환합니다.