이벤트 스트림

​

일반적인 사용 사례

1. 고객 여정 매핑 및 개인화: CRM 또는 고객 데이터 플랫폼(CDP)으로 이벤트를 스트리밍하여 포괄적인 고객 프로필을 구축하고 다양한 접점에서 캠페인을 맞춤화합니다.
2. 분석 및 보고: 메시지 이벤트(예: 전송, 열람, 클릭)를 데이터 웨어하우스로 전송하여 채널 전반의 참여 패턴 또는 장기 추세를 분석합니다.
3. 규정 준수 및 규제 보고: 감사 및 규정 준수 목적으로 모든 메시지 전송 데이터를 데이터 웨어하우스로 스트리밍합니다.
4. AI 및 예측 모델: 메시지 이벤트 데이터를 사내 AI 또는 예측 모델로 전송하여 포괄적인 고객 코호트를 생성하고 이탈 위험을 파악합니다. 예를 들어 이메일 구독 취소 또는 메시지 해제는 잠재적 이탈을 나타낼 수 있습니다.
5. 마케팅 자동화: 참여 이벤트(메시지 열람 또는 클릭 등)를 다른 도구로 전송하여 사용자 여정의 다음 단계를 자동으로 트리거하거나 고객 프로필 및 최근 활동을 업데이트합니다.
6. 데이터 분산: 중요한 고객 데이터는 종종 별도의 도구(고객 참여 플랫폼, CRM, 분석 도구 및 데이터 웨어하우스 등)에 있습니다. 이벤트 스트리밍은 이 데이터를 중앙 집중화하여 귀중한 퍼스트 파티 데이터에 대한 가시성을 높이고 더 빠른 수익 결과를 얻을 수 있습니다.
7. 시스템 간 느린 통신: 다른 시스템으로 실시간 참여 이벤트를 전송하면 일괄 업데이트를 몇 시간 또는 며칠 기다리는 대신 이벤트가 발생한 직후 작업을 트리거할 수 있습니다. 이렇게 하면 수동 가져오기 또는 데이터 동기화에 대한 의존성이 제거됩니다.
8. 지출 증가 및 기술 부채: 여러 중간 도구를 관리하는 대신 OneSignal을 데이터 웨어하우스에 직접 연결할 수 있습니다. 이렇게 하면 여러 통합 또는 사용자 지정 데이터 파이프라인 관리의 비용이 많이 드는 오버헤드가 줄어들고 기술 부채가 줄어들며 제품 및 마케팅을 위한 귀중한 기술 리소스가 보존됩니다.

​

기술 팀과 협력하는 방법

1. 이점 설명: 이 데이터를 사용하기 위한 전략과 마케팅 캠페인을 강화하고 사용자 경험을 개인화하며 데이터를 통합하고 기술 부채를 줄일 수 있는 방법을 공유하세요.
2. 범위 정의: 데이터를 전송할 위치, 추적할 이벤트, 예상 데이터 볼륨을 식별하세요. 이는 적절한 엔드포인트 설정을 구성하는 데 도움이 됩니다.
3. 기술 문서 제공: OneSignal의 기술 문서 및 설정 지침을 공유하세요. 개발 팀은 수신자 엔드포인트와 OneSignal의 이벤트 스트림을 구성하여 데이터가 올바르게 라우팅되도록 해야 합니다.
4. 데이터 볼륨 및 관리 논의: 시스템이 실시간 데이터 흐름을 처리할 수 있는지 확인하세요. 낮은 응답 시간을 유지하기 위해 API 핸들러가 추가 온라인 처리 없이 이벤트를 기록하는 것이 권장됩니다.
5. 테스트 및 문제 해결: 실제 환경에 적용하기 전에 모든 것이 원활하게 작동하는지 확인하기 위해 테스트를 수행하세요.

​

설정

​

요구 사항

• 서버 HTTP(S) 서버를 가리키는 유효한 URL 또는 IP 주소
• URL 및 IP 주소는 공개적으로 라우팅 가능해야 합니다
• 도메인에는 인식된 최상위 도메인(예: “.com”, “.net”)이 포함되어야 합니다

​

이벤트 선택

웹훅 트리거

이벤트 선택

​

이벤트 스트림 필터

템플릿별 이벤트 필터링

템플릿의 템플릿 ID 복사

