Appearance
Shop
Complete guide for setting up Shop items using XtremePush Loyalty and Directus
1 - Creating Item on XtremePush
Access XP
- Go to https://dashboard.eu.xtremepush.com/
- Log in and complete authentication
- Select the correct project:
- ITVWin_Prod — production environment
- ITVWin_STG — staging environment
- In the right-hand navigation, go to Xperience Hub then Loyalty Hub
Create Shop Item
- In the left sidebar: click redeem > options.
- Click the blue create button top right.
- Click the digital option
- Enter the following details
| Field | Value |
|---|---|
| Title | Title of item in XP |
| Product Price | Number of tokens the item will cost |
| Webhook Url | staging: free spins: https://dev.itvwin.com/api/xp/fs/[bonusTemplateId] free ticket: https://dev.itvwin.com/api/xp/ft/[bonusTemplateId] prod: free spins: https://itvwin.com/api/xp/fs/[bonusTemplateId] free ticket: https://itvwin.com/api/xp/ft/[bonusTemplateId] |
| Authorization Header | Always required. Ask the product team. |
No need to touch any other field entries, leave all as they are.
- Click Save Button
You should now see the Shop Item you have created in the Redeem > Options page in the XtremePush Loyalty Section.
- Shop Item Reward ID
Notice the Name (ID) column, this ID will be important for later and linking the created shop item in Xtreme Push to Directus.
For an example, look at:
2 - Creating Shop Collection on Directus
Access Directus
- Go to Directus
- Navigate to Bingo or Spins
- Choose the category where you want to add Shop collection
Create Collection
- Click the Create New button under Collections
- Enter the following details
| Field | Value |
|---|---|
| Status | Published (choose Draft if you don't want it visible yet) |
| Internal Name | Name of Shop Collection (must be unique) |
| Type | Shop Products |
| Translations | Enabled |
| Title | Shop collection title |
| Slug | URL slug for the shop collection |
- Click Create new Star Product
- Click Save button in the top right
3 - Creating Shop Item On Directus
Below are the possible fields for a shop item in Directus. Required fields are marked with *
| Field | Description |
|---|---|
* Status | Set to Published to make the item live. Use Draft while building. |
* Internal Name | Used for identifying the item inside Directus. Not shown to users — convention is to match the Title in caps (e.g. 200 FREE TICKETS). |
* Reward Id | Must match the Reward ID in XtremePush exactly. This is what links the Directus record to the actual reward. See the XtremePush section for where to find this ID. |
* Title | The headline shown on the shop tile (e.g. 200 FREE TICKETS). |
* Description | Short supporting line displayed under the title (e.g. On The ITV Room!). |
| Subtext | Optional additional copy. Leave blank if not needed. |
* Desktop Image | 4:1 aspect ratio. Used on desktop viewports. |
* Mobile Image | 1:1 aspect ratio. Used on mobile viewports. |
| Badge | Optional label shown as a badge on the tile (e.g. Free, New, Limited). |
* CTA Copy | Button label (e.g. Play Game). |
* CTA URL | Destination when the CTA is clicked. |
| Show for Logged Out | When ticked, the item is visible to unauthenticated users. Leave unticked for logged-in-only rewards. |
| Colour Scheme | Controls the accent colour used for the shop item tile. Options: Bingo, Spins. |
Once entered all desired details, in the top right click the save button.
