DRAFT Branch Event Ontology

Branch의 Event Ontology Data Schema는 모든 Branch 제품에서 동일하게 적용되는 통일된 형식입니다.

Events Included

이벤트를 논리적 그룹으로 나눕니다. 이제 다음과 같은 고유한 이벤트 그룹이 있습니다:

  • impression
  • click
  • web-to-app auto-redirect
  • Branch CTA view
  • sms sent
  • open
  • install
  • reinstall
  • web session start
  • pageview
  • commerce event
  • custom event
  • content event
  • user lifecycle event

🚧

iOS 14.5 이후 설치 이벤트 관련 변경 사항

Apple requires users to opt into sharing their device data through Apple's AppTrackingTransparency framework. When an install is attributed to paid ads, a 2nd install event will fire post user opt-in

For additional information on changes post iOS 14.5, visit our FAQ Pages

마지막 4개는 여러 이벤트의 그룹입니다.

  • Custom events 표준 이벤트 목록을 벗어나며 Branch로 트래킹하기로 선택한 모든 이벤트입니다.
  • Commerce events 전자 상거래와 관련된 PURCHASE와 같은 짧은 이벤트 목록을 포함합니다.
  • Content events 콘텐츠를 포함하고 전자 상거래와 직접 관련이 없는 VIEW_ITEM과 같은 짧은 이벤트 목록을 포함합니다.
  • User lifecycle events COMPLETE_REGISTRATION과 같이 앱에서 진행시 유저가 완료한 고유 액션을 나타내는 이벤트.

Branch Standard Events

Event NameEvent CategoryiOSAndroid웹 및 API
Add To CartCommerce EventBranchStandardEventAddToCartBRANCH_STANDARD_EVENT.ADD_TO_CARTADD_TO_CART
Add To WishlistCommerce EventBranchStandardEventAddToWishlistBRANCH_STANDARD_EVENT.ADD_TO_WISHLISTADD_TO_WISHLIST
View CartCommerce EventBranchStandardEventViewCartBRANCH_STANDARD_EVENT.VIEW_CARTVIEW_CART
Initiate PurchaseCommerce EventBranchStandardEventInitiatePurchaseBRANCH_STANDARD_EVENT.INITIATE_PURCHASEINITIATE_PURCHASE
Add Payment InfoCommerce EventBranchStandardEventAddPaymentInfoBRANCH_STANDARD_EVENT.ADD_PAYMENT_INFOADD_PAYMENT_INFO
Click AdCommerce EventBranchStandardEventClickAdBRANCH_STANDARD_EVENT.CLICK_ADCLICK_AD
PurchaseCommerce EventBranchStandardEventPurchaseBRANCH_STANDARD_EVENT.PURCHASEPURCHASE
ReserveCommerce EventBranchStandardEventReserveBRANCH_STANDARD_EVENT.RESERVERESERVE
Spend CreditsCommerce EventBranchStandardEventSpendCreditsBRANCH_STANDARD_EVENT.SPEND_CREDITSSPEND_CREDITS
View AdCommerce EventBranchStandardEventViewAdBRANCH_STANDARD_EVENT.VIEW_ADVIEW_AD
View CartCommerce EventBranchStandardEventViewCartBRANCH_STANDARD_EVENT.VIEW_CARTVIEW_CART
SearchContent EventBranchStandardEventSearchBRANCH_STANDARD_EVENT.SEARCHSEARCH
View ItemContent EventBranchStandardEventViewItemBRANCH_STANDARD_EVENT.VIEW_ITEMVIEW_ITEM
View ItemsContent EventBranchStandardEventViewItemsBRANCH_STANDARD_EVENT.VIEW_ITEMSVIEW_ITEMS
RateContent EventBranchStandardEventRateBRANCH_STANDARD_EVENT.RATERATE
ShareContent EventBranchStandardEventShareBRANCH_STANDARD_EVENT.SHARESHARE
Initiate StreamContent EventBranchStandardEventInitiateStreamBRANCH_STANDARD_EVENT.INITIATE_STREAMINITIATE_STREAM
Complete StreamContent EventBranchStandardEventCompleteStreamBRANCH_STANDARD_EVENT.COMPLETE_STREAMCOMPLETE_STREAM
Complete RegistrationLifecycle EventBranchStandardEventCompleteRegistrationBRANCH_STANDARD_EVENT.COMPLETE_REGISTRATIONCOMPLETE_REGISTRATION
Complete TutorialLifecycle EventBranchStandardEventCompleteTutorialBRANCH_STANDARD_EVENT.COMPLETE_TUTORIALCOMPLETE_TUTORIAL
Achieve LevelLifecycle EventBranchStandardEventAchieveLevelBRANCH_STANDARD_EVENT.ACHIEVE_LEVELACHIEVE_LEVEL
Unlock AchievementLifecycle EventBranchStandardEventUnlockAchievementBRANCH_STANDARD_EVENT.UNLOCK_ACHIEVEMENTUNLOCK_ACHIEVEMENT
InviteLifecycle EventBranchStandardEventInviteBRANCH_STANDARD_EVENT.INVITEINVITE
LoginLifecycle EventBranchStandardEventLoginBRANCH_STANDARD_EVENT.LOGINLOGIN
Start TrialLifecycle EventBranchStandardEventStartTrialBRANCH_STANDARD_EVENT.START_TRIALSTART_TRIAL
SubscribeLifecycle EventBranchStandardEventSubscribeBRANCH_STANDARD_EVENT.SUBSCRIBESUBSCRIBE

