웹사이트에서 사용자 정의 이벤트를 추적하는 방법
이벤트는 사용자가 웹 앱/웹사이트에서 수행하는 모든 작업을 의미합니다. 예를 들어, 장바구니에 제품 추가, 제품 구매, 위시리스트에 제품 추가, 양식 제출, 버튼 클릭, 이메일 클릭, 이메일 열기 등이 있습니다. 이벤트가 발생할 때마다 이러한 이벤트에 속성이 첨부되며, 이는 이벤트가 언제 어디서 발생했는지에 대한 정보를 포함합니다. 예를 들어, 어떤 기기에서 이 이벤트가 발생했는지, 어떤 운영체제에서 발생했는지, 언제 발생했는지, 어떤 위치와 시간대에서 발생했는지 등의 정보가 포함됩니다.
이 이벤트 관련 정보는 방문자 및 사용자를 더 잘 이해하는 데 사용할 수 있으며, 사용자의 행동에 따라 세분화하여 특정 개인화 캠페인이나 자동화된 드립 캠페인을 실행하는 데 사용할 수 있습니다.
Java, JS, Android & IOS, 웹앱 등 주요 플랫폼에서 이벤트와 속성의 사용에 익숙한 경우에만 웹페이지/웹 앱에 이벤트를 통합하는 과정을 계속할 것을 권장합니다. 그렇지 않으면 개발자의 도움을 받으십시오.
참고: 사용자 정의 이벤트를 사용한 세분화는 Pro 플랜부터 지원됩니다.
추적하려는 모든 이벤트와 속성 및 데이터 유형을 기록해 두는 것을 권장합니다.
참고: 데이터 유형은 한 번 정의되면 나중에 변경할 수 없으므로 시작하기 전에 정의하려는 데이터 유형을 확실히 하시기 바랍니다. 수신된 데이터 유형이 처음에 정의된 것과 다르면 웹 애플리케이션에서 데이터를 기록할 수 없습니다.
웹 애플리케이션에서 이벤트를 진행하기 전에, 아래 표를 참조하여 기본 속성을 확인하십시오. 이러한 기본 속성은 웹페이지/웹 앱에서 이벤트가 발생할 때마다 자동으로 캡처됩니다. 사용자는 이러한 속성을 수정하거나 편집할 수 없습니다.
기본 속성
| 이름 | 유형 | 설명 |
|---|---|---|
| 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_timestamp | datetime | 이벤트 발생 시간 |
웹 애플리케이션은 두 가지 유형의 마케팅 이벤트를 지원합니다: 시스템 이벤트 및 사용자 정의 이벤트
시스템 이벤트
시스템 이벤트는 자동으로 캡처되며, 사용자가 Journey 워크플로우에서 수행한 모든 이벤트 외에도 대량 캠페인도 캡처됩니다. 시스템 이벤트에 대해 자세히 알아보려면 이 문서를 참조하십시오.
사용자 정의 이벤트
사용자 정의 이벤트는 웹 애플리케이션에 의해 전송되는 사용자 정의 이벤트입니다. 이러한 이벤트는 사용자가 웹사이트/웹 앱에서 수행한 모든 작업일 수 있으며, 예를 들어 위시리스트에 추가, 장바구니에 추가, 제품 주문, 제품 구매, 결제 실패 등이 있습니다. 필요에 따라 이러한 이벤트를 정의할 수 있습니다.
방문자 연결 API
프론트엔드 API:
FM.associateVisitor("johny.depp@hollywood.com");
위 스크린샷에서 'johnny.depp'은 "https://www.freshworks.com/marketing-automation/pricing" 페이지를 방문한 익명 사용자입니다. 우리의 JS API FM.associateVisitor(“email”)를 사용하여 익명 사용자를 이메일 연락처에 연결하고 있습니다.
참고: 위 API는 웹 애플리케이션에 이미 존재하지 않는 경우 연락처를 생성하지 않습니다.
REST API:
curl -XPOST -H "fm-token:jrr3g04b0atvta4tmghbguhgugvd03r9n8v7eon7mv1b7qa" 'http://<domain>.freshworkscrm.com/crm/marketer/mas/api/v1/contacts/associate-visitor' -d '{"visitor_id": "1564408766806r0.8685208684454182", "email": "johnny.depp@hollywood.com"}'
참고: 웹 애플리케이션에 연락처가 없는 경우, 위 API는 새로운 연락처를 생성합니다.
사용자 정의 이벤트 API
프론트엔드 API
FM.trackCustomEvent("Added to cart", { "email": "david.thompson@sample.com", "price": 100.21, "currency": "USD", "is_mobile_transaction": true, "return date": "2019-12-30" });
REST API
curl --XPOST 'https://d2c-demo-1.myfreshworks.com/crm/marketer/mas/api/v1/events?email=david@abc.com&event_name=Custom_Signup&event_timestamp=2023-11-24T20:00:00Z' \ --header 'Content-Type: application/json' \ --data '{ "price":1000, "currency":"USD" }'
여기서, event_timestamp 매개변수는 이벤트가 과거에 발생한 경우에만 필요합니다. 타임스탬프가 없으면 현재 시간이 타임스탬프로 사용됩니다.
지원되는 날짜 형식
- "yyyy-MM-dd";
- "yyyy-MM-dd HH:mm:ssZ";
- "yyyy-MM-dd HH:mm:ss.SSS z";
- "yyyy-MM-dd HH:mm:ss.SSS";
비이메일 식별자 사용
기본적으로 사용자 정의 이벤트는 이메일을 식별자로 사용합니다. 그러나 다른 필드(예: 휴대폰 번호)를 식별자로 사용하려면 'identifier_name' 및 'identifier_value' 매개변수를 사용할 수 있습니다.
curl --XPOST 'https://domain.myfreshworks.com/crm/marketer/mas/api/v1/events?identifier_name=cf_client_id&identifier_value=123456&event_name=Stocks_purchased' --header 'Content-Type: application/json' --data '{ "Event Name" : "Stock_Purchase", "Event Date" : "10/07/2023", "Stock Name" : "testing", "Place" : "USA" }'
사용자 정의 이벤트 속성
사용자 정의 이벤트 속성은 사용자가 정의한 것이며, 요구 사항 및 비즈니스 필요에 따라 사용자 정의 이벤트 속성을 정의할 수 있습니다. 예를 들어, 장바구니에 추가된 제품은 제품 이름, 제품 가격, 통화 가치 등의 속성을 가질 수 있습니다.
사용자 정의 이벤트의 제한 사항
웹 애플리케이션은 다음 데이터 유형을 지원합니다:
- Boolean
- Number
- String (255자)
- Date
이벤트 이름은 최대 100자까지 가능합니다. 사용자 정의 이벤트는 데이터 유형별로 최대 25개의 사용자 정의 속성을 가질 수 있습니다(예: Number 데이터 유형의 사용자 정의 속성 25개, String 데이터 유형의 사용자 정의 속성 25개 등). 이벤트 이름의 최대 길이는 100자입니다. 속성의 String 데이터 유형의 최대 길이는 255자입니다. 속성 이름의 최대 길이는 50자입니다. 이벤트 또는 이벤트 속성의 이름은 fm_으로 시작해서는 안 됩니다.