메인 콘텐츠로 건너뛰기

​
개요

OneSignal + Google AlloyDB 통합은 AlloyDB 데이터베이스에서 OneSignal의 Custom Events API로 사용자 지정 이벤트를 자동으로 동기화할 수 있습니다. 이를 통해 데이터베이스에 저장된 실제 사용자 행동을 기반으로 자동화된 Journeys 및 개인화된 메시징 캠페인을 트리거할 수 있습니다. 구매, 제품 보기, 구독 변경 또는 모든 사용자 지정 사용자 작업과 같은 이벤트를 동기화하여 푸시 알림, 이메일, 인앱 메시지 및 SMS를 통해 온보딩 시퀀스, 재참여 캠페인, 트랜잭션 메시지 및 타겟팅된 프로모션을 자동으로 트리거할 수 있습니다.

​
요구 사항

​
Google AlloyDB

  • AlloyDB 인스턴스가 있는 Google Cloud Platform 계정
  • Google Cloud에서 요구하는 대로 구성된 Auth Proxy
  • 사용자를 생성하고 액세스 권한을 부여하기 위한 데이터베이스 권한
  • AlloyDB 인스턴스에 대한 네트워크 액세스

​
설정

​
AlloyDB 권한 구성

OneSignal은 AlloyDB 데이터베이스에서 이벤트 데이터를 읽어야 합니다. 이벤트 테이블에 대한 읽기 전용 액세스 권한이 있는 전용 ONESIGNAL 사용자 계정을 생성하는 것이 좋습니다.
1

OneSignal 데이터베이스 사용자 생성

강력하고 고유한 비밀번호로 전용 사용자 계정을 생성합니다:
-- Create the OneSignal user
CREATE USER ONESIGNAL WITH PASSWORD '<strong, unique password>';
2

스키마 액세스 권한 부여

OneSignal 사용자에게 이벤트 데이터 스키마에서 읽을 수 있는 액세스 권한을 부여합니다:
-- Let the OneSignal user see your event schema
GRANT USAGE ON SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user read all existing tables in this schema
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user read any new tables added to this schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT SELECT ON TABLES TO ONESIGNAL;
<your_event_schema>를 이벤트 테이블이 포함된 실제 스키마로 바꾸세요.
3

함수 권한 부여(필요한 경우)

이벤트 데이터에 저장 프로시저 또는 함수를 사용하는 경우:
-- Let the OneSignal user execute functions in this schema
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Let the OneSignal user execute any new functions added to this schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
Auth Proxy 설정

1

Auth Proxy 구성

AlloyDB는 타사 연결을 위해 Auth Proxy가 필요합니다. 이를 설정하려면 Google의 Auth Proxy 문서를 따르세요.
Auth Proxy가 필요합니다. OneSignal은 이것 없이 AlloyDB에 직접 연결할 수 없습니다.
2

연결 세부 정보 기록

다음 연결 정보를 저장합니다:
  • Host: Auth Proxy 엔드포인트
  • Port: Auth Proxy 포트(일반적으로 5432)
  • Database: AlloyDB 데이터베이스 이름
  • Username: ONESIGNAL(위에서 생성됨)
  • Password: 설정한 비밀번호

​
OneSignal AlloyDB 연결 구성

1

통합으로 이동

OneSignal에서 Data > Integrations으로 이동하여 Add Integration을 클릭합니다.
2

Google AlloyDB 선택

사용 가능한 통합 목록에서 Google AlloyDB를 선택합니다.
3

연결 세부 정보 입력

AlloyDB 연결 정보를 제공합니다:
  • Host: Auth Proxy 엔드포인트
  • Port: Auth Proxy 포트
  • Database: AlloyDB 데이터베이스 이름
  • Username: ONESIGNAL
  • Password: 사용자 비밀번호
  • SSL: 활성화됨(권장)
4

연결 테스트

연결 테스트를 클릭하여 OneSignal이 AlloyDB 인스턴스에 액세스할 수 있는지 확인합니다.

​
이벤트 데이터 매핑

연결되면 AlloyDB 테이블 열을 OneSignal 사용자 지정 이벤트 필드에 매핑해야 합니다:
1

이벤트 테이블 선택

OneSignal과 동기화하려는 이벤트 데이터가 포함된 테이블을 선택합니다.
2

필수 이벤트 필드 매핑

사용자 지정 이벤트에 필요한 필드를 매핑합니다:
  • Event Name: 이벤트 유형이 포함된 열(예: “purchase”, “signup”)
  • User Identifier: External User ID, 이메일 또는 전화번호 열
  • Event Timestamp: 이벤트가 발생한 시간(선택 사항)
3

이벤트 페이로드 데이터 매핑

추가 열을 이벤트 페이로드 속성에 매핑합니다:
  • 사용자 지정 이벤트 속성(product_id, price, category 등)
  • 컨텍스트 데이터(source, campaign 등)
  • 행동 지표(value, quantity 등)
4

동기화 설정 구성

이벤트 처리 빈도 및 전달 기본 설정을 설정합니다.

​
이벤트 데이터 매핑

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

​
고급 네트워크 구성

​
IP 주소 허용 목록

AlloyDB 인스턴스가 IP 허용 목록을 사용하는 경우 OneSignal의 IP 주소를 추가하세요. OneSignal 대시보드의 데이터 > 통합 > 네트워크 액세스에서 현재 IP 범위를 확인할 수 있습니다.

​
SSH 터널링

OneSignal은 추가 보안을 위해 SSH 터널을 통한 AlloyDB 연결을 지원합니다:
1

SSH 사용자 생성

SSH 호스트 서버에 OneSignal용 전용 사용자 계정을 생성합니다.
2

SSH 터널 구성

OneSignal AlloyDB 연결 설정에서 SSH 터널 사용을 활성화하고 다음을 제공합니다:
  • SSH Host
  • SSH Port
  • SSH Username
3

SSH 키 추가

OneSignal이 SSH 키 쌍을 생성합니다. OneSignal 사용자를 위해 SSH 호스트의 authorized_keys 파일에 공개 키를 복사합니다.

​
제한 사항

  • 성능: 사용량이 많은 시간 동안 프로덕션 데이터베이스에 연결하지 마세요
  • 권한: OneSignal은 이벤트 테이블에 대한 읽기 전용 액세스가 필요합니다
  • Auth Proxy: 모든 AlloyDB 연결에 필요합니다

​
FAQ

​
이벤트 테이블 구조가 변경되면 어떻게 되나요?

OneSignal이 스키마 변경을 감지하고 필드를 다시 매핑해야 할 수 있습니다. 통합 설정에서 필드 매핑을 업데이트하세요.

​
OneSignal은 얼마나 자주 이벤트를 동기화하나요?

OneSignal은 구성된 동기화 빈도를 기반으로 새 이벤트를 확인하며 최소 간격은 15분입니다.

​
도움이 필요하신가요?

AlloyDB 통합 설정에 대한 지원이 필요하면 support@onesignal.com으로 지원팀에 문의하거나 인앱 채팅을 사용하세요.