Event template
Overview
The event template provides event and attribute structures so that you can analyze key activities that occur in the app. You can check in the table below whether Hive Axyl automatically collects each event. To configure additional events to collect or to change the event structure to fit your app's characteristics, click each event name to check its attribute list.
For how to send the events you configured, see Send events.
Users
| Event name | When sent | Example metrics | Automatically collected by Hive Axyl |
|---|---|---|---|
| app_session_maintain | An event that occurs every 2 minutes while the client is running after login | Number of concurrent users, number of sessions, play time | X |
| idp_disconnect | An event that occurs when an IDP is unlinked | Number of IDP unlinks, number of users who unlinked | X |
| remote_play_login | An event that occurs when authentication succeeds in Remote Play | Number of Remote Play logins, number of logged-in users, login-to-host-connection conversion rate | X |
| remote_play_session_maintain | An event that occurs when a connection to the host PC succeeds in Remote Play | Number of successful host PC connections, number of connected users, number of connections by connection method | X |
| device_info_change | An event that occurs when the user's device-related information (such as the OS version, advertising ID, device model, and rooting/jailbreak status) changes | Number of device information changes, distribution by device model and OS | X |
| app_logout | An event that occurs when a user logs out of the app | Number of logouts, number of users who logged out | X |
| app_redownload | An event that occurs when an existing user deletes and reinstalls the app or updates it | Number of reinstalls, number of reinstalled devices | X |
| terms_agree | An event that occurs when a new user (NU) agrees to the terms after the first installation | Number of terms agreements, number of users who agreed to the terms | X |
| account_delete_complete | An event that occurs when account deletion is complete | Number of completed deletions, number of users whose deletion was completed | X |
| account_delete_request | An event that occurs when a user requests account deletion | Number of deletion requests, number of users who requested deletion, request-to-completion conversion rate | X |
| banner_expose | An event that occurs when a full-screen promotion banner is displayed | App entry stage funnel | X |
| game_user_entry | An event that occurs when a user reaches an entry stage that the app defines itself | Recording of steps other than the Hive predefined stages (sectionId 1000 or less), extended analysis of entry funnels by app | X |
| app_first_launch | An event that occurs when a user who newly installed the app launches it for the first time and an Analytics ID is created | App entry stage funnel | X |
| app_start | An event that occurs at SDK initialization (app start) | App entry stage funnel | X |
| permission_notice | An event that occurs when a user enters the permission notice screen | App entry stage funnel | X |
| notice_expose | An event that occurs when a notice pop-up is displayed | App entry stage funnel | X |
| terms_expose | An event that occurs when a user enters the terms agreement screen | App entry stage funnel | X |
| server_select | An event that occurs when a user enters the server selection screen | App entry stage funnel | X |
| maintenance_expose | An event that occurs when a server maintenance pop-up is displayed | App entry stage funnel | X |
| download_start | An event that occurs when an additional download starts | Number of additional download starts, app entry stage funnel | X |
| download_complete | An event that occurs when an additional download is complete | Number of additional download completions, app entry stage funnel | X |
| login_enter | An event that occurs when a user enters the login stage | App entry stage funnel | X |
| hive_membership_login | An event that occurs when login with a Hive account is complete in an app linked with Hive Membership | Membership login AU, number of logins, number of new membership users | X |
| app_login | An event that occurs when authentication is complete after entering the app | AU, number of logins, NU | O |
| user_block | An event that occurs when a suspension is applied to a user | Number of suspensions applied, number of suspended users, number of suspensions by suspension reason and period | X |
| user_unblock | An event that occurs when a user's suspension is lifted | Number of suspensions lifted, number of released users, number of releases by release status | X |
Revenue
| Event name | When sent | Example metrics | Automatically collected by Hive Axyl |
|---|---|---|---|
| product_purchase_fail | An event that occurs when a product purchase through PG payment fails | Number of payment failures, number of failures by payment method/PG provider | X |
| product_grant | An event that occurs when an item is actually delivered to the user after payment is complete | Number of item deliveries, number of successful deliveries, number of deliveries by product | X |
| product_refund | An event that occurs when a product purchase is refunded | Number of refunds, number of refunded users, refunded revenue | X |
| webstore_access | An event that occurs when a user accesses the web store page | Number of web store accesses, number of users who accessed, number of sessions | X |
| product_purchase | An event that occurs when receipt verification for a product is complete | In-app revenue, PU, number of sales, purchase quantity, ARPU, ARPPU | O |
| product_purchase_test | An event that occurs when a test payment for a product is made | For verifying the payment integration, such as the number of test payments | X |
| subscription_purchase | An event that occurs when a subscription to a subscription product is renewed | Subscription revenue, PU, number of sales, purchase quantity, ARPU, ARPPU | X |
| subscription_purchase_test | An event that occurs when a test payment for a subscription product is made | For verifying the payment integration, such as the number of test payments | X |
| subscription_cancel | An event that occurs when a user cancels a product subscription or the subscription is automatically canceled when it expires | Number of subscription cancellations, number of users who canceled, cancellation rate by product, estimated revenue loss from cancellations | X |
Ads
| Event name | When sent | Example metrics | Automatically collected by Hive Axyl |
|---|---|---|---|
| ad_click | An event that occurs when a user clicks an ad in the app | Number of ad clicks, number of users who clicked ads, number of clicks by ad placement | X |
| ad_close | An event that occurs when a user ends an ad view | Number of ad views ended, number of users who completed viewing | X |
| ad_load | An event that occurs when an ad creative is loaded on the client | Number of ad loads, load-to-impression conversion rate | X |
| ad_open | An event that occurs when an ad is displayed to the user | Number of ad impressions, number of users who viewed ads, number of impressions by ad placement | X |
| ad_ecpm_record | An event that occurs when eCPM-based ad revenue from an ad view is aggregated | Number of ad revenue occurrences, average eCPM | X |
| ad_reward | An event that occurs when a reward is granted after an ad view | Number of ad rewards granted, number of users who received rewards, amount of rewards granted | X |
Campaigns
| Event name | When sent | Example metrics | Automatically collected by Hive Axyl |
|---|---|---|---|
| promotion_open | An event that occurs when a promotion banner is displayed on the user's screen | Number of promotion impressions, impression-to-click conversion rate, number of impressions by promotion | X |
| promotion_click | An event that occurs when a user clicks a promotion | Number of promotion clicks, number of users who clicked, number of clicks by promotion | X |
| coupon_use | An event that occurs when a user successfully uses a coupon | Number of coupon uses, number of users who used coupons, number of uses by promotion | X |
| pre_event_regist | An event that occurs when a user signs up for a pre-registration event | Number of pre-registration sign-ups | X |
| promotion_reward | An event that occurs when a promotion reward is granted | Number of promotion rewards granted, number of grants by promotion | X |
| push_send | An event that occurs when the Hive push server requests a push send from a push platform (such as APNs and FCM) and receives a response | Number of send requests by push type and campaign, send request success rate, distribution by failure reason | O |
| push_open | An event that occurs when a user enters the app by clicking a push notification | Number of push opens, number of users who opened pushes, number of opens by push type and campaign | X |
| promotion_install | An event that occurs when the app is installed through a promotion | Number of promotion installs, number of new installs, number of installs by media | X |
App usage
| Event name | When sent | Example metrics | Automatically collected by Hive Axyl |
|---|---|---|---|
| mailbox_admin_send | An event that occurs when an administrator or the system sends mail | Number of mail items sent, sending status by sender type, trends by recurring sending round | X |
| mailbox_direct_send | An event that occurs when a user sends mail to another user | Number of mail items sent between users, number of sending users, sending frequency per user | X |
| mailbox_open | An event that occurs when received mail is opened for the first time | Number of mail opens, number of users who opened mail | O |
| mailbox_attachment_receive | An event that occurs when currency and items attached to mail are claimed for the first time | Number of claims, number of users who claimed, amount granted by goods | X |
| asset_use | An event that occurs when in-app currency is consumed | Amount of currency consumed, number of currency consumptions, number of users who consumed, amount consumed by currency | X |
| asset_get | An event that occurs when in-app currency is acquired | Amount of currency acquired, number of currency acquisitions, number of users who acquired, amount acquired by currency | X |
| store_product_click | An event that occurs when a user clicks a product details button in the in-app store | Number of product detail clicks, number of users who clicked, number of clicks by product type and location | X |
| store_product_purchase | An event that occurs when a user clicks a product purchase button in the in-app store | Number of product purchase clicks, number of users who clicked, detail-click-to-purchase conversion rate | X |
| contents_accept | An event that occurs when a user accepts app content | Number of content acceptances, number of users who accepted, number of acceptances by content | X |
| contents_cancel | An event that occurs when a user cancels app content | Number of content cancellations, number of users who canceled, ratio of cancellations to acceptances | X |
| contents_fail | An event that occurs when a user fails app content | Number of content failures, number of users who failed, failure rate by content | X |
| contents_success | An event that occurs when a user completes app content | Number of content completions, number of users who completed, average play time, average score | X |
| contents_wait | An event that occurs when a user enters the waiting phase before app content starts | Number of waiting phase entries, number of users who entered the waiting phase, conversion rate from waiting to acceptance | X |
| account_level_change | An event that occurs when a user levels up their account | Number of account level-ups, number of users who leveled up, final account level reached per user | X |
| character_level_change | An event that occurs when a user levels up a character | Number of character level-ups, number of users who leveled up, final level reached by characters | X |
| guild_level_change | An event that occurs when a user's guild levels up | Number of guild level-ups, final level reached by guilds | X |
| skill_level_change | An event that occurs when a user levels up a skill | Number of skill level-ups, number of users who leveled up, final level reached by skills | X |
| mate_consume | An event that occurs when a mate (such as a pet, companion, or avatar) is consumed | Amount of mates consumed, number of consumptions, amount consumed by grade | X |
| mate_get | An event that occurs when a mate (such as a pet, companion, or avatar) is acquired | Amount of mates acquired, number of acquisitions, number of users who acquired mates, count by acquisition path | X |
| friend_society_invite | An event that occurs when a friend-related social activity (such as adding a friend) takes place | Number of friend activities, number of users who engaged in friend activities | X |
| guild_society_invite | An event that occurs when a guild-related social activity (such as a guild invitation) takes place | Number of guild activities, number of users who engaged in guild activities | X |
| party_society_invite | An event that occurs when a party-related social activity (such as a party invitation) takes place | Number of party activities, number of users who engaged in party activities | X |
Learn more
- Send events — Introduction to event and attribute concepts
- Send event attributes — Detailed rules for required, automatically collected, and custom attributes
- Send event logs — How to send through Hive Axyl, Fluentd, and HTTP