ACENT

프레시마케터 맞춤 이벤트

Freshmarketer Events

Freshmarketer 이벤트

플랜 ✘  Sprout ✘  Garden ✔  Estate

이벤트란 무엇인가요?


이벤트는 사용자가 웹앱/웹사이트에서 수행하는 모든 작업을 의미합니다. 예를 들어, 제품을 장바구니에 추가하거나, 제품을 구매하거나, 위시리스트에 제품을 추가하거나, 양식을 제출하거나, 버튼을 클릭하거나, 이메일을 클릭하거나, 이메일을 여는 등의 작업이 포함됩니다. 이벤트가 발생할 때마다 이러한 이벤트에 속성이 첨부되며, 이 속성에는 이벤트가 언제 어디서 발생했는지에 대한 정보가 포함됩니다. 예: 어떤 기기에서 이 이벤트가 발생했는지, 어떤 운영 체제에서 발생했는지, 언제 발생했는지, 어떤 위치와 시간대에서 발생했는지 등


이 이벤트 관련 정보는 방문자 및 사용자를 더 잘 이해하는 데 사용될 수 있으며, 사용자의 행동에 따라 사용자를 세분화하고 특정 개인화 캠페인이나 자동화된 드립 캠페인을 실행하는 데 사용할 수 있습니다.


Java, JS, Android & IOS, 웹앱 등 모든 주요 플랫폼에서 이벤트와 속성의 사용에 익숙한 경우에만 웹페이지/웹앱에 이벤트를 통합하는 과정을 계속 진행하는 것이 좋습니다. 그렇지 않다면 개발자의 도움을 받으시기 바랍니다. 



//추적하고자 하는 모든 이벤트와 그 속성 및 데이터 유형을 기록해 두는 것을 권장합니다.//


참고: 데이터 유형은 한 번 정의되면 나중에 변경할 수 없으므로 시작하기 전에 정의할 데이터 유형을 확실히 하시기 바랍니다. Freshmarketer는 수신된 데이터 유형이 처음에 정의된 것과 다르면 데이터를 기록할 수 없습니다. 


Freshmarketer 이벤트를 진행하기 전에, 아래 표(1.1)를 참조하여 기본 속성을 확인하시기 바랍니다. 이 기본 속성은 웹페이지/웹 앱에서 이벤트가 발생할 때마다 자동으로 캡처됩니다. 사용자는 이 속성을 수정하거나 편집할 수 없습니다.



기본 속성(표 1.1)


이름 

유형 

설명

event_name 