• Template – https://dashboard.onesignal.com/apps/{APP_ID}/templates/{TEMPLATE_ID}
• Push – https://dashboard.onesignal.com/apps/{APP_ID}/notifications/{MESSAGE_ID}
• Email – https://dashboard.onesignal.com/apps/{APP_ID}/email/{MESSAGE_ID}
• SMS – https://dashboard.onesignal.com/apps/{APP_ID}/sms/{MESSAGE_ID}

​

이벤트 스트림 구성

​

인증 헤더

• Authorization 헤더: Authorization 헤더를 추가하세요. 여기서 YOUR_TOKEN은 시스템 또는 타사에서 제공합니다:
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• 사용자 지정 헤더: 다음과 같은 사용자 지정 헤더를 추가할 수도 있습니다:
  • X-API-Key: {{YOUR_API_KEY}}

​

구성 테스트

웹훅 구성

​

허용되지 않는 헤더

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

본문

이벤트 스트림 본문 옵션

이벤트 스트림의 cURL 미리보기

​

개인화

​

본문 예시

{
  "Event Data": {
    "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 }}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

사용자 지정 본문

​

JSON에서 Liquid 구문 사용

• 문자열 → 따옴표로 감싸야 합니다.
• 숫자 → 따옴표로 감싸지 않습니다.
• 객체 → 따옴표로 감싸지 않아야 합니다.

​

문자열

// Wrap string values in quotes
{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

​

숫자 및 불리언

// Don't wrap numbers or booleans in quotes
{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

​

객체

// Don't wrap objects in quotes.
{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. 직접 언어 확인 사용: 더 나은 호환성을 위해 userLang과 같은 변수가 아닌 조건부에서 항상 user.language를 직접 확인하세요.
2. 간단하게 시작: 기본 구문으로 시작한 다음 점진적으로 복잡성을 추가하세요.
3. 과도한 중첩 방지: 구문 분석 문제를 방지하기 위해 조건부를 평평하게 유지하세요.
4. 먼저 기본 구두점 테스트: 특수 문자를 사용하기 전에 간단한 문장과 구두점으로 시작하세요.
5. 대체 사용: 번역이 누락된 경우에 대비하여 기본 언어(예: 영어)를 확보하세요.
6. 표준 키 사용: 신뢰성을 위해 content/title/en과 같은 표준 OneSignal 키를 사용하세요.

​

결과 및 디버깅

이벤트 스트림 로그 및 메트릭

​

재시도 / 비활성화

​

성공을 위한 팁

• 일반적으로 이벤트 스트림을 타사 서비스가 아닌 자체 서버에 연결하려고 합니다.
  • 타사에 직접 연결하는 것은 잘못된 것이 아니지만 다음은 관리하기가 더 어려울 수 있습니다: 구성/디버그가 더 어려울 것입니다
• 요청 볼륨은 OneSignal에서 관리되지 않습니다.
  • 이벤트 스트림 이벤트는 사용자가 여정의 단계를 거치는 속도만큼 빠르게 전송되며 이는 다른 서비스를 압도하거나 속도 제한에 도달하거나 예기치 않게 청구서를 발생시킬 수 있습니다. 이는 SMS와 같은 다른 메시징 채널을 사용하려고 할 때 특히 일반적입니다. 이벤트 스트림의 유연성은 OneSignal이 이벤트 스트림으로 무엇을 달성하려고 하는지 알지 못한다는 것을 의미하므로 이벤트 스트림 요청을 수락한 다음 타사 연결 제한, 속도 제한 및 큐를 올바르게 처리하는 간단한 서비스를 만들고 싶을 수 있습니다.
• 많은 서비스에는 공개 HTTP API가 있으므로 이벤트 스트림으로 연결할 수 있습니다. API 문서와 HTTP 요청을 만드는 방법의 예를 찾아 시작할 올바른 위치를 찾으세요.

​

메시지 이벤트 데이터 제한

​

테스트

URL이 webhook.site의 "Your unique URL"과 일치합니다

푸시 메시지 이벤트가 선택되었지만 테스트에는 모두 사용할 수 있습니다.

webhook.site 사용 예시

• Host: 요청이 온 IP 주소입니다. 가능한 IP 목록은 REST API 개요를 참조하세요.
• Request Content 이벤트 스트림의 본문 내에서 전송된 데이터입니다.