FAQs - Started Pack
1) Orientation & Core Concepts
1) What is PEP in one sentence?
PEP is Gamanza’s Player Engagement Platform—a real-time CRM plus a loyalty/gamification engine that drives retention through personalized comms and rewards.
2) What are the two main integration surfaces I should know about?
The Platform API Gateway (your backend sends data/events) and the Frontend API/Widgets (player-facing widgets & SDK in your site/app).
3) What’s the quickest mental model for “how data flows”?
Your backend emits identity & activity events → Platform ingests them in real time → CRM segments & triggers campaigns; Gamification updates ranks/tokens/missions; Frontend widgets show player state.
4) What admin screen helps me understand a single player?
The PEP Player Card—one place to see profile, comms consents, rank/XP, tokens, missions/tournaments history, Reward Shop purchases, and more.
5) Where do I get a high-level map of “what features exist” for CRM and Gamification?
The Resources hub (operator docs) has “CRM” and “Gamification” sections with libraries, how-tos, and release notes. Bookmark it.
2) Authentication, Identity & Widgets
6) How do we authenticate to programmatically grant rewards (XP/tokens/bonuses)?
Use OAuth client-credentials you create in Admin → call the Platform API endpoints to credit XP, tokens, or assign rewards.
7) What are the essential frontend SDK pieces?
GamanzaEngageClient.init() to initialize, getInstance() to access, and widget methods like reload, reloadOne, getPlayer, destroy.
8) Can the SDK fetch our casino/sports catalog for personalization?
Yes—the Catalog Module returns games, categories, and providers via the Web Client SDK.
3) CRM Basics (Campaigns, Templates, Channels)
9) What’s a “Campaign” in PEP?
A multi-step flow that sets details, a trigger (time or event), period, target segment, and target groups with actions (Email, SMS, On-site, Web Push; even Send Bonus).
10) Which campaign trigger types exist?
Event/Action (e.g., Registration, Deposit, Bonus Granted) and Time (Now / Specific Day / Recurrence).
11) What are “Target Groups”?
Sub-sets of your segment—assign per-group actions (e.g., Email to 70%, On-site to 30%), test variants, throttle by percent.
12) How do I build Email templates?
Use Visual Builder or HTML, define From/Reply-To (from Settings), add placeholders, and test before saving.
13) How do I build SMS templates?
Create a template, choose Sender ID (where supported), add message + placeholders, and archive/reuse as needed.
14) How do I enable Web Push?
Host a tiny service worker that imports Gamanza’s script—then you can target players with Web Push via CRM.
15) How do I enable native mobile Push (iOS/Android)?
Configure OneSignal: set External ID = Player ID, register the subscription into CRM, and set your OneSignal App ID/API key in Admin.
16) Can I cap how often we message a player?
Yes—Frequency Cap per channel (daily/weekly/monthly). Transactional (event-based) campaigns are not capped.
17) How do I track unsubscribes?
Use Unsubscribe Report—filter by player, campaign, date, channel; reasons are normalized (with original text when “Other”).
4) Segmentation & Personalizatio
18) What segment types exist?
Static, Dynamic, and Players (ID list) segments. Dynamic auto-updates as players meet/stop meeting criteria.
19) What criteria are available out-of-the-box?
Transactional (deposits/withdrawals/GGR), account activity (last login, consents), personal info (age, country, language), and more.
20) Can I build AND/OR logic and nested rules?
Yes—use second layers to combine conditions; there’s also a special Activity Date Range filter for “last 30 days”-type logic.
21) Do we have sports-specific segmentation?
Yes—Sports bet amount/count, turnover, markets, teams; each can be lifetime or date-range.
22) Can I upload/customize player attributes for targeting?
Yes—Player Data (system tags) and Custom Data (your fields) with CSV upload/mapping for bulk assignment.
5) Triggers & Real-Time
23) Which typical events can trigger a campaign?
Examples include Registration, Account Status Change, Deposit Successful, Bonus Granted/Released, and others.
24) Can gamification actions trigger CRM?
Yes—PEP lets you use gamification events (e.g., level-up, mission completed, shop purchase) as triggers for comms and flows.
6) Gamification: Foundations
25) What gamification “currencies” exist?
XP Points (progression), Tokens/Virtual Currency (spend in Reward Shop), plus Boosters (XP/Token/Mission).
26) How do Ranks & Levels work, conceptually?
Players progress by earning XP, climbing levels/ranks with configurable thresholds and rewards in your loyalty model.
27) What are XP Points used for?
They track progression toward levels/ranks and can unlock rewards or access to content/promotions.
28) What are Tokens and where do they matter?
Tokens are your virtual currency used primarily in the Reward Shop to purchase items like bonuses or boosters.
29) Where do players spend tokens and see rewards?
In the Reward Shop (purchasing) and My Rewards (view/claim/activation status).
30) Can we assign rewards manually or via API?
Yes—operators can assign XP, Tokens, Bonuses, Boosters programmatically (and show up in My Rewards), or adjust in Admin.
7) Missions & Tournaments
31) What are Missions?
Goal-oriented tasks (daily/weekly/monthly) that listen to events like login, KYC, casino wagers/wins, sports bets/wins, etc.
32) Which typical events power Missions?
Deposit/withdrawal, casino wager/win, sports bet/win, login, KYC, account verification, marketing opt-in, and more.
33) How do Tournaments differ from Missions?
Tournaments are competitive race/leaderboard mechanics (e.g., turnover, wins) across a time window; Missions are personal tasks.
34) Can I bundle multiple missions?
Yes—Mission Bundles (multi-mission packs) to structure journeys and rewards.
35) What rewards can Missions/Tournaments grant?
XP, Tokens, Boosters, Bonuses, external/manual rewards recorded into the player’s rewards history.
8) Reward Shop & Rewards Engine
36) What’s the Reward Shop?
A storefront where players spend tokens on items (bonus offers, boosters, passes, external rewards) with statuses and purchase history.
37) Can I restrict visibility or eligibility per brand/segment?
Yes—Reward Shop and products can be filtered/targeted; (brand/eligibility filtering appears across gamification libraries).
38) What is the Rewards Engine?
A rules layer that grants rewards (XP/tokens/boosters/bonuses) based on triggers/conditions—think of it as the “grant logic.”
9) Using Gamification Data in CRM (and vice-versa)
39) Can I segment by gamification attributes (rank, XP, purchases)?
Yes—use gamification attributes (e.g., current rank, XP, missions active, Reward Shop purchases) to build segments.
40) Can gamification events trigger marketing comms?
Yes—examples include level-up, mission completed, shop purchase; send Email/SMS/Web-push/on-site right at the moment.
41) Can CRM actions grant gamification rewards?
Yes—flows can assign Tokens/XP/Boosters/Bonuses when a player opens/clicks a message or meets a segment condition.
10) Analytics & Governance
42) Where do I see campaign performance?
In Campaigns → Analytics for each campaign, including frequency-cap impact under the channel’s “Others” section.
43) How do I understand a single player’s engagement footprint?
Open the Player Card for comms history, mission/tournament history, rewards, shop orders, token adjustments.
44) Can I export or centralize data for BI?
Yes—the Resources hub documents BigQuery Integration for enterprise analytics pipelines.
11) Practical Setup Questions
45) What must be true for Web Push to work?
A same-domain service worker that imports Gamanza’s script; then CRM can target via Web Push.
46) What must be true for In-App Push to work?
OneSignal External ID = Player ID, subscription registered in CRM, and OneSignal keys configured in Admin.
47) How do I keep message pressure under control?
Define Frequency Caps per channel/time-window; note transactional campaigns bypass caps.
48) How do I quickly create a “VIP-only” campaign?
Create/ensure a VIP segment (e.g., deposits, GGR, rank) → Campaign → Target Group → action(s) like Email + Bonus.
49) How do I run an A/B via Target Groups?
Split the segment into two Target Groups (e.g., 50/50), vary the action (subject, template, channel) and compare analytics.
50) If I’m lost, where do I get a guided path?
Use the Integration Guide (with best practices) and the Resources hub to navigate CRM/Gamification step-by-step.
Last updated
Was this helpful?