Solana
This document covers the steps required to monitor the performance of your Solana game with Gamesight.
The Solana integration will automatically pull on-chain events into your Gamesight reporting. This gives you a unified view of your attribution covering in-game and on-chain interactions. You can learn more about how to configure your integration, what events are available, and how you can setup Solana goals in Gamesight in our documentation.
Account Linking
The first step is to link your Game's contracts to Gamesight to select which transactions you would like to be forwarded into your reporting.
- Open Settings > Ad Platform Integrations and press the Add button to add a new partner
- Search for Solana to find the relevant integration entry
- Fill in the Contract Hash for the Candy Machine you want to track events from
- Save the integration, and repeat for each Candy Machine you want to track
Wallet Association
Events that come through the Solana integration will come through as Anonymous Events tagged with the Wallet ID for the participant in the transaction. This means that while you will see event volumes and revenue for all of your transactions, only those on a wallet that is associated with one of your in-game users will be attributable.
To provide these associations to Gamesight, you will need to provide Wallet IDs (address) in your in-game events as an external ID so that we can leverage Late ID Binding to attribute your Anonymous on-chain events. Below is an example of a event payload that you can use to make that association after a user links their wallet to their in-game account.
curl https://api.ingest.marketing.gamesight.io/events \
-X POST \
-H 'Authorization: SOMEAPIKEYHERE' \
-H 'X-Api-Version: 1.1.0' \
-H 'Content-Type: application/json' \
-d "$(cat <<-EOF
{
"user_id": "b91f8k5r",
"type": "game_launch",
"identifiers": {
"ip": "172.123.245.14",
},
"external_ids": [{
"external_id_type": "solana_wallet",
"external_id": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6Zxxxxxx"
}]
}
EOF
)"
Goal Configuration
Once you have your Solana contract linked, you will automatically start to see on-chain events display in your reporting. There are several event types that will be sent:
Event Type | Description | Use Cases |
---|---|---|
solana_transaction-mint | A user received a newly minted token from your Candy Machine | Measure players earning in-game items |
solana_transaction-buy | A user completed a purchase of a token from your Candy Machine | Measure frequency or volume of purchases. The SOL amount on these events can be reported as revenue |
solana_transaction-sell | A user completed a sale of a token from your Candy Machine | Trigger KPIs on when users acquired participate in selling on secondary markets |
solana_transaction-transfer | A user completed a transfer of a token from your Candy Machine | Track volume of tokens that are traded |
solana_transaction-burn | A user burned a token from your Candy Machine | Measure item use for games with item burning mechanisms |
Note: the complete transaction details are included in the metadata
field for events, so if you would like to trigger goals based on the presence of a specific combination of details of an event, contact your account manager and we can help with configuration.
You can follow our Configuring Goals guide for more details on how to setup and test goals based on these events.
Custom Dashboards
You can also use your Solana transaction data when building custom dashboards on Gamesight. This can be useful to monitoring general statistics and health for the overall economy of your game.
Some possible use cases include:
- Creating a single dashboard combing primary and secondary market transaction volumes in your ecosystem alongside your marketing spends
- Monitoring mint volumes during launch windows or transaction volumes of different skins / items
Updated about 2 months ago