에어브릿지 이벤트 구성요소

앱 설치, 웹 방문, 구독, 구매, 예약 등 다양한 유저 행동이 디지털 환경에서 발생합니다. 에어브릿지는 이러한 행동 중에서 에어브릿지 이벤트로 정의된 유저 행동만 수집할 수 있습니다. 에어브릿지 이벤트를 정의하기 위해서는 필요한 구성요소를 정의해야 합니다.

에어브릿지 이벤트 구성요소 한눈에 보기

에어브릿지 이벤트 구성요소에는 카테고리(Event Category), 액션(Event Action), 라벨(Event Label), 밸류(Event Value), 어트리뷰트(Attribute), 트리거(Trigger)가 있습니다.

이벤트 구성요소

데이터 형식

설명

카테고리

string

- 필수 구성 요소입니다.

- 에어브릿지 이벤트 이름으로 사용합니다. 또한 포스트백 전송 기준입니다.

- 스탠다드 이벤트는 미리 정한 카테고리를 사용합니다.

액션, 라벨

string

- 액션, 라벨은 카테고리 외에 추가로 데이터를 수집하는 속성입니다.

- 에어브릿지 리포트에서 확인할 수 있습니다.

밸류

float

- 밸류로 수집한 데이터를 계산에 활용할 수 있습니다.

어트리뷰트

어트리뷰트마다 다름

- 액션, 라벨 외에 추가로 데이터를 수집할 수 있습니다.

- 에어브릿지 리포트에서 확인할 수 없습니다.

- 시맨틱 어트리뷰트, 커스텀 어트리뷰트가 있습니다. 시맨틱 어트리뷰트는 에어브릿지가 미리 준비한 어트리뷰트입니다.

트리거

-

- 필수 구성 요소입니다.

- 에어브릿지 이벤트가 발생하는 시점입니다. 해당 시점은 각 구성요소를 수집하는 시점과 동일합니다.

 

카테고리

카테고리는 에어브릿지 이벤트를 정의하기 위해 반드시 사용해야 하는 필수 구성요소입니다. 카테고리 이름은 에어브릿지 이벤트 이름으로 사용됩니다. 또한 카테고리를 기준으로 광고 채널에 전송하는 포스트백을 선택할 수 있습니다.

에어브릿지 이벤트는 카테고리 사전 정의 여부에 따라 스탠다드 이벤트와 커스텀 이벤트으로 나뉩니다. 스탠다드 이벤트는 에어브릿지가 정한 카테고리를 사용한 이벤트입니다. 커스텀 이벤트는 에어브릿지 사용자가 새로 만든 카테고리를 사용합니다.

카테고리 명명규칙과 제한사항

카테고리로 사용하는 이름은 아래 규칙을 지켜야 합니다.

  • 모든 이벤트 이름은 영문의 대소문자를 구분합니다.

  • 스탠다드 이벤트는 에어브릿지에서 미리 정한 국문 이름과 영문 이름을 사용합니다.

  • 커스텀 이벤트 이름은 영문과 숫자만 사용할 수 있으며 airbridge.로 시작할 수 없습니다. 최대 허용 길이는 128자입니다.

  • 특수 문자는 _만 사용합니다. :을 포함하는 이벤트 카테고리는 에어브릿지 대시보드에서 사용할 수 없으니 주의하세요.

카테고리로 수집한 데이터에 따라 아래 제한사항이 적용됩니다.

  • 데이터 형식에 맞지 않는 데이터가 있는 이벤트는 수집되지 않습니다. 카테고리의 데이터 형식은 string입니다.

  • 수집한 데이터가 최대 허용 길이인 128자를 벗어나면 데이터를 최대 길이까지만 수집합니다.

에어브릿지에서 카테고리 조회하기

에어브릿지 이벤트가 발생한 횟수는 카테고리와 같은 이름의 메트릭을 선택하면 에어브릿지 리포트 또는 원본 데이터에서 조회할 수 있습니다. 또는 그룹바이, 필터, 프로퍼티로 Event Category를 선택하면 카테고리로 수집한 데이터를 에어브릿지 리포트 또는 원본 데이터에서 확인할 수 있습니다.

 

액션과 라벨

에어브릿지 이벤트에서 추가로 확인하고 싶은 속성은 액션과 라벨을 통해 최대 2개까지 정의할 수 있습니다. 액션과 라벨로 수집한 데이터는 에어브릿지 리포트에서 확인할 수 있습니다.

액션과 라벨로 수집할 수 있는 속성

액션과 라벨로 속성을 자유롭게 수집할 수 있습니다. 액션과 라벨이라는 단어가 가진 뜻과 수집할 수 있는 속성은 관계 없습니다. 예를 들어 액션은 유저 행동에 관련된 속성만 수집할 수 있는 구성요소가 아닙니다.

액션과 라벨 명명 규칙과 제한사항

액션, 라벨로 사용하는 이름은 아래 규칙을 지켜야 합니다.

  • 영문과 숫자, 그리고 국문을 사용할 수 있습니다. 최대 허용 길이는 128자입니다.

  • 영문의 대소문자를 구분합니다. 공백과 특수 문자(?, !, ,, ., /, &, (, ), -, _)를 지원합니다. 특수 문자는 _만 사용할 것을 권장합니다.

액션, 라벨로 수집한 데이터에 따라 아래 제한사항이 적용됩니다.

  • 데이터 형식에 맞지 않는 데이터가 있는 이벤트는 수집되지 않습니다. 액션, 라벨의 데이터 형식은 string입니다.

  • 수집한 데이터가 최대 허용 길이인 128자를 벗어나면 데이터를 최대 길이까지만 수집합니다.

에어브릿지에서 액션과 라벨 조회하기

액션과 라벨로 수집한 데이터는 에어브릿지 리포트에서 그룹바이로 Event Action, Event Label을 선택하면 확인할 수 있습니다.

 

밸류

밸류는 에어브릿지 이벤트가 수집한 숫자를 계산에 이용하기 위해서 선택해야 하는 구성요소입니다. 에어브릿지 이벤트의 밸류로 수집된 숫자만 계산에 이용할 수 있습니다. 밸류로 소수점 9자리 이하 숫자까지 수집할 수 있습니다.

예를 들어 레비뉴 리포트(Revenue Report)에서 판매한 제품의 가격을 더해 전체 판매 가격을 계산하거나 디지털 서비스의 구독료를 전부 합해서 전체 구독료를 확인하기 위해서는 밸류를 반드시 이벤트 구성요소로 사용해야 합니다.

밸류 이해하기

밸류로 수집된 데이터는 밸류로 수집된 다른 데이터와 계산할 수 있습니다. 액션이나 라벨로 수집된 데이터는 계산에 활용할 수 없습니다. 그러나 이벤트 발생 횟수는 밸류 사용 여부와 상관없이 확인할 수 있습니다.

밸류 제한사항

밸류로 수집한 데이터에 따라 아래 제한사항이 적용됩니다.

  • 데이터 형식에 맞지 않는 데이터가 있는 이벤트는 수집되지 않습니다. 밸류의 데이터 형식은 float입니다.

  • 수집한 밸류 데이터가 최대 허용 길이인 소수점 9자리 이하를 벗어나면 데이터를 최대 길이까지만 수집합니다.

  

어트리뷰트

주의하세요

어트리뷰트로 수집한 데이터는 에어브릿지 리포트에서 확인할 수 없습니다. 액션과 라벨을 활용하면 에어브릿지 리포트에서 확인할 수 있는 데이터를 수집할 수 있습니다.

어트리뷰트는 액션, 라벨 외에 에어브릿지 이벤트의 추가적인 속성을 정의하고 수집하기 위해 사용하는 구성요소입니다. 어트리뷰트로 수집된 속성 데이터는 액션, 라벨과 달리 에어브릿지 리포트가 아닌 원본 데이터 추출에서만 확인할 수 있습니다.

어트리뷰트에는 시맨틱 어트리뷰트(Semantic Attribute)와 커스텀 어트리뷰트(Custom Attribute)가 있습니다.

  • 시맨틱 어트리뷰트: 에어브릿지가 수집하는 데이터를 미리 정한 어트리뷰트

  • 커스텀 어트리뷰트: 에어브릿지 사용자가 수집하기 위해서 새롭게 정의한 어트리뷰트

시맨틱 어트리뷰트

시맨틱 어트리뷰트는 에어브릿지가 수집하는 데이터를 미리 정한 어트리뷰트입니다. 에어브릿지가 지원하는 시맨틱 어트리뷰트 목록과 예시를 참고해 주세요.

커스텀 어트리뷰트

커스텀 어트리뷰트는 에어브릿지 사용자가 디지털 서비스나 이벤트 수집 목적에 따라 새로운 이름을 붙여 정의한 어트리뷰트입니다. 커스텀 어트리뷰트는 원본 데이터 추출에서 수집된 모든 속성 데이터가 같은 칼럼에 담긴 상태로 확인할 수 있습니다.

예를 들어 유저의 랭킹과 아이템 유형을 정의한 커스텀 어트리뷰트로 1과 sword(칼)를 수집하면 1과 sword는 하나의 칼럼에 모두 포함됩니다.

어트리뷰트 제한사항

어트리뷰트로 수집한 데이터에 따라 아래 제한사항이 적용됩니다.

  • 시맨틱 어트리뷰트의 데이터 형식에 맞지 않는 데이터는 수집되지 않습니다. 다른 이벤트 데이터와 데이터 형식에 맞는 시맨틱 어트리뷰트는 수집됩니다.

  • 시맨틱 어트리뷰트의 데이터 형식에 맞지 않는 데이터가 있는 이벤트는 수집되지 않습니다. 시맨틱 어트리뷰트마다 데이터 형식이 다르기 때문에 주의해야 합니다.

  • 수집한 데이터가 각 시맨틱 어트리뷰트가 지원하는 최대 허용 길이를 벗어나면 데이터를 최대 길이까지만 수집합니다. 데이터 형식이 string인 시맨틱 어트리뷰트는 최대 1024자까지 허용합니다. 데이터 형식이 int, float인 시맨틱 어트리뷰트는 최대 64비트까지 허용합니다.

  • 수집한 데이터가 커스텀 어트리뷰트가 지원하는 최대 길이를 벗어나면 ERROR_MAX_LENGTH_EXCEEDED가 수집됩니다.

트리거

트리거는 에어브릿지 이벤트를 수집하는 시점입니다. 이벤트를 수집하는 시점에 따라 동일한 에어브릿지 이벤트가 다르게 집계될 수 있습니다. 이벤트를 수집하는 목적이 명확해야 원하는 이벤트를 수집할 수 있습니다.

 

도움이 되었나요?

더 필요한 내용이 있나요?