문자열(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

열거형

모든 시스템 카테고리(email, journey, web, form)

event_type

열거형

시스템 이벤트 및 사용자 정의 이벤트

org_id (account_id)

long

사용자와 연결된 조직 ID/계정 ID

contact_id

long

사용자와 연결된 연락처 ID

event_time (created_at)

datetime

이벤트 발생 시간



Freshmarketer는 두 가지 유형의 이벤트를 지원합니다 시스템 이벤트 & 사용자 정의 이벤트


시스템 이벤트


시스템 이벤트는 Freshmarketer에 의해 자동으로 캡처되며, 사용자가 여정 워크플로우에서 수행한 모든 이벤트와 대량 캠페인도 캡처됩니다.


시스템 이벤트는 다음 네 가지 카테고리로 구성됩니다:


  1. 이메일 이벤트 

  2. 여정 이벤트

  3. 웹 이벤트 

  4. 폼 이벤트


이메일 이벤트



이벤트 카테고리이벤트 이름
이메일Email Sent
Email Delivered
Email Opened
Email Clicked
Email Bounced
Email Unsubscribed
Email Subscribed



이메일 이벤트 속성

(기본 속성에 추가하여(표 1.1 참조) 아래 속성들은 이메일 이벤트에서 캡처됩니다)


subscription_id

구독의 ID

campaign_id

Freshmarketer를 통해 발송된 캠페인의 ID

journey_id

캠페인이 속한 Freshmarketer를 통해 발송된 여정의 ID

journey_state_id

Freshmarketer를 통해 발송된 여정 상태의 ID

email_event_id

캠페인의 일부였던 이메일의 ID

여정 이벤트

이벤트 카테고리

이벤트 이름

여정여정 진입
여정 종료

여정 이벤트 속성

(기본 속성에 추가하여(표 1.1 참조) 아래 속성이 여정 이벤트에 캡처됩니다)

journey_id

캠페인이 속한 Freshmarketer를 통해 전송된 여정의 ID

journey_state_id

Freshmarketer를 통해 전송된 여정의 상태 ID(활성, 초안, 중지됨)

웹 이벤트


이벤트 카테고리

이벤트 이름


웹

페이지 방문
사용자 정의 이벤트


웹 이벤트 속성

(기본 속성에 추가하여(표 1.1 참조) 아래 속성은 웹 이벤트에 의해 캡처됩니다)

visitor_id

string (100)

사용자의 ID

ipaddress

string (100)

사용자의 IP 주소

browser_name

string (100)

이벤트가 캡처된 브라우저의 이름

city

string (255)

Name of the city where the event occurred

state

string(255)

이벤트가 발생한 주의 이름

country_code

string(5)

(ISO 코드) 이벤트가 발생한 국가 코드

medium

string(255)

이벤트가 캡처된 캠페인의 UTM 매체

리퍼러

문자열

이벤트의 리퍼러 

query_params(incl utm)

문자열(255)

리퍼러 URL의 쿼리 매개변수 (UTM 포함) 

domain

문자열(255)

이벤트가 발생한 도메인 URL의 이름

url

문자열

이벤트가 발생한 페이지 URL

url_path

문자열

이벤트가 발생한 URL 경로

OS 

문자열

이벤트가 발생한 OS의 이름


폼 이벤트

EVENT CATEGORY

EVENT NAME

FORM양식 제출됨

사용자 정의 이벤트


사용자 정의 이벤트는 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>.freshmarketer.com/mas/api/v1/contacts/associate-visitor' -d '{"visitor_id": "1564408766806r0.8685208684454182", "email": "johnny.depp@hollywood.com"}'


참고: Freshmarketer 계정에 연락처가 없는 경우, 위 API는 새 연락처를 생성합니다.


사용자 정의 이벤트 API

프론트엔드 API


FM.trackCustomEvent("장바구니에 추가됨", 
{
"email": "david.thompson@sample.com", 
"price": 100.21, 
"currency": "USD", 
"is_mobile_transaction": true, 
"return date": "2019-12-30"
});



Rest API

curl -XPOST 'https://<domain>.freshmarketer.com/mas/api/v1/events?email=david@aws.com&event_name=signup_from_social' -d'{"price": 1000, "currency": "USD", "product-name": "Amazon Fire Stick", "user_id": "1010303"}' -H "Content-Type: application/json"


지원되는 날짜 형식

1. "yyyy-MM-dd";

2. "yyyy-MM-dd HH:mm:ssZ";

3. "yyyy-MM-dd HH:mm:ss.SSS z";

4. "yyyy-MM-dd HH:mm:ss.SSS";


사용자 정의 이벤트 속성


사용자 정의 이벤트 속성은 사용자가 정의한 것으로, 요구 사항과 비즈니스 필요에 따라 사용자 정의 이벤트 속성을 정의할 수 있습니다.


예를 들어: 장바구니에 추가된 제품은 제품 이름, 제품 가격, 통화 가치 등의 속성을 가질 수 있습니다.


사용자 정의 이벤트의 제한 사항:


Freshmarketer는 다음 데이터 유형을 지원합니다:

  1. Boolean 
  2. Number 
  3. 문자열  (255자)
  4. 날짜 

  • 이벤트 이름 은 최대 100자까지 가능합니다.
  • 사용자 정의 이벤트는 데이터 유형별로 최대 25개의 사용자 정의 속성을 가질 수 있습니다( Boolean, Number, String, Date (즉, Number 데이터 유형의 사용자 정의 속성 25개, String 데이터 유형의 사용자 정의 속성 25개 등).
  • 이벤트 이름의 최대 길이는 100자입니다.
  • 속성의 문자열 데이터 유형의 최대 길이는 255자입니다.
  • 속성 이름의 최대 길이는 50자입니다.
  • 이벤트 또는 이벤트 속성의 이름은 fm_으로 시작해서는 안 됩니다.

이 문서가 도움이 되었나요?

Freshmarketer AI 도우미

프레시마케터 맞춤 이벤트

AI 어시스턴트 초기화 중...