NFT, Redirect & Traceback
By combining ixkio's Redirect Response Mode with NFT data and Traceback, users can easily secure the link between the physical tag scan and the display of the NFT.
Note that you cannot mint NFT through ixkio. Many of our customers use crossmint, opensea or similar to do this and then upload the data into ixkio.
As with all ixkio configurations, there's a lot of different options and settings available. Here we will give the basics to get you started. To start, you will need to have set up at least one Tag Code, Batch, Tag Group and Active Folder and be using the Redirect Response Mode. You also need to have your NFT data ready - Contract, Token, Blockchain (Etherium or Polygon) and Owner.
For this example, we will go through every step - adding the NFT data, creating the Traceback code, enabling the NFT information and example of how you might use the code.
The Tag Group needs to be of Tag Type 'Authentication' but you don't need actually use authentication tags (or any tags at all) to test. Just don't use any Authentication Rules.
Make sure that NFT is enabled at the Tag Group level. Navigate to your Tag Group and then Group Detail Panel > Settings Tab. Make sure 'NFT Status' is set to 'NFC Enabled'.
Navigate to your Tag Code then Tag Data Panel > NFT Tab. Add your NFT Contract, Blockchain and Token data. You can also add Owner data if you have it available.
On the main menu, select Control > Traceback. Click on 'Add Traceback Code'. There's a full set of instructions on Traceback but we are going to set just the basics here.
Leave Fail URL blank, set Default Display HTML to Include, enter 'Authentication Check<br>In Progress..' in the Authentication Text box, change Authentication Text Pause to 1 second and leave 'Do not add' on Error Codes. Click Create.
You now need to add the Traceback Code to your page. We will assume here that you are creating a website from basics rather than using a builder (we will add Shopify, Wordpress, Wix, etc examples shortly).
<script defer src="https://t.ixkio.com/s/traceback.js?code=<yourcode>"></script>
Replacing the <yourcode> with the six character Traceback Code that was generated.
Navigate back to your Tag Group and then Tag Group Function Panel > Traceback Tab. There's two settings here - Traceback Protection and NFT Data. We are going to enable both but for general testing you might want to temporarily disable Traceback Protection. Set both to 'Enabled' and then click Update.
Staying on the Tag Group level, go to Tag Group Function Panel > Ruleset Tab. We aren't going to add any Rules here for the moment but if you are going live with authentication tags, you need to enable Authentication Rules.
There's a number of ways of testing the links and clearly you could encode the link directly onto an NFC tag and start scanning. If you are using authentication, then you must do this or it will always fail authentication. However, in this example, we haven't set up authentication rules so can just test directly.
Instead of encoding a tag, we will just simulate this from the URL. Go to the Tag Code level and Tag Detail Panel > Info Tab. Click on the little down arrow next to the XUID to get the URL for this tag.
Now open a new incognito tag in your browser and paste into here. The tag should redirect directly through to your landing page. (You may want to set the screen to mobile on your browser developer tools and you may also want to bookmark the Tag Code link so you can easily click to test).
First step as described above is to test that the link to your site is working. If you paste the Tag Code link into the browser and it's not showing your page, either the URL is wrong or there's a step missed.
At this stage, you should see a message saying Authentication in progress for 1 second before seeing your page.
Enter the Tag Code link in the browser as before and wait 10 seconds. Now refresh the page (don't add the Tag Code, just refresh). You should see an authentication fail message. This is because the 'hit' on the page didn't arrive from the ixkio link - by refreshing the page, you effectively entered the destination page.
At this stage, the Traceback should be functioning and sending data to your page. As you enabled NFT data to be sent on Traceback (Step 4), ixkio will also be checking the NFT data you have entered for the Tag Code on the blockchain and sending the metadata.
This is how to access it.
"title": "Ixkio NFT Robot",
"description": "The Ixkio NFT Demonstration Robot",
The "status" indicates that the Traceback Key passed. The "nft.." information is as added to your Tag Code. The "nftData" is the NFT metadata taken from the blockchain.
As much as we always like to help, we cannot provide specific advice on setting up your website or page beyond telling you how the data is sent.
We will add some example code here shortly.