MySQL

개요

OneSignal + MySQL 통합은 MySQL 데이터베이스에서 OneSignal로 Custom Event를 동기화하여 사용자 행동을 기반으로 자동화된 메시징 캠페인 및 Journey를 트리거할 수 있게 합니다. MySQL은 개인화된 메시징 캠페인을 지원할 수 있는 구조화된 이벤트 데이터를 저장하는 데 이상적인 널리 사용되는 오픈 소스 관계형 데이터베이스 관리 시스템입니다.

요구 사항

Access to Event Streams for outbound message events (Plan limitations and overages apply)
Access to Custom Events for inbound event syncing (Plan limitations and overages apply)
Updated Account Plan (not available on free apps)

MySQL Community 5.7 이상 또는 MariaDB의 최신 버전
구조화된 행동 데이터가 포함된 이벤트 테이블
OneSignal에서 MySQL 인스턴스로의 네트워크 연결
TLS v1.2 이상 지원

설정

OneSignal 전용 사용자 생성

읽기 전용 권한을 가진 전용 사용자 계정을 생성하세요:

-- Create census user with ability to sign in with a password
CREATE USER CENSUS IDENTIFIED BY '<strong, unique password>';

-- Grant read-only access to your event schema
GRANT SELECT ON <your_schema>.* TO CENSUS;

이벤트 데이터가 포함된 스키마가 여러 개 있는 경우 각 스키마에 대해 GRANT SELECT 문을 반복하세요.

OneSignal 연결 구성

OneSignal에서 Data > Integrations으로 이동하여 Add Integration을 클릭합니다.MySQL을 선택하고 연결 세부 정보를 제공하세요:

Host: MySQL 서버 호스트 이름
Port: MySQL 포트(일반적으로 3306)
Database: 이벤트 테이블이 포함된 데이터베이스 이름
Username: CENSUS
Password: 위에서 생성한 비밀번호

연결 테스트

Test Connection을 클릭하여 OneSignal이 MySQL 데이터베이스에 성공적으로 연결하고 이벤트 테이블에 액세스할 수 있는지 확인하세요.

이벤트 데이터 매핑

를 OneSignal의 사용자 지정 이벤트 형식에 매핑합니다:

OneSignal 필드	설명	필수
`name`	`event_name`	이벤트 식별자	Yes
`external_id`	`user_id`	사용자 식별자	Yes
`timestamp`	`event_timestamp`	이벤트가 발생한 시간	No
`properties`	`event_data`	No

Sync Key는 동기화 중 각 행의 고유 식별자로 지정하는 열입니다. OneSignal은 이를 사용하여 행이 이미 처리되었는지 감지하므로, 데이터를 다시 동기화해도 중복 이벤트가 생성되지 않습니다. 행마다 고유한 텍스트 값을 가진 열을 선택하세요. 불리언 값이나 여러 행에서 반복되는 값은 사용하지 마세요.

예제 이벤트 테이블 스키마

CREATE TABLE user_events (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

Table 모드

이벤트 테이블을 직접 선택하면 OneSignal이 모든 행을 개별 이벤트로 동기화합니다.

SQL Query 모드

사용자 지정 SQL 쿼리를 작성하여 이벤트 데이터를 변환하세요:

-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    created_at as timestamp,
    event_data as payload
FROM user_events
WHERE created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT(event_data, '$.value') > 100
ORDER BY created_at DESC;

고급 네트워크 구성

OneSignal은 지역 제약 조건, IP 주소 허용 목록 또는 SSH Tunneling을 포함한 고급 네트워킹 제어를 사용하여 MySQL 인스턴스에 성공적으로 연결할 수 있습니다. OneSignal은 보안 연결을 위해 TLS 버전 1.2 이상의 MySQL을 지원합니다.

FAQ

어떤 MySQL 버전이 지원되나요?

OneSignal은 MySQL Community 5.7 이상 및 MariaDB의 최신 버전을 지원합니다.

프라이빗 네트워크에서 MySQL에 연결할 수 있나요?

예, OneSignal은 프라이빗 네트워크 또는 방화벽 뒤에 있는 MySQL 인스턴스에 연결하기 위해 SSH 터널링 및 IP 허용 목록을 지원합니다.

시작하기 & 설정

메시지 채널

Journeys

오디언스 & 사용자 지정 이벤트

분석 & 통합

개인 정보 보호 & 보안

MySQL

개요

요구 사항

MySQL

설정

이벤트 데이터 매핑

예제 이벤트 테이블 스키마

Table 모드

SQL Query 모드

고급 네트워크 구성

FAQ

어떤 MySQL 버전이 지원되나요?

프라이빗 네트워크에서 MySQL에 연결할 수 있나요?

​개요

​요구 사항

​MySQL

​설정

​이벤트 데이터 매핑

​예제 이벤트 테이블 스키마

​Table 모드

​SQL Query 모드

​고급 네트워크 구성

​FAQ

​어떤 MySQL 버전이 지원되나요?

​프라이빗 네트워크에서 MySQL에 연결할 수 있나요?

개요

요구 사항

MySQL

설정

이벤트 데이터 매핑

예제 이벤트 테이블 스키마

Table 모드

SQL Query 모드

고급 네트워크 구성

FAQ

어떤 MySQL 버전이 지원되나요?

프라이빗 네트워크에서 MySQL에 연결할 수 있나요?