Skip to main content

MarkTag Server-Side Setup

Setting Up MarkTag Server-Side Tracking

Rubaiyat Farhan avatar
Written by Rubaiyat Farhan
Updated over 2 months ago

What is Server-Side Tracking?

Server-side tracking collects website and app events directly from your server, bypassing browser limitations. This means more accurate data collection, even when visitors use ad blockers or privacy tools.

Benefits

  • More accurate data - Track events even with ad blockers enabled

  • Better reliability - Not affected by browser restrictions

  • Privacy-friendly - You control what data is collected

  • Future-proof - Works regardless of browser tracking changes

Supported Platforms

  • Web (JavaScript/HTML)

  • React Native

  • Flutter

  • Unity

Getting Started

Where to Begin

  1. Go to Data Room

  2. Click on Add Data Source

  3. Find the Server-side MarkTag on the website tab

  4. Click Connect

Setup time: About 10 minutes if you can add code yourself.

Step 1: Choose Your Industry

Select the industry that best matches your business:

  • E-commerce - Online stores

  • Mobile App - Mobile applications

  • Gaming - Games and gaming platforms

  • Others - General websites

You'll see 5 recommended events for your industry. These are suggested starting points - you can track custom events later.

Step 2: Indicate Your Setup Preference

Let us know who will add the code:

  • "I can add code myself" - You have access to add code

  • "I need Markopolo's assistance." - You need help from our team

Both options continue through setup. This helps us provide the right support.

Step 3: Domain Setup

Register Your Domain

Enter your domain name exactly as shown below:

✅ Correct format:

  • example.com

  • shop.example.com

❌ Incorrect format:

  • https://example.com

  • www.example.com

  • http://shop.example.com

Important: No http://, https://, or www - just the domain name.


Add DNS Record

After registering your domain, you'll receive a DNS record to add:

Record details you'll get:

  • Type: CNAME

  • Name: (provided by us)

  • Value: (MarkTag hostname)

  • TTL: (typically 3600)

How to add it:

  1. Copy the DNS record details (use the copy buttons)

  2. Log in to your domain provider (GoDaddy, Cloudflare, Namecheap, etc.)

  3. Find DNS settings or DNS management

  4. Click "Add record" or "Create new record"

  5. Select CNAME as the record type

  6. Paste the Name and Value exactly as provided

  7. Save the record

  8. Return to Markopolo and click "Records verified."

How Long Does DNS Take?

  • Minimum: 5-15 minutes

  • Typical: 30 minutes to 2 hours

  • Maximum: Up to 48 hours (rare)

Tip: Wait at least 30 minutes before clicking "Records verified."

Step 4: Add Tracking Code

After DNS verification, you'll see installation instructions for your platform.

Web (JavaScript)

  1. Select the Web tab

  2. Copy the JavaScript code snippet

  3. Paste it in your website's <head> section

  4. Save and deploy your website

Mobile Apps

Select your platform tab:

  • React Native - SDK installation and initialization code

  • Flutter - Package installation and setup instructions

  • Unity - Import instructions and configuration

Each tab shows code customized with your unique MarkTag ID.

Step 5: Verify Events Are Working

Testing Your Setup

After adding the code:

  1. Visit your website or open your app

  2. Perform actions (view pages, click buttons, etc.)

  3. Watch the real-time event widget in Markopolo

  4. Events should appear within seconds

What You'll See

Each event shows:

  • Event name (e.g., "page_view", "button_click")

  • User ID (MUID)

  • Timestamp

The display updates every 5 seconds.

Setup Complete

Your integration automatically shows as "Connected" when:

  • DNS verification succeeds

  • At least one event is received

Understanding Your Status

Status Badges

  • Recommended - Setup not started yet

  • Domain registered - Waiting for DNS verification

  • Connected - Everything is working!

Button Labels

  • Connect - Start new setup

  • Verify tag - Complete DNS verification

  • Resume setup - Continue incomplete setup

  • View configuration - See your active setup

After Setup

Immediate Next Steps

  1. Test thoroughly - Try different actions and verify events appear

  2. Document your setup - Note where you added the code

  3. Monitor for 24-48 hours - Make sure events keep flowing

  4. Share with your team - Let others know tracking is active

Regular Checks

  • Weekly: Quick check that events are flowing

  • After website updates: Verify tracking still works

  • Monthly: Review event volumes

  • Before campaigns: Confirm tracking is healthy

Common Questions

Can I use both client-side and server-side tracking?

Yes! You can set up both. They work independently, and you'll see both cards in the Website tab.

What if I need to change my domain?

  1. Delete the current integration

  2. Register your new domain

  3. Complete DNS verification again

  4. Update your tracking code

Do subdomains need a separate setup?

Yes. shop.example.com and blog.example.com require separate setups with their own DNS verification.

Will I lose historical data if I reconnect?

No. Your past event data stays in the system. Reconnecting just resumes data collection.

Can I track custom events?

Yes! The recommended events are just suggestions. Once setup is complete, you can track any events your business needs.

Need Help?

If you run into issues during setup:

See our Troubleshooting Guide for solutions to common problems.

Or contact support with:

  • Your domain name

  • The platform you're using (Web, React Native, Flutter, Unity)

  • Any error messages you see

  • What step you're stuck on

Related Articles
Mark tag – Server side code setup
What If I Don't Have MarkTag Configured?
Troubleshooting MarkTag Server-Side Tracking
Did this answer your question?