आपको अपनी ट्रैफ़िक फ़िल्टरिंग आवश्यकताओं के लिए Magicgate को एकीकृत और कॉन्फ़िगर करने की आवश्यकता है।
5 मिनट से कम समय में Magicgate के साथ उठें और दौड़ें। यह मार्गदर्शिका आपको अपना पहला ट्रैफ़िक प्रवाह बनाने, बुनियादी फ़िल्टर कॉन्फ़िगर करने और एपीआई के साथ परीक्षण करने के बारे में बताती है।
Magicgate फ़िल्टर के कॉन्फ़िगर करने योग्य सेट के विरुद्ध प्रत्येक विज़िटर का मूल्यांकन करके बॉट ट्रैफ़िक को वास्तविक उपयोगकर्ताओं से अलग करता है। प्लेटफ़ॉर्म 10 मिलीसेकंड से कम समय में एक फैसला देता है - या तो 'व्हाइट' (बॉट⟦पीएच0⟧) या 'ऑफर' (वास्तविक उपयोगकर्ता)।
दो एकीकरण मोड हैं. API Mode आपको REST एंडपॉइंट के माध्यम से विज़िटर विशेषताएँ भेजने और JSON निर्णय प्राप्त करने देता है जिस पर आपका एप्लिकेशन कार्य करता है। Direct Mode सब कुछ स्वचालित रूप से संभालता है: अपने डोमेन को Magicgate पर इंगित करें और आगंतुकों को आपकी ओर से किसी भी कोड परिवर्तन के बिना फ़िल्टर और रीडायरेक्ट किया जाता है।
यह त्वरित शुरुआत API Mode पर केंद्रित है क्योंकि यह आपको विकास के दौरान सबसे अधिक नियंत्रण और सबसे तेज़ फीडबैक लूप प्रदान करता है। एक बार जब आप सहज हो जाएं, तो आप उत्पादन परिनियोजन के लिए Direct Mode पर स्विच कर सकते हैं जहां शून्य-कोड एकीकरण को प्राथमिकता दी जाती है।
magicgate.io पर साइन अप करें और अपना ईमेल पता सत्यापित करें। आप एक नए कार्यक्षेत्र के साथ डैशबोर्ड पर उतरेंगे।
फ़्लो पर जाएँ और 'फ़्लो बनाएँ' पर क्लिक करें। इसे एक वर्णनात्मक नाम दें (उदाहरण के लिए 'लैंडिंग पेज - यूएस ट्रैफ़िक')। एकीकरण प्रकार के रूप में API Mode चुनें।
कम से कम एक फ़िल्टर कॉन्फ़िगर करें. बुनियादी सेटअप के लिए, GeoIP (लक्षित देश) और बॉट डिटेक्शन (ज्ञात क्रॉलर को ब्लॉक करें) सक्षम करें। आप बाद में और फ़िल्टर जोड़ सकते हैं.
ऑफ़र पेज यूआरएल (जहां वास्तविक उपयोगकर्ताओं को पहुंचना चाहिए) और व्हाइट पेज यूआरएल (जहां बॉट रीडायरेक्ट किए जाते हैं) सेट करें।
प्रवाह सहेजें. सेटिंग पेज से फ़्लो लेबल और अपना API key कॉपी करें।
cURL या अपने पसंदीदा HTTP क्लाइंट का उपयोग करके एक परीक्षण अनुरोध भेजें (नीचे उदाहरण देखें)।
अपने परीक्षण अनुरोध को उसके फैसले और फ़िल्टर विश्लेषण के साथ देखने के लिए डैशबोर्ड एनालिटिक्स टैब की जाँच करें।
curl -X POST https://api.magicgate.io/api/v1/check \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"label": "my-campaign",
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
"referer": "https://google.com"
}'
# Response:
# {
# "verdict": "offer",
# "url": "https://example.com/landing",
# "display_mode": "redirect",
# "filter_reason": "",
# "processing_ms": 8
# }समझें कि कैसे Magicgate 29+ कॉन्फ़िगर करने योग्य फ़िल्टर, वास्तविक समय आईपी इंटेलिजेंस और व्यवहार विश्लेषण का उपयोग करके बॉट ट्रैफ़िक की पहचान और वर्गीकरण करता है।
Magicgate एक बहुस्तरीय पहचान पाइपलाइन के विरुद्ध प्रत्येक आने वाले आगंतुक का मूल्यांकन करता है। प्रत्येक फ़िल्टर स्वतंत्र रूप से चलता है और अंतिम निर्णय में योगदान देता है। संपूर्ण मूल्यांकन 10 मिलीसेकंड से कम समय में पूरा हो जाता है, जिससे वास्तविक उपयोगकर्ताओं के लिए शून्य बोधगम्य विलंबता सुनिश्चित होती है।
डिटेक्शन पाइपलाइन को कई श्रेणियों में विभाजित किया गया है: नेटवर्क-स्तरीय जांच (आईपी प्रतिष्ठा, GeoIP, VPN/proxy/Tor पहचान, डेटासेंटर पहचान), ब्राउज़र-स्तरीय जांच (उपयोगकर्ता-एजेंट विश्लेषण, जावास्क्रिप्ट फिंगरप्रिंटिंग, हेडर स्थिरता), व्यवहार जांच (क्लिक पैटर्न, सत्र वेग, रेफरर सत्यापन), और सूची-आधारित जांच (ब्लॉकलिस्ट, अनुमति सूची, ISP फ़िल्टरिंग)।
प्रत्येक फ़िल्टर को प्रति प्रवाह व्यक्तिगत रूप से सक्षम या अक्षम किया जा सकता है। यह बारीक नियंत्रण आपको विभिन्न ट्रैफ़िक स्रोतों के लिए सटीक पहचान करने की सुविधा देता है। उदाहरण के लिए, यूएस मोबाइल उपयोगकर्ताओं को लक्षित करने वाला अभियान GeoIP (केवल यूएस), VPN/प्रॉक्सी डिटेक्शन और मोबाइल डिवाइस सत्यापन को सक्षम कर सकता है, जबकि ISP फ़िल्टरिंग को अक्षम कर सकता है।
GeoIP फ़िल्टरिंग शून्य-विलंबता लुकअप के लिए स्थानीय रूप से होस्ट किए गए MaxMind डेटाबेस का उपयोग करती है जिसे साप्ताहिक रूप से अपडेट किया जाता है। आप देश, क्षेत्र या शहर के आधार पर ट्रैफ़िक को लक्षित या बहिष्कृत कर सकते हैं। डेटाबेस 99.8% देश-स्तरीय सटीकता के साथ IPv4 और IPv6 पते को कवर करता है।
VPN, प्रॉक्सी, और Tor डिटेक्शन कई वाणिज्यिक और ओपन-सोर्स डेटाबेस को जोड़ता है। Magicgate ज्ञात VPN निकास नोड्स, सार्वजनिक और निजी प्रॉक्सी सर्वर, Tor निकास रिले और आवासीय प्रॉक्सी नेटवर्क की लगातार अद्यतन सूची बनाए रखता है। जांच में IPv4 और IPv6 दोनों रेंज शामिल हैं।
डेटासेंटर डिटेक्शन क्लाउड प्रदाताओं (AWS, GCP, Azure, DigitalOcean, OVH, Hetzner, और 200+ अन्य) से उत्पन्न होने वाले ट्रैफ़िक की पहचान करता है। यह वर्चुअल मशीनों पर चलने वाली स्वचालित स्क्रिप्ट और हेडलेस ब्राउज़र को पकड़ने में विशेष रूप से प्रभावी है।
उपयोगकर्ता-एजेंट विश्लेषण विज़िटर की उपयोगकर्ता-एजेंट स्ट्रिंग को ज्ञात क्रॉलर, बॉट और स्वचालित टूल के डेटाबेस के विरुद्ध पार्स करता है। यह विसंगतियों का भी पता लगाता है - उदाहरण के लिए, एक उपयोगकर्ता-एजेंट विंडोज़ पर क्रोम होने का दावा करता है लेकिन लिनक्स-विशिष्ट हेडर भेज रहा है।
ब्लॉकलिस्ट फ़िल्टर आपको आईपी पते, आईपी रेंज (सीआईडीआर नोटेशन), और उपयोगकर्ता-एजेंट पैटर्न की कस्टम सूचियां बनाए रखने देता है जिन्हें हमेशा बॉट के रूप में वर्गीकृत किया जाना चाहिए। इसके विपरीत, अनुमति सूची फ़िल्टर आपको विश्वसनीय आईपी (जैसे कि आपका अपना परीक्षण बुनियादी ढांचा) को श्वेतसूची में डालने की सुविधा देता है, जिसे हमेशा गुजरना चाहिए।
Referer सत्यापन अपेक्षित पैटर्न के विरुद्ध HTTP Referer हेडर की जांच करता है। आप विशिष्ट डोमेन (उदाहरण के लिए, Google, Facebook) से आने वाले ट्रैफ़िक की आवश्यकता कर सकते हैं या खाली, गायब या संदिग्ध रेफरर्स वाले ट्रैफ़िक को ब्लॉक कर सकते हैं।
# Check a visitor with full attributes for bot detection
curl -X POST https://api.magicgate.io/api/v1/check \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"label": "my-campaign",
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
"referer": "https://www.google.com/search?q=example"
}'
# Response with verdict and detection details:
# {
# "verdict": "offer",
# "url": "https://example.com/offer",
# "display_mode": "redirect",
# "filter_reason": "",
# "processing_ms": 8,
# "country_code": "US",
# "is_vpn": false,
# "is_bot": false,
# "is_datacenter": false
# }जानें कि फ़िल्टर फैसले के आधार पर Magicgate आगंतुकों को सही गंतव्य तक कैसे पहुंचाता है। श्वेत पृष्ठ बनाम ऑफ़र पृष्ठ मॉडल, पुनर्निर्देशन तंत्र और निर्णय प्रसंस्करण को समझें।
इसके मूल में, Magicgate एक ट्रैफ़िक राउटर है। प्रत्येक विज़िटर का मूल्यांकन आपके कॉन्फ़िगर किए गए फ़िल्टर के आधार पर किया जाता है और एक निर्णय दिया जाता है: 'ऑफर' (वैध उपयोगकर्ता) या 'व्हाइट' (बॉट, क्रॉलर, या अवांछित ट्रैफ़िक)। निर्णय यह निर्धारित करता है कि आगंतुक को कहाँ पुनर्निर्देशित किया गया है।
ऑफ़र पृष्ठ आपका वास्तविक लैंडिंग पृष्ठ, ऑफ़र पृष्ठ, या रूपांतरण फ़नल है - वह पृष्ठ जिसे आप वास्तविक मानव आगंतुकों को दिखाना चाहते हैं। व्हाइट पेज एक नकली या सौम्य पेज है जो बॉट्स, क्रॉलर और विज्ञापन नेटवर्क समीक्षकों को दिखाया जाता है। सामान्य श्वेत पृष्ठों में साधारण ब्लॉग पोस्ट, समाचार लेख या सामान्य सूचनात्मक सामग्री शामिल होती है।
अभियान सुरक्षा के लिए यह पृथक्करण आवश्यक है। विज्ञापन नेटवर्क अनुपालन समीक्षक, क्लिक फ्रॉड बॉट और प्रतिस्पर्धी श्वेत पृष्ठ देखते हैं, जबकि आपके लक्षित दर्शकों में से वास्तविक उपयोगकर्ता ऑफ़र पृष्ठ तक पहुंचते हैं। रूटिंग पारदर्शी रूप से और तार की गति से होती है।
Direct Mode में, रूटिंग पूरी तरह से स्वचालित है। आप अपने डोमेन के DNS को Magicgate पर इंगित करते हैं, और प्लेटफ़ॉर्म संपूर्ण अनुरोध जीवनचक्र को संभालता है: विज़िटर प्राप्त करें, फ़िल्टर का मूल्यांकन करें, और उचित गंतव्य पर HTTP रीडायरेक्ट (डिफ़ॉल्ट रूप से 302) जारी करें। विज़िटर कभी भी कोई मध्यवर्ती पृष्ठ नहीं देखता.
API Mode में, आपका एप्लिकेशन विज़िटर विशेषताओं के साथ /api/v1/check समापन बिंदु को कॉल करता है और निर्णय और अनुशंसित रीडायरेक्ट URL युक्त JSON प्रतिक्रिया प्राप्त करता है। फिर आपका एप्लिकेशन रीडायरेक्ट को स्वयं संभाल लेता है। यह आपको उपयोगकर्ता अनुभव पर पूर्ण नियंत्रण देता है - आप रीडायरेक्ट करने से पहले कस्टम तर्क, लॉगिंग या ए/बी परीक्षण जोड़ सकते हैं।
Magicgate आगंतुकों को रूट करने के लिए तीन डिस्प्ले मोड का समर्थन करता है। 'रीडायरेक्ट' (डिफ़ॉल्ट) गंतव्य URL पर HTTP रीडायरेक्ट जारी करता है। 'प्रॉक्सी' ब्राउज़र एड्रेस बार को बदले बिना मूल यूआरएल पर गंतव्य पृष्ठ सामग्री परोसता है। 'आईफ्रेम' गंतव्य पृष्ठ को मूल यूआरएल पर आईफ्रेम के अंदर लोड करता है। डिस्प्ले मोड प्रति प्रवाह कॉन्फ़िगर करने योग्य है।
निर्णयों को समकालिक रूप से संसाधित किया जाता है और एक ही विज़िटर से तेजी से लगातार अनुरोधों को संभालने के लिए संक्षेप में कैश किया जाता है (उदाहरण के लिए, प्रारंभिक रीडायरेक्ट के बाद पेज संसाधन लोड हो रहे हैं)। कैश टीटीएल 30 सेकंड के डिफ़ॉल्ट के साथ, प्रति प्रवाह कॉन्फ़िगर करने योग्य है।
# API Mode: Get verdict and redirect URL
curl -X POST https://api.magicgate.io/api/v1/check \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"label": "my-campaign",
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
}'
# Successful response:
# {
# "verdict": "offer",
# "url": "https://example.com/offer",
# "display_mode": "redirect",
# "filter_reason": "",
# "processing_ms": 8
# }Magicgate द्वारा प्रस्तावित दो एकीकरण मोड की तुलना करें। समझें कि अधिकतम नियंत्रण के लिए API Mode का उपयोग कब करना है और कब Direct Mode सबसे सरल परिनियोजन पथ प्रदान करता है।
Magicgate दो अलग-अलग एकीकरण मोड प्रदान करता है, प्रत्येक को अलग-अलग उपयोग के मामलों और तकनीकी आवश्यकताओं के लिए डिज़ाइन किया गया है। सही मोड चुनने से आपकी तैनाती जटिलता, उपयोगकर्ता अनुभव पर नियंत्रण और परिचालन ओवरहेड प्रभावित होता है।
API Mode एक प्रोग्रामेटिक इंटीग्रेशन है। आपका एप्लिकेशन विज़िटर विशेषताओं (आईपी पता, उपयोगकर्ता-एजेंट, रेफ़रर इत्यादि) के साथ /api/v1/check समापन बिंदु पर एक POST अनुरोध भेजता है और निर्णय सहित JSON प्रतिक्रिया प्राप्त करता है। फिर आपका कोड रूटिंग को संभालता है - बॉट्स को सफेद पृष्ठ पर पुनर्निर्देशित करता है और वास्तविक उपयोगकर्ताओं को अनुमति देता है। इस मोड में आपको एकीकरण कोड लिखने की आवश्यकता होती है लेकिन यह आपको अनुरोध प्रवाह पर पूर्ण नियंत्रण देता है।
Direct Mode एक DNS-स्तरीय एकीकरण है। आप Magicgate को इंगित करने के लिए अपने डोमेन के DNS रिकॉर्ड (CNAME से proxy.magicgate.io, या रूट डोमेन के लिए ALIAS/ANAME) को कॉन्फ़िगर करते हैं। जब कोई विज़िटर आता है, तो Magicgate पारदर्शी रूप से अनुरोध को स्वीकार करता है, विज़िटर का मूल्यांकन करता है, और ऑफ़र पृष्ठ या श्वेत पृष्ठ पर HTTP रीडायरेक्ट जारी करता है। आपके एप्लिकेशन पर किसी कोड परिवर्तन की आवश्यकता नहीं है - संपूर्ण फ़िल्टरिंग और रूटिंग परत आपके मूल सर्वर के सामने बैठती है।
API Mode लाभ: रूटिंग लॉजिक पर पूर्ण नियंत्रण। आप निर्णय प्राप्त करने और उपयोगकर्ता को पुनर्निर्देशित करने के बीच कस्टम प्रोसेसिंग जोड़ सकते हैं - लॉगिंग, ए/बी टेस्ट असाइनमेंट, कुकी सेटिंग, एनालिटिक्स इवेंट, या निर्णय मेटाडेटा के आधार पर सशर्त तर्क। API Mode किसी भी बैकएंड स्टैक के साथ काम करता है और इसमें DNS परिवर्तन की आवश्यकता नहीं होती है। यह सिंगल-पेज एप्लिकेशन (एसपीए) के लिए भी आदर्श है जहां क्लाइंट-साइड जावास्क्रिप्ट चेक कॉल करता है।
API Mode नुकसान: आपके एप्लिकेशन में कोड परिवर्तन की आवश्यकता है। आपको एपीआई कॉल, त्रुटि मामलों (टाइमआउट, दर सीमा) और रीडायरेक्ट तर्क को संभालने की आवश्यकता है। एपीआई कॉल आपके पेज लोड समय में एक नेटवर्क राउंड-ट्रिप जोड़ता है (आमतौर पर Magicgate के किनारे की भौगोलिक निकटता के आधार पर 10-50ms)।
Direct Mode लाभ: शून्य कोड परिवर्तन। अपने DNS को इंगित करें और अपने प्रवाह को कॉन्फ़िगर करें - आगंतुकों को स्वचालित रूप से फ़िल्टर और रीडायरेक्ट किया जाता है। Direct Mode अंतिम उपयोगकर्ता के लिए तेज़ है क्योंकि इसमें कोई अतिरिक्त एपीआई राउंड-ट्रिप नहीं है; फ़िल्टरिंग DNS रिज़ॉल्यूशन और प्रारंभिक HTTP अनुरोध के भाग के रूप में किनारे पर होती है। यह सभी एज मामलों (टाइमआउट, पुनः प्रयास) को भी पारदर्शी तरीके से संभालता है।
Direct Mode नुकसान: रूटिंग प्रक्रिया पर कम नियंत्रण। आप फैसले और रीडायरेक्ट के बीच कस्टम तर्क नहीं डाल सकते। DNS परिवर्तन धीरे-धीरे (मिनटों से घंटों तक) प्रसारित होते हैं जिससे परीक्षण और रोलबैक धीमा हो जाता है। Direct Mode के लिए आवश्यक है कि आपका श्वेत पृष्ठ और ऑफ़र पृष्ठ सार्वजनिक URL के माध्यम से पहुंच योग्य हो।
एक संकर दृष्टिकोण भी संभव है. अपने मुख्य लैंडिंग पृष्ठों के लिए Direct Mode का उपयोग करें (जहां शून्य-कोड एकीकरण प्राथमिकता है) और विशिष्ट समापन बिंदुओं के लिए API Mode का उपयोग करें जिन्हें कस्टम निर्णय प्रबंधन की आवश्यकता होती है (उदाहरण के लिए, फॉर्म सबमिशन, एपीआई एंडपॉइंट, या चेकआउट प्रवाह)।
# ---- API Mode: Manual check + redirect ----
# Send visitor data and receive a verdict
curl -X POST https://api.magicgate.io/api/v1/check \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"label": "my-campaign",
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
"referer": "https://google.com"
}'
# ---- Direct Mode: DNS configuration ----
# Point your domain to Magicgate's proxy:
# CNAME landing.example.com -> proxy.magicgate.io
# For root domains that don't support CNAME, use ALIAS/ANAME:
# ALIAS landing.example.com -> proxy.magicgate.io
# No API calls needed -- Magicgate handles everything at the edge.अपने Magicgate खाते में कस्टम डोमेन जोड़ें, DNS रिकॉर्ड कॉन्फ़िगर करें, और डोमेन सत्यापन प्रबंधित करें। Cloudflare एकीकरण और SSL प्रमाणपत्र प्रबंधन शामिल है।
प्रत्येक Magicgate खाते के पास तत्काल उपयोग के लिए एक साझा डोमेन (go.magicgate.io) तक पहुंच है। Starter योजनाएं और इसके बाद के संस्करण ब्रांडेड यूआरएल के लिए कस्टम डोमेन और विज्ञापन नेटवर्क के साथ बेहतर ट्रस्ट सिग्नल जोड़ सकते हैं।
कस्टम डोमेन आपको साझा डोमेन के बजाय अपने स्वयं के URL (जैसे, track.yourbrand.com) का उपयोग करने देते हैं। यह विज्ञापन अनुपालन के लिए महत्वपूर्ण है - कई विज्ञापन नेटवर्क साझा ट्रैकिंग डोमेन के बजाय ब्रांडेड डोमेन से आने वाले ट्रैफ़िक के प्रति अधिक उदार हैं।
Magicgate उप डोमेन (track.yourbrand.com) और रूट डोमेन (yourbrand.com) दोनों का समर्थन करता है। उपडोमेन की अनुशंसा की जाती है क्योंकि वे आपकी मुख्य वेबसाइट के DNS कॉन्फ़िगरेशन में हस्तक्षेप नहीं करते हैं और उन्हें प्रबंधित करना आसान होता है।
डोमेन सत्यापन proxy.magicgate.io की ओर इंगित करने वाले CNAME रिकॉर्ड का उपयोग करता है। जब आप कोई डोमेन जोड़ते हैं, तो आप अपने डोमेन से CNAME रिकॉर्ड को proxy.magicgate.io पर कॉन्फ़िगर करते हैं। रूट डोमेन के लिए जो CNAME रिकॉर्ड का समर्थन नहीं करते हैं, इसके बजाय proxy.magicgate.io की ओर इंगित करने वाले ALIAS या ANAME रिकॉर्ड का उपयोग करें। Magicgate यह जांच कर स्वामित्व की पुष्टि करता है कि DNS रिकॉर्ड प्रॉक्सी एंडपॉइंट पर सही ढंग से हल होता है।
DNS प्रसार पूर्ण होने के बाद SSL प्रमाणपत्र स्वचालित रूप से Let's Encrypt के माध्यम से प्रदान किए जाते हैं। Magicgate प्रमाणपत्र जारी करने, नवीनीकरण और स्थापना को संभालता है। आपका कस्टम डोमेन DNS कॉन्फ़िगरेशन के कुछ मिनटों के भीतर एक वैध प्रमाणपत्र के साथ HTTPS पर ट्रैफ़िक प्रदान करेगा।
Cloudflare उपयोगकर्ताओं के लिए, सुनिश्चित करें कि Magicgate की ओर इशारा करने वाले CNAME रिकॉर्ड के लिए प्रॉक्सी (नारंगी बादल) अक्षम है। Cloudflare का प्रॉक्सी ट्रैफ़िक को Magicgate तक पहुंचने से पहले ही रोक देता है, जो विज़िटर मूल्यांकन में हस्तक्षेप कर सकता है। रिकॉर्ड को 'केवल DNS' (ग्रे क्लाउड) मोड पर सेट करें।
आप Magicgate के बाज़ार से सीधे डोमेन भी खरीद सकते हैं। ये डोमेन पूर्व-कॉन्फ़िगर हैं और तुरंत उपयोग के लिए तैयार हैं - कोई DNS सेटअप या सत्यापन की आवश्यकता नहीं है। बाज़ार ट्रैफ़िक अभियानों के लिए उपयुक्त स्वच्छ डोमेन का चयन प्रदान करता है।
सेटिंग्स > डोमेन पर जाएँ और 'डोमेन जोड़ें' पर क्लिक करें। अपना कस्टम डोमेन दर्ज करें (उदाहरण के लिए, track.yourbrand.com)।
अपने DNS प्रदाता पर एक CNAME रिकॉर्ड जोड़ें: नाम = आपका डोमेन, मान = proxy.magicgate.io। रूट डोमेन के लिए, यदि आपका प्रदाता शीर्ष डोमेन पर CNAME का समर्थन नहीं करता है, तो ALIAS/ANAME का उपयोग करें। DNS प्रसार में 24 घंटे तक का समय लग सकता है.
Magicgate डैशबोर्ड में 'सत्यापित करें DNS' पर क्लिक करें। एक बार सत्यापित हो जाने पर, SSL प्रमाणपत्र स्वचालित रूप से प्रदान किया जाता है। आपकी डोमेन स्थिति सक्रिय में बदल जाती है।
# Verify DNS configuration using dig
# Check CNAME record points to Magicgate proxy
dig CNAME track.yourbrand.com +short
# Expected: proxy.magicgate.io.
# Check SSL certificate is provisioned
curl -vI https://track.yourbrand.com 2>&1 | grep "SSL certificate"
# Expected: SSL certificate verify okट्रैफ़िक घटनाओं के लिए वास्तविक समय सूचनाएं प्राप्त करने के लिए वेबहुक सेट करें। पेलोड संरचना, पुनः प्रयास तर्क, हस्ताक्षर सत्यापन और ईवेंट प्रकारों के बारे में जानें।
Webhooks आपको वास्तविक समय HTTP POST सूचनाएं प्राप्त करने देता है जब आपके Magicgate खाते में महत्वपूर्ण घटनाएं घटती हैं - जैसे प्रवाह परिवर्तन, डोमेन सत्यापन, या भुगतान अपडेट।
Magicgate कई श्रेणियों में वेबहुक इवेंट का समर्थन करता है: फ़्लो इवेंट (flow.created, flow.updated, flow.deleted), डोमेन इवेंट (domain.added, domain.verified, domain.deleted, डोमेन.registration_failed), व्हाइट पेज इवेंट (white_page.ready,white_page.failed, White_page.deleted), ब्लैकलिस्ट इवेंट (blacklist.created, blacklist.updated, blacklist.deleted), API key इवेंट (apikey.created, apikey.deleted, apikey.activated, apikey.deactivated), वॉलेट इवेंट (wallet.credited, wallet.debited), सब्सक्रिप्शन इवेंट (subscription.changed, subscription.canceled, subscribe.plan_changed, और अधिक), बिलिंग इवेंट (payment.completed, payment.failed), और सपोर्ट इवेंट (ticket.created, ticket.replied, ticket.resolved, ticket.closed)।
प्रत्येक वेबहुक डिलीवरी में तीन सुरक्षा हेडर शामिल होते हैं: X-Webhook-Signature (HMAC-SHA256 हेक्स डाइजेस्ट), X-Webhook-Timestamp (यूनिक्स टाइमस्टैम्प), और X-Webhook-ID (एंडपॉइंट पहचानकर्ता)। हस्ताक्षर टाइमस्टैम्प और बॉडी को एक साथ कवर करता है - HMAC-SHA256(गुप्त, टाइमस्टैम्प + '.' + बॉडी) के रूप में गणना की जाती है - जो छेड़छाड़ और रीप्ले हमलों दोनों को रोकता है। आपको हस्ताक्षर सत्यापित करना चाहिए और 5 मिनट से अधिक पुराने टाइमस्टैम्प वाले अनुरोधों को अस्वीकार करना चाहिए। जब आप वेबहुक एंडपॉइंट बनाते हैं तो हस्ताक्षर रहस्य उत्पन्न होता है और एक बार प्रदर्शित होता है - इसे सुरक्षित रूप से संग्रहीत करें।
Magicgate विफल वेबहुक डिलीवरी का पुनः प्रयास करें। यदि आपका एंडपॉइंट एक गैर-2xx स्थिति कोड लौटाता है या 10 सेकंड के भीतर प्रतिक्रिया नहीं देता है, तो डिलीवरी का पुनः प्रयास किया जाता है। सभी पुनः प्रयास समाप्त हो जाने के बाद, ईवेंट को विफल के रूप में चिह्नित किया जाता है और समापन बिंदु की विफलता संख्या बढ़ा दी जाती है।
Webhook पेलोड संरचना के साथ JSON-एन्कोडेड हैं: { id, event, timestamp, data }। 'इवेंट' फ़ील्ड में इवेंट प्रकार स्ट्रिंग होती है (उदाहरण के लिए, 'domain.verified'), 'आईडी' निष्क्रियता के लिए एक अद्वितीय डिलीवरी आईडी है, 'टाइमस्टैम्प' एक आईएसओ 8601 डेटाटाइम है, और 'डेटा' में इवेंट-विशिष्ट विवरण शामिल हैं।
आप प्रति खाता एकाधिक वेबहुक एंडपॉइंट कॉन्फ़िगर कर सकते हैं, प्रत्येक अलग-अलग ईवेंट प्रकारों के लिए सब्सक्राइब किया गया है। उदाहरण के लिए, यह आपको डोमेन ईवेंट को अपनी परिनियोजन पाइपलाइन और बिलिंग ईवेंट को आपके अकाउंटिंग सिस्टम पर रूट करने देता है।
Magicgate डैशबोर्ड में सेटिंग्स > Webhooks पर नेविगेट करें।
'एंडपॉइंट जोड़ें' पर क्लिक करें और अपना वेबहुक यूआरएल दर्ज करें (HTTPS होना चाहिए)।
उन ईवेंट प्रकारों का चयन करें जिन्हें आप प्राप्त करना चाहते हैं (flow.created, domain.verified, payment.completed, आदि)।
निर्माण के बाद प्रदर्शित हस्ताक्षर रहस्य की प्रतिलिपि बनाएँ। इसे अपने पर्यावरण चर में संग्रहीत करें।
अपने सर्वर पर एक वेबहुक हैंडलर लागू करें जो POST अनुरोध प्राप्त करता है और हस्ताक्षर सत्यापित करता है।
डैशबोर्ड में 'टेस्ट इवेंट भेजें' बटन का उपयोग करके वेबहुक का परीक्षण करें।
सफल रिसेप्शन को सत्यापित करने के लिए Webhook लॉग टैब में डिलीवरी स्थिति की निगरानी करें।
# Test webhook endpoint manually
# Headers match what Magicgate sends: X-Webhook-Signature, X-Webhook-Timestamp, X-Webhook-ID
TIMESTAMP=$(date +%s)
BODY='{"id":"evt_1234567890","event":"domain.verified","timestamp":"2024-01-15T10:30:00Z","data":{"domain":"track.yourbrand.com"}}'
SECRET="your_webhook_secret"
SIGNATURE=$(echo -n "${TIMESTAMP}.${BODY}" | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $2}')
curl -X POST https://your-server.com/webhooks/magicgate \
-H "Content-Type: application/json" \
-H "X-Webhook-Signature: $SIGNATURE" \
-H "X-Webhook-Timestamp: $TIMESTAMP" \
-H "X-Webhook-ID: endpoint-uuid-here" \
-d "$BODY"Magicgate वॉलेट-आधारित बिलिंग मॉडल, समर्थित भुगतान प्रदाताओं और योजना प्रबंधन को समझें। डैशबोर्ड के माध्यम से अपनी सदस्यता और जमा प्रबंधित करें।
Magicgate वॉलेट-आधारित बिलिंग मॉडल का उपयोग करता है। आप क्रिप्टो जमा के माध्यम से अपने वॉलेट में धनराशि जोड़ते हैं, और आपकी सदस्यता प्रत्येक बिलिंग चक्र पर वॉलेट शेष से स्वतः नवीनीकृत हो जाती है। इससे बार-बार कार्ड चार्ज करने की आवश्यकता समाप्त हो जाती है और आपके खर्च पर पूर्ण नियंत्रण मिलता है।
तीन भुगतान प्रदाता समर्थित हैं: CCPayment, NowPayments, और TransVoucher। प्रत्येक प्रदाता बिटकॉइन, एथेरियम, यूएसडीटी, यूएसडीसी और 50+ अतिरिक्त क्रिप्टोकरेंसी का समर्थन करता है। जब आप जमा शुरू करते हैं, तो एक भुगतान पता और राशि उत्पन्न होती है। एक बार जब ब्लॉकचेन लेनदेन की पुष्टि कर देता है, तो आपका वॉलेट बैलेंस स्वचालित रूप से अपडेट हो जाता है।
योजनाएँ आपकी सुविधा सीमाएँ निर्धारित करती हैं: प्रति माह जाँच, प्रवाह की संख्या, प्रति प्रवाह नियम, एपीआई एक्सेस, कस्टम डोमेन, और बहुत कुछ। आप प्रमाणीकरण के बिना उपलब्ध योजनाओं को देख सकते हैं। अपग्रेड या डाउनग्रेडिंग तुरंत प्रभावी होती है - वर्तमान अवधि से अप्रयुक्त शेष राशि आनुपातिक रूप से आपके वॉलेट में वापस जमा कर दी जाती है।
सदस्यता मासिक या वार्षिक हो सकती है। वार्षिक सदस्यता पर छूट मिलती है। आप किसी भी समय रद्द कर सकते हैं - सदस्यता वर्तमान बिलिंग अवधि के अंत तक सक्रिय रहती है। रद्द की गई सदस्यता को फिर से शुरू करने से कोई नई सदस्यता बनाए बिना उसे बहाल कर दिया जाता है।
वॉलेट सभी लेनदेन को ट्रैक करता है: जमा, सदस्यता शुल्क, रिफंड और आनुपातिक क्रेडिट। प्रत्येक लेन-देन में एक संदर्भ प्रकार और आईडी शामिल होती है जो इसे मूल घटना (जमा, सदस्यता नवीनीकरण, योजना परिवर्तन, आदि) से जोड़ती है।
अपनी आवश्यकताओं के लिए सही योजना खोजने के लिए सार्वजनिक /billing/plans समापन बिंदु का उपयोग करके उपलब्ध योजनाओं की जाँच करें।
साइन अप करें और डैशबोर्ड में सेटिंग > बिलिंग पर नेविगेट करें।
अपने वॉलेट में धनराशि जोड़ें: 'जमा' पर क्लिक करें, भुगतान प्रदाता और क्रिप्टोकरेंसी चुनें, राशि दर्ज करें।
उत्पन्न पते का उपयोग करके क्रिप्टो भुगतान पूरा करें। ब्लॉकचेन पुष्टि के बाद आपका वॉलेट अपडेट हो जाता है।
किसी योजना की सदस्यता लें. सदस्यता शुल्क आपके वॉलेट बैलेंस से काट लिया जाता है।
बिलिंग अनुभाग में अपने वॉलेट शेष और लेनदेन इतिहास की निगरानी करें।
यह सुनिश्चित करने के लिए कि आपके वॉलेट में अगले नवीनीकरण के लिए पर्याप्त धनराशि है, लो-बैलेंस अलर्ट सेट करें।
# List available plans (public -- no auth required)
curl -s https://api.magicgate.io/api/v1/billing/plans | jq '.data'
# Check enabled payment providers (public)
curl -s https://api.magicgate.io/api/v1/billing/providers | jq '.data'
# { "ccpayment": true, "nowpayments": true, "transvoucher": false }Magicgate डैशबोर्ड को प्रभावी ढंग से नेविगेट करें। विश्लेषणात्मक दृश्य, प्रवाह प्रबंधन, सेटिंग पैनल और वास्तविक समय में अपने ट्रैफ़िक फ़िल्टरिंग की निगरानी करने के तरीके को समझें।
Magicgate डैशबोर्ड ट्रैफ़िक प्रवाह को प्रबंधित करने, विश्लेषण की निगरानी करने और खाता सेटिंग्स कॉन्फ़िगर करने के लिए आपका केंद्रीय नियंत्रण कक्ष है। लॉग इन करने के बाद, आप अवलोकन पृष्ठ पर पहुंच जाते हैं जो आपके खाते के प्रमुख मैट्रिक्स का सारांश दिखाता है।
अवलोकन पृष्ठ संसाधित किए गए कुल चेक, निर्णय वितरण (ऑफर बनाम व्हाइट), सक्रिय प्रवाह और हाल की गतिविधि प्रदर्शित करता है। समय-श्रृंखला चार्ट पिछले 24 घंटों, 7 दिनों या 30 दिनों में ट्रैफ़िक की मात्रा दिखाता है। इससे आपको अपने ट्रैफ़िक स्वास्थ्य और फ़िल्टरिंग प्रभावशीलता का तत्काल पता चलता है।
प्रवाह अनुभाग वह जगह है जहां आप ट्रैफ़िक प्रवाह बनाते और प्रबंधित करते हैं। प्रत्येक प्रवाह एक अलग फ़िल्टरिंग कॉन्फ़िगरेशन का प्रतिनिधित्व करता है - फ़िल्टर का एक सेट, एक ऑफ़र पेज यूआरएल, एक सफेद पेज यूआरएल, और एकीकरण सेटिंग्स (API Mode या Direct Mode)। आपके पास विभिन्न अभियानों, लैंडिंग पृष्ठों या ट्रैफ़िक स्रोतों के लिए एकाधिक प्रवाह हो सकते हैं।
प्रत्येक प्रवाह के विस्तृत दृश्य के भीतर, आप प्रति-प्रवाह विश्लेषण देख सकते हैं: कुल जाँच, निर्णय विश्लेषण, फ़िल्टर हिट दरें, भौगोलिक वितरण और शीर्ष संदर्भकर्ता। यह विस्तृत डेटा आपको प्रत्येक विशिष्ट अभियान के लिए फ़िल्टर सेटिंग्स को अनुकूलित करने में मदद करता है।
एनालिटिक्स अनुभाग सभी प्रवाहों पर एक व्यापक दृश्य प्रदान करता है। चार्ट में समय के साथ फैसले के रुझान, फ़िल्टर प्रभावशीलता (जो फ़िल्टर सबसे अधिक बार ट्रिगर होते हैं), ट्रैफ़िक उत्पत्ति, डिवाइस और ब्राउज़र ब्रेकडाउन और प्रति घंटा ट्रैफ़िक पैटर्न दिखाने वाले भौगोलिक हीटमैप शामिल होते हैं। सभी चार्ट दिनांक सीमा फ़िल्टरिंग और प्रवाह-विशिष्ट फ़िल्टरिंग का समर्थन करते हैं।
डोमेन अनुभाग सभी कॉन्फ़िगर किए गए डोमेन (साझा और कस्टम) को सूचीबद्ध करता है। प्रत्येक डोमेन के लिए, आप उसकी स्थिति (सक्रिय, लंबित सत्यापन, डीएनएस त्रुटि), एसएसएल प्रमाणपत्र स्थिति और संबंधित प्रवाह देख सकते हैं। डोमेन स्वास्थ्य जांच स्वचालित रूप से चलती है और DNS या SSL समस्याओं का पता चलने पर आपको सचेत करती है।
सेटिंग्स अनुभाग में खाता-व्यापी कॉन्फ़िगरेशन शामिल है। एपीआई कुंजी: वैकल्पिक समाप्ति तिथियों के साथ API keys उत्पन्न और प्रबंधित करें। Webhooks: वेबहुक एंडपॉइंट कॉन्फ़िगर करें और डिलीवरी लॉग देखें। प्रदाता: भुगतान और DNS प्रदाताओं को जोड़ें और प्रबंधित करें। बिलिंग: वॉलेट बैलेंस, टॉप-अप इतिहास और सदस्यता स्थिति देखें। टीम: भूमिका-आधारित पहुंच (उपयोगकर्ता, व्यवस्थापक) के साथ टीम के सदस्यों को आमंत्रित करें।
डैशबोर्ड प्रकाश और अंधेरे दोनों थीम का समर्थन करता है, थीम शीर्ष-दाएं कोने में टॉगल के साथ है। सभी पेज उत्तरदायी हैं और मोबाइल उपकरणों पर काम करते हैं, हालांकि डेस्कटॉप अनुभव सबसे व्यापक डेटा दृश्य प्रदान करता है।