Tokengating Analytics

Background

Knowing user engagement with your tokengating campaign is an important part of validating marketing plans and planning future campaigns. PERCS enables this in multiple ways:
Analytics tab
Attached wallet metadata in orders associated with exclusive access to products campaigns
Token IDs connected to generated discount codes used for exclusive discounts with limited redemptions per NFT

This doc will go into more detail for all of the above

Analytics tab

In the PERCS NFT Gating plug-in there is an Analytics tab at the top. This holds information related to all tokengating campaigns run on this Shopify store



The information under totals will link to orders created with products included in the tokengating campaign. The Type column relates to whether the campaign was "Exclusive access" to the product, or an "Exclusive discount" was provided

Attached wallet metadata in orders associated with exclusive access to products campaigns

Each order with a product that is part of an exclusive access to product tokengating campaign will have metadata from the connected wallet attached with it.


Important information includes:
perc_wallet_address: This is the connected wallet address
perc_token*:* This is the token ID used to access the PERCS
perc_contract: This is the contract address of the NFT used to access the PERC
perc_campaign: This is the name of the tokengated campaign that the user accessed
perc_campaign_id: This is the campaign id of the tokengated campaign that the user accessed

There are also signatures that PERCS creates to ensure that the order is unique

This is assuming that Verify Access is turned on in Settings, with more information on this in the Experimental Features section of this doc

Token IDs connected to generated discount codes used for exclusive discounts with limited redemptions per NFT

For discount campaigns with limited redemption per NFT, PERCS includes the token ID used to access the code as the first digits in the discount code generated. You can export a csv of discount codes used for a discount campaign and therefore know which tokens have been used to generate discount codes.

From the Shopify admin click Discounts
Click on your discount name
Click View all codes

On the top right click on the Export button
Select All discount codes

Click Export discount codes* button

You should receive an email with the exported csv attached which should look like this:

The number in column A before the first dash (-) represents the token ID used to generate the discount code. For example the token 499 generated the code used in entry A2 and token 1365 generated the discount in entry A3

To only keep the token ID you can use the LEFT function in Excel as shown below. In this example the value will output the value of A2 up until the dash (-). Replace "A2" with the cell reference containing the text you want to modify.

=LEFT(A2, FIND("-", A2) - 1)

Updated on: 12/01/2024