Standard Events

13 standard events are automatically added to your game when it is added to the deltaDNA platform. These “Standard” events drive most of the charts in the dashboards and tend to be used by the majority of games. Some of them are used by the mobile SDK to report back to deltaDNA on Engage Message and Push Notification open rates.

newPlayer*

This event should be recorded when a new player registers for the game. If there is no registration involved it should be launched the first time a player opens the game. This must be the first event we receive from a player.

clientDevice*

This event should collect information on the device that the game is being played on.

gameStarted*

This event should be launched when a player starts to play the game, it should be the first event that is launched within a session.

gameEnded*

This event should be launched when the user takes an action to exist the game.

gameRunning*

This event is a heartbeat within the SDK. It will be sent once a minute to track if users are still playing. If you decide you don’t want to track this then you can turn off the active checkbox and push it to live

 transaction*

The transaction event can be used to record a wide variety of transactions in the game. It can track the purchase and spending of real currencies, virtual currencies and items. When tracking real currency In App Purchases the transaction event can also instruct the deltaDNA platform to perform revenue validation checks on your transactions with the App Store. Currency conversion from local currencies to your chosen display currency is handled automatically. This powerful event can be used to track a wide range of transaction types including In App Purchases, spending virtual currencies on in game items, exchanging items to receive other items, auctions etc..

ddnaEventTriggeredAction*

Event recorded automatically by deltaDNA SDK when a player triggers an Event Triggered Campaign on their device

ddnaForgetMe*

By sending this event you authorise deltaDNA to delete the previously collected data of this user and stop collecting anymore.

engageResponse*

The engageResponse event is automatically generated by the deltaDNA platform to record the response sent to the game from an A/B Test or Engage Targeting. It should not be sent in from the game.

notificationServices*

Record device ids associated with notification platforms.

notificationSent*

The notificationSent event is automatically recorded by the deltaDNA platform when a push notification is sent to a player.

notificationOpened*

The notificationOpened event should be sent by the game when a push notification launched it or a notification was received while the game is in the foreground.

outOfGameSend*

This event is automatically generated by the deltaDNA platform and should not be sent in from the game.

Optional Events

levelUp

The levelUp event works in exactly the same way as the achievement event. It is designed to support awards when the player increases their player level.

missionCompleted

The missionCompleted event is triggered if a player successfully completes a mission.
If a player succeeds in completing a mission they can be rewarded, this reward can be given as money (either real or virtual), items or a combination of all three.

missionFailed

The missionFailed event is triggered if a player fails to complete a mission successfully.

missionStarted

The missionStarted event is triggered at the start of each mission and records the mission name and a unique ID for the mission.

uiInteraction

The uiInteraction event should be recorded when the player interacts with parts of the interface, specifically as they press buttons or links to view features and navigate around. This event is used to track user journeys around the interface to help determine if parts of the interface or features are not obvious enough
When a button or link to a specific feature exists in multiple locations it can be valuable to track the location of the button that was used. The UILocation is the position in the game where the User Interface object is located.

options

The options event records players changing options or settings in the game.

 

Event Templates

116There are a further 50 event templates that can be added to your game.

achievement

The achievement event provides support for achievements within a game. The game registers an achievement and is able to record currency (both virtual and real) and items based on gaining the achievement.

characterCreated

This event should be launched when a player creates a new character.

characterDeleted

The characterDeleted event is triggered when the player removes a character from the game.

characterUpdated

The characterUpdated event is triggered when the player updates a characters core information, additional fields can be added to the event to track any changes deemed necessary.

engagement

The engagement event can be used to track any player behaviours that occur as the result of an targeted campaign or A/B test but are supplementary top the original conversion event.

featureUnlocked

The featureUnlocked event is an event that will track whenever something like a level, item, badge, level, skills or anything else that is locked of us unlocked.

giftReceived

This event should be launched when a player receives a gift from another player. The Unique tracking number is used to match a giftSent event with a giftRecieved event.

giftSent

This event should be launched when a player sends a gift to another player. the Unique tracking number is used to match a giftSent event with a giftRecieved event.

group

A group is a collection of players that have joined together under a common name. Groups have a single founder and being a member of a group will often provide additional functionality. This functionality can include messaging between group members, trading and gifting.

handAction

The handAction event is a poker specific event used to track the betting rounds within a hand of poker.

handSummary

The result of a hand of poker for a specific player

help

The help event records players entering help screens in a game.

inviteReceived

The inviteReceived event tracks an invite received by a user and if the user accepts that invite.

inviteSent

The inviteSent event tracks an invite sent from a game to a set of users.

itemActioned

This event should be launched when a player does something with an item or stack of items. e.g. When a Player picks up an item from the ground or loot. When a player drops and item from their inventory or a player uses an item from their inventory.

itemCollected

This event should be launched when a player acquires an item, either being gifted it or picking it up.

joinTable

The joinTable event is a poker specific event used to track when a player joins a table.

matchDrawn

The matchDrawn event is triggered at the end of each multiplayer match when a player draws the match.

matchLost

The matchLost event is triggered at the end of each multiplayer match when a player loses the match.

matchObjective

The matchObjective event is used to record each game objective and related targets on the map.

matchStarted

The matchStarted event is triggered at the start of each multiplayer match.

matchSummary

The matchSummary event is triggered at the end of the multiplayer match and is used to record game specific summary information about the match.

matchWon

The matchWon event is triggered at the end of each multiplayer match when a player wins the match.

messageReceived

The messageReceived event tracks the message has been received by the intended user.

messageSent

The messageSent event tracks a message that has been sent by a user. The message itself is not recorded, simply the fact it has been sent.

missionAbandoned

The missionAbandoned event is triggered if a player decided to abandon a mission to either try a different mission or retry the current mission.

playerAssist

When a player is credited with assisting another player or team mate (in the defeat of an opponent).

playerDefeated

This event should be launched when a players is defeated within the game. e.g. when the player dies or loses a duel, match or battle

playerHealed

Event should be recorded when the player is healed

playerKill

This event should be recorded when a player kills an opponent

playerSpawned

This event should be triggered when a player spawns. Add application specific custom parameters.

productViewed

This event should be launched when a player looks at a products description, or views an item. This is designed to capture a players interest within an item before purchase.

shopEntered

This event should be launched when a player accesses the shop.

skillUpgraded

This event should be lauched when a player upgrades one of their characters skills.

skillUsed

This event should be launched when a player uses a skill in game e.g. player casts fireball, player uses novabomb, player uses giant swing.

social

The social tracks behaviour that is social and allows an indication of the amount of social activity a user is undertaking.

socialReward

The socialReward event works in a similar structure to achievements and levelUp. The event is triggered when a user undertakes a social activity in the game, such as posting to Facebook or Twitter. The game will record this and often rewards the player which is recorded in the event.

spinSummary

A summary of a slot spin

support

This event should be launched when a player fills out and sends a support request

 

Finally

Any of the “Standard” or “Template” events above can be extended with your own parameters and you can add your own new events and parameters.

117