메인 콘텐츠로 건너뛰기

​
개요

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

​
요구 사항

​
MySQL

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

​
설정

1

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 문을 반복하세요.
2

OneSignal 연결 구성

OneSignal에서 Data > Integrations으로 이동하여 Add Integration을 클릭합니다.MySQL을 선택하고 연결 세부 정보를 제공하세요:
  • Host: MySQL 서버 호스트 이름
  • Port: MySQL 포트(일반적으로 3306)
  • Database: 이벤트 테이블이 포함된 데이터베이스 이름
  • Username: CENSUS
  • Password: 위에서 생성한 비밀번호
3

연결 테스트

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

​
이벤트 데이터 매핑

를 OneSignal의 사용자 지정 이벤트 형식에 매핑합니다:
OneSignal 필드설명필수
nameevent_name이벤트 식별자Yes
external_iduser_id사용자 식별자Yes
timestampevent_timestamp이벤트가 발생한 시간No
propertiesevent_dataNo

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

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 허용 목록을 지원합니다.