Frequently Asked Questions
General
What is GramPixel and how does it help my business?
GramPixel is an advanced analytics and server-side tracking platform designed specifically for businesses advertising on Telegram. We help you attribute conversions, track user journeys from ad click through bot interaction, and optimize your ad spend with precision data — all without relying on client-side cookies or browser pixels.
Who is GramPixel designed for?
GramPixel is built for Telegram marketers, media buyers, affiliate managers, and agencies who run paid traffic to Telegram bots, channels, and groups. Whether you're a solo marketer or an agency managing dozens of campaigns, GramPixel scales with you.
How is GramPixel different from Google Analytics or Facebook Pixel?
Unlike traditional analytics tools, GramPixel is purpose-built for the Telegram ecosystem. We track the entire journey: ad click → prelanding page → Telegram bot/channel join → in-bot conversions. We use server-side (S2S) tracking that's immune to ad blockers and iOS privacy restrictions.
Do I need technical skills to use GramPixel?
No. GramPixel is designed to be user-friendly. You can create tracking links, build prelandings, and connect bots through our visual interface — no coding required. For advanced use cases, we offer an API and webhook support.
Is there a free plan available?
Yes! Our Free plan includes up to 500 events per month, 1 bot, 1 domain, and limited analytics — perfect for a quick look at the platform before upgrading to a paid plan.
What languages does GramPixel support?
The dashboard is currently available in English, Ukrainian and Russian. Prelandings can be created in any language. We're actively adding more interface localizations.
Tracking & Pixels
How do I install the GramPixel tracking pixel?
Navigate to your dashboard → GramPixel Pixel section. Copy the JavaScript snippet and paste it into the <head> tag of your website or prelanding page. The pixel automatically captures page views, UTM parameters, click IDs (fbclid, gclid, ttclid), and user agent data.
What is S2S (Server-to-Server) tracking?
S2S tracking sends conversion data directly from your server to ad networks (Facebook CAPI, Google Ads, TikTok Events API) — bypassing the browser entirely. This means your conversions are tracked accurately even when users have ad blockers, strict privacy settings, or use iOS 14.5+.
How do I set up postback URLs?
Go to Settings → Postbacks in your dashboard. Create a new postback configuration by specifying the URL template with macros (e.g., {click_id}, {payout}). You can filter which events trigger the postback and choose between GET and POST methods.
Can I track conversions from Telegram bots?
Yes! Connect your Telegram bot to GramPixel, and we'll automatically track: bot starts, user interactions, purchases, and custom events. Use our Bot API or send events via the S2S endpoint with the user's telegram_id.
What data does GramPixel capture on each click?
We capture traffic source data, UTM parameters, ad platform click IDs, device information, and a unique session identifier. All data is stored securely and in compliance with GDPR.
Can I send custom events?
Absolutely. Use the Custom Events feature to define your own event types (e.g., 'trial_started', 'level_completed'). Send them via our API or S2S endpoint. Custom events appear in your analytics dashboard alongside standard events.
How does GramPixel handle duplicate conversions?
We have built-in deduplication logic that prevents double-counting of conversion events. You can configure deduplication rules per event type in your project settings.
Telegram Ads
Does GramPixel support Telegram Ads?
Yes! GramPixel offers native integration with Telegram Ads. Connect your Telegram Ads account using your session credentials, and we'll automatically sync your campaigns, ad groups, impressions, clicks, joins, and spend data.
How do I connect my Telegram Ads account?
Go to Telegram Ads → Settings in the sidebar. Enter your Telegram Ads credentials (found in your Telegram Ads dashboard cookies). GramPixel will securely sync your ad data every 15 minutes.
Can I see ROI for my Telegram Ads campaigns?
Yes. GramPixel calculates CPC (Cost per Click), CPJ (Cost per Join), and ROI by matching Telegram Ads spend data with your tracked conversions. View these metrics in the Telegram Ads Report section.
Is the Telegram Ads integration real-time?
Data syncs approximately every 15 minutes. Conversion attribution (matching joins to ad campaigns) happens in real-time via our webhook processing pipeline.
Prelandings
What are prelandings and why do I need them?
A prelanding is a landing page shown between your ad and the Telegram bot/channel. It warms up the user, increases conversion rates, and captures tracking data before the user enters Telegram, where browser-based tracking isn't possible.
Can I build prelandings without coding?
Yes. GramPixel includes a visual prelanding builder with drag-and-drop components, pre-made templates, and a live preview. You can customize colors, text, images, and call-to-action buttons.
Can I use my own domain for prelandings?
Absolutely. Add your custom domain in Domains settings, point your DNS to our servers, and GramPixel will automatically provision and renew SSL certificates.
Do prelandings support A/B testing?
Yes. Create multiple variants of a prelanding and split traffic between them. GramPixel tracks visitors and conversions per variant, and can automatically determine a statistical winner. Available on Pro and Agency plans.
Can I inject custom HTML/JavaScript into prelandings?
Yes. Each prelanding has fields for custom code injection: Head End Code, Body Start Code, and Body End Code. Use this for ad network pixels, analytics scripts, or custom styling.
What is the GramPixel auto-invite feature?
When enabled, GramPixel automatically generates a unique, time-limited Telegram invite link for each visitor. After the user clicks Join, the bot creates a one-time invite link, tracks whether the user actually joined, and revokes the link after use or expiration.
Bots & Channels
How do I connect a Telegram bot?
Go to Bots section in your dashboard, click Add Bot, and enter your bot token (from @BotFather). GramPixel will set up the webhook automatically and start tracking bot interactions.
Can I manage multiple bots?
Yes. The number of bots depends on your plan: Free (1 bot), Starter (3 bots), Pro (10 bots), Agency (unlimited). Each bot gets its own analytics and can be linked to different tracking links.
How do I track channel/group subscribers?
Add your channel or group in the Channels/Groups section. Connect a bot with admin access to the channel, and GramPixel will track new subscribers, unsubscribes, and churn rates in real-time.
Can I send messages through GramPixel?
Yes. The Chats section allows you to view conversations with bot users and send replies directly. This is useful for customer support and engagement tracking.
Links & Domains
How do tracking links work?
When you create a tracking link, GramPixel generates a short URL. When a user clicks it, we capture all tracking parameters, then redirect them to the destination (your prelanding, Telegram bot, or direct URL).
What are Smart Links?
Smart Links are conditional redirects. You can set rules based on device type, country, language, time of day, or UTM parameters. Each rule directs the user to a different destination URL.
What are Deep Links?
Deep Links open the Telegram app directly on mobile devices, bypassing the browser. If the app isn't installed, the user is redirected to a fallback URL. GramPixel supports separate deep link URLs for iOS and Android.
How do I add a custom domain?
Go to Domains → Add Domain. Enter your domain name and follow the DNS instructions (CNAME record). GramPixel automatically provisions and renews SSL certificates via Let's Encrypt.
Can I create manager-specific tracking links?
Yes. Manager Links allow you to create unique tracking URLs per team member or affiliate. Each manager link tracks clicks, unique clicks, and conversions separately.
Analytics & Reports
What analytics does GramPixel provide?
GramPixel provides: real-time event tracking, click analytics (by source, campaign, country, device), conversion funnels, user journey visualization, cohort analysis, A/B test results, Telegram Ads ROI reports, and custom event analytics.
Can I export my data?
Yes. All analytics tables and reports can be exported to CSV. Campaign reports are also available in PDF format. Use the Export button on any analytics page.
What are AI Insights?
AI Insights uses machine learning to analyze your campaign data and provide actionable recommendations — such as optimal posting times, underperforming campaigns, audience segment suggestions, and budget reallocation advice. Available on Pro and Agency plans.
How does the funnel analysis work?
Define conversion funnels by specifying sequential steps (e.g., Ad Click → Prelanding Visit → Bot Start → Purchase). GramPixel calculates drop-off rates at each step and shows a visual Sankey diagram of user flow.
What is the User Journey feature?
User Journey shows the complete path of individual users — from their first ad click through every interaction with your prelandings, bots, and events.
Payments & Billing
What payment methods do you accept?
We accept credit/debit cards via Paddle (Visa, Mastercard, AmEx) and cryptocurrency via NOWPayments (BTC, ETH, USDT, and 100+ other coins). All payments are processed securely.
Can I change my plan at any time?
Yes. Go to Billing → Change Plan. Upgrades take effect immediately with prorated charges. Downgrades take effect at the end of your current billing period.
Do you offer annual billing discounts?
Yes! Annual billing saves you approximately 20% compared to monthly billing. Switch to annual billing in your Billing settings.
What happens when I exceed my event limit?
When you reach your plan's event limit, you'll receive a notification. Events continue to be tracked but you'll be charged overage fees.
Can I get an invoice for my purchase?
Yes. Invoices are automatically generated for each payment and are available in Billing → Invoices. You can view, download (PDF), and share invoices.
What is your refund policy?
We offer a 14-day money-back guarantee for first-time subscribers. After that, refunds are handled on a case-by-case basis. See our full Refund Policy in the Legal section.
Security & Privacy
Is GramPixel GDPR compliant?
Yes. GramPixel is fully GDPR compliant. We use server-side tracking without cookies or browser fingerprinting. All data is processed in the EU, and you can exercise your right to data deletion at any time.
How is my data stored and protected?
All data is encrypted in transit (TLS 1.3) and at rest (AES-256). We use Supabase (built on PostgreSQL) with Row-Level Security (RLS) policies to ensure data isolation between workspaces. API keys are hashed before storage.
Can I restrict access by IP address?
Yes. The IP Whitelist feature (Settings → IP Whitelist) allows you to restrict dashboard access to specific IP addresses.
Does GramPixel support team access control?
Yes. Invite team members to your workspace with role-based permissions: Owner, Admin, Editor, and Viewer. Available on Pro and Agency plans.
Is there an audit log?
Yes. The Audit Log records all significant actions in your workspace: link creation/deletion, settings changes, team member additions, and more. Available on Pro and Agency plans.
API & Integrations
Does GramPixel have an API?
Yes. Our REST API allows you to programmatically send events, manage links, retrieve analytics, and configure webhooks. Full documentation is available at /docs.
What integrations are supported?
GramPixel integrates with: Facebook CAPI (Conversions API), Google Ads, TikTok Events API, Telegram Ads, and custom webhook endpoints.
How do webhooks work?
Configure webhook URLs to receive real-time notifications when events occur (conversions, bot joins, link clicks). Webhook payloads are signed with a secret key for verification.
What are the API rate limits?
The API is rate-limited to 120 requests per minute per API key. Batch endpoints support up to 100 events per request.
Frequently Asked Questions
Find answers to common questions about GramPixel platform.
Install tracking pixel
Copy the snippet from your dashboard and paste it into the <head> tag of your website.
Telegram Ads support
Yes, we offer specialized tracking for Telegram Ads campaigns directly in the dashboard.
Change billing plan
Go to Settings > Billing and select 'Change Plan' to upgrade or downgrade instantly.
General
GramPixel is an advanced analytics and server-side tracking platform designed specifically for businesses advertising on Telegram. We help you attribute conversions, track user journeys from ad click through bot interaction, and optimize your ad spend with precision data — all without relying on client-side cookies or browser pixels.
Still have questions?
Our team is here to help you scale your Telegram campaigns.