포함된 필드

각 이벤트에서는 상당한 양의 정보가 제공됩니다. 다음 표에는 개요가 있습니다. 아래의 여러 필드는 자체적으로 많은 필드가 있는 오브젝트입니다.

필드format정의
idstringa unique id for the event
namestringCLICK, INSTALL, PURCHASE과 같은 이벤트 이름 또는 "signup"과 같은 커스텀 이벤트 이름.
timestamplongunix timestamp in milliseconds for the event
user_data_opted_inbooleanWill always be false on first install. Will only be true on first app session after users opts in to Apple's App Tracking Transparency framework from paid ads
days_from_install_to_opt_inintnumber of days between when the first install (user_data_opted_in= false) and when this event occurred
days_from_last_attributed_touch_to_eventintnumber of days between when the last touch occurred and when this event subsequently occurred.
last_attributed_touch_typeenum { CLICK, WEB_TO_APP_AUTO_REDIRECT, IMPRESSION }whether the last attributed touch was an impression, a click, or a web to app auto redirect.
last_attributed_touch_timestamplongunix timestamp in milliseconds for the last attributed touch.
last_attributed_touch_dataobjectimpression, click, web to app auto redirect, branch cta view, 혹은 sms sent의 경우 이 필드에는 이벤트와 직접 연관된 링크 데이터가 포함됩니다. 기타 모든 이벤트의 경우 이 이벤트 이전에 발생할 마지막 유효한 터치 (클릭, 임프레션 등)와 연관된 데이터입니다. 어트리뷰션 윈도우에 따라 마지막 클릭 또는 웹 투 앱 자동 리디렉션이 최근 임프레션보다 우선합니다.
days_from_last_cta_view_to_eventintnumber of days between when the last Branch CTA view occurred and when this event subsequently occurred (see datasource definition of cta view).
last_cta_view_timestamplong마지막 Branch CTA 보기에 대한 밀리 초 unix 타임스탬프입니다.
last_cta_view_dataobjectThis is the data associated with the last qualifying Branch CTA View to occur before this event. Subject to attribution windows, within which the last click or web to app auto redirect trumps a more recent impression.
first_event_for_userbooleanif this is the first time for this persona that this event has been triggered.
deep_linkedboolean현재 앱 또는 웹 세션으로 인해 유저가 딥링크(Deep Link)된 경우 true입니다.
user_dataobjectdata associated with the user who triggered the event.
event_dataobjectdata associated with commerce or content events, but not specific to any one item.
content_itemsarray of objectArray of content items. A content item is any distinct item, whether a product, piece of content, restaurant, service, flight, hotel, or any kind of media (text, visual, audio.)
custom_dataobject이벤트와 관련된 파트너 지정 커스텀 key-value 페어 (Touch, Branch CTA view 및 SMS sent 제외).

전체 필드 목록

Branch와의 연동을 구축 중이거나 단순히 Branch가 제공하는 필드에 대해 더 자세히 알고 싶다면 아래 CSV 파일을 다운로드하십시오. 이벤트 및 필드, 정의 및 데이터 유형의 포괄적인 목록과 이벤트 유형에 사용할 수 있는 필드를 제공합니다.

웹훅, 데이터 연동 및 추출을 위한 전체 이벤트 온톨로지

또한 일일 추출 API CSV에는 다음 필드가 포함됩니다:

필드format정의
timestamp_isostring<s/span>타임 스탬프: (YYYY-MM-DD HH:MM:SS+0000)
last_attributed_touch_timestamp_isostringlast_attributed_touch_timestamp: (YYYY-MM-DD HH:MM:SS+0000형식으로 표시 )
last_cta_view_timestamp_isostringlast_cta_view_timestamp: (YYYY-MM-DD HH:MM:SS+0000형식으로 표시 )
hash_versionstring특정 민감한 필드가 해시되었는지 또는 언해시되었는지 여부

이 페이지가 도움이 되었습니까?