Freshmarketer 사용자 정의 이벤트
Freshmarketer 이벤트 플랜
- ✘ Sprout
- ✘ Garden
- ✔ Estate
이벤트란 무엇인가요?
이벤트는 사용자가 웹앱/웹사이트에서 수행하는 모든 작업을 의미합니다. 예를 들어, 장바구니에 제품 추가, 제품 구매, 위시리스트에 제품 추가, 양식 제출, 버튼 클릭, 이메일 클릭, 이메일 열기 등이 있습니다. 이벤트가 발생할 때마다 이러한 이벤트에 속성이 첨부되며, 이는 이벤트가 언제 어디서 발생했는지에 대한 정보를 포함합니다. 예: 이 이벤트가 발생한 장치, 운영 체제, 시간, 위치 및 시간대 등.
이 이벤트 관련 정보를 사용하여 방문자와 사용자를 더 잘 이해할 수 있으며, 사용자의 행동에 따라 세분화하여 특정 개인화 캠페인 또는 자동화된 드립 캠페인을 실행할 수 있습니다.
Java, JS, Android & IOS, 웹앱 등 주요 플랫폼에서 이벤트와 속성 사용에 익숙한 경우에만 웹페이지/웹앱에 이벤트 통합을 계속 진행하시길 권장합니다. 그렇지 않다면 개발자의 도움을 받으세요.
//추적하고자 하는 모든 이벤트와 해당 속성 및 데이터 유형을 기록해 두시길 권장합니다//
참고: 데이터 유형은 한 번 정의되면 나중에 변경할 수 없으므로 시작하기 전에 정의하는 데이터 유형을 확실히 하시길 요청드립니다. Freshmarketer는 수신된 데이터 유형이 처음에 정의된 것과 다르면 데이터를 기록할 수 없습니다.
Freshmarketer 이벤트를 진행하기 전에, 아래 표(1.1)를 참조하여 기본 속성을 확인하세요. 이러한 기본 속성은 웹페이지/웹 앱에서 이벤트가 발생할 때마다 자동으로 캡처됩니다. 사용자는 이러한 속성을 수정하거나 편집할 수 없습니다.
기본 속성(표 1.1)
| 이름 | 유형 | 설명 |
|---|---|---|
| event_name | string(50) | 모든 시스템 이벤트 이름 (email_sent, email_delivered, email_subscribed, email_unsubscribed, email_bounced, email_opened, email_clicked, journey_entered, journey_exited, page_viewed, form_submitted) |
| event_category | enum | 모든 시스템 카테고리(email, journey, web, form) |
| event_type | enum | 시스템 이벤트 및 사용자 정의 이벤트 |
| org_id (account_id) | long | 사용자와 연결된 조직 ID/계정 ID |
| contact_id | long | 사용자와 연결된 연락처 ID |
| event_time (created_at) | datetime | 이벤트 발생 시간 |
Freshmarketer는 두 가지 유형의 이벤트를 지원합니다: 시스템 이벤트 및 사용자 정의 이벤트
시스템 이벤트
시스템 이벤트는 Freshmarketer에 의해 자동으로 캡처되며, 여기에 사용자가 여정 워크플로우에서 수행한 모든 이벤트와 대량 캠페인도 캡처됩니다.
시스템 이벤트는 다음 네 가지 카테고리로 구성됩니다:
- 이메일 이벤트
- 여정 이벤트
- 웹 이벤트
- 양식 이벤트
이메일 이벤트
| 이벤트 카테고리 | 이벤트 이름 |
|---|---|
| Email Sent, Email Delivered, Email Opened, Email Clicked, Email Bounced, Email Unsubscribed, Email Subscribed |
이메일 이벤트 속성 (기본 속성에 추가하여 아래 속성이 이메일 이벤트에서 캡처됩니다)
- subscription_id: 구독 ID
- campaign_id: Freshmarketer를 통해 전송된 캠페인 ID
- journey_id: 캠페인이 속한 Freshmarketer를 통해 전송된 여정 ID
- journey_state_id: Freshmarketer를 통해 전송된 여정 상태 ID
- email_event_id: 캠페인의 일부인 이메일 ID
여정 이벤트
| 이벤트 카테고리 | 이벤트 이름 |
|---|---|
| Journey | Journey Entered, Journey Exited |
여정 이벤트 속성 (기본 속성에 추가하여 아래 속성이 여정 이벤트에서 캡처됩니다)
- journey_id: 캠페인이 속한 Freshmarketer를 통해 전송된 여정 ID
- journey_state_id: Freshmarketer를 통해 전송된 여정의 상태 ID(활성, 초안, 중지됨)
웹 이벤트
| 이벤트 카테고리 | 이벤트 이름 |
|---|---|
| WEB | Page Visit, Custom Events |
웹 이벤트 속성 (기본 속성에 추가하여 아래 속성이 웹 이벤트에서 캡처됩니다)
- visitor_id: 사용자 ID
- ipaddress: 사용자 IP 주소
- browser_name: 이벤트가 캡처된 브라우저 이름
- city: 이벤트가 발생한 도시 이름
- state: 이벤트가 발생한 주 이름
- country_code: 이벤트가 발생한 국가 코드(ISO 코드)
- medium: 이벤트가 캡처된 캠페인의 UTM 매체
- referrer: 이벤트의 참조자
- query_params(incl utm): 참조자 URL의 쿼리 매개변수와 UTM
- domain: 이벤트가 발생한 도메인 URL 이름
- url: 이벤트가 발생한 페이지 URL
- url_path: 이벤트가 발생한 URL 경로
- OS: 이벤트가 발생한 운영 체제 이름
양식 이벤트
| 이벤트 카테고리 | 이벤트 이름 |
|---|---|
| FORM | Form Submitted |
사용자 정의 이벤트
사용자 정의 이벤트는 사용자가 Freshmarketer로 전송하는 이벤트로, 사용자 정의입니다. 이는 사용자가 웹사이트/웹 앱에서 수행하는 모든 작업이 될 수 있으며, 예를 들어 위시리스트에 추가, 장바구니에 추가, 제품 주문, 제품 구매, 결제 실패 등이 있습니다. 필요에 따라 이러한 이벤트를 정의할 수 있습니다.
방문자 연결 API
프론트엔드 API:
FM.associateVisitor("johny.depp@hollywood.com");위 스크린샷에서 'johnny.depp'은 Freshmarketer 가격 페이지 "https://www.freshworks.com/marketing-automation/pricing"를 방문한 익명 사용자입니다. 우리의 JS API FM.associateVisitor(“email”)를 사용하여 익명 사용자를 이메일 연락처에 연결하고 있습니다.
참고: 위 API는 Freshmarketer 계정에 이미 존재하지 않는 경우 연락처를 생성하지 않습니다.
REST API:
curl -XPOST -H "fm-token:jrr3g04b0atvta4tmghbguhgugvd03r9n8v7eon7mv1b7qa" 'https://<domain>'