Όλα όσα χρειάζεστε για να ενσωματώσετε και να διαμορφώσετε το Magicgate για τις ανάγκες φιλτραρίσματος της κυκλοφορίας.
Ξεκινήστε με το Magicgate σε λιγότερο από 5 λεπτά. Αυτός ο οδηγός σας καθοδηγεί στη δημιουργία της πρώτης σας ροής επισκεψιμότητας, στη διαμόρφωση βασικών φίλτρων και στη δοκιμή με το API.
Το Magicgate διαχωρίζει την επισκεψιμότητα bot από τους πραγματικούς χρήστες αξιολογώντας κάθε επισκέπτη σε σχέση με ένα διαμορφώσιμο σύνολο φίλτρων. Η πλατφόρμα επιστρέφει μια ετυμηγορία -- είτε "λευκό" (bot/crawler/unwanted) είτε "προσφορά" (πραγματικός χρήστης) -- σε λιγότερο από 10 χιλιοστά του δευτερολέπτου.
Υπάρχουν δύο τρόποι ολοκλήρωσης. Το API Mode σάς επιτρέπει να στέλνετε χαρακτηριστικά επισκέπτη μέσω ενός τερματικού σημείου REST και να λαμβάνετε μια ετυμηγορία JSON σύμφωνα με την οποία η εφαρμογή σας ενεργεί. Το Direct Mode χειρίζεται τα πάντα αυτόματα: τοποθετήστε τον τομέα σας στο Magicgate και οι επισκέπτες φιλτράρονται και ανακατευθύνονται χωρίς αλλαγές στον κώδικα από την πλευρά σας.
Αυτή η γρήγορη εκκίνηση εστιάζει στο API Mode γιατί σας δίνει τον μεγαλύτερο έλεγχο και τον ταχύτερο βρόχο ανάδρασης κατά την ανάπτυξη. Μόλις αισθανθείτε άνετα, μπορείτε να μεταβείτε στο Direct Mode για αναπτύξεις παραγωγής όπου προτιμάται η ενσωμάτωση μηδενικού κώδικα.
Εγγραφείτε στο magicgate.io και επαληθεύστε τη διεύθυνση email σας. Θα προσγειωθείτε στο ταμπλό με έναν νέο χώρο εργασίας.
Μεταβείτε στις Ροές και κάντε κλικ στο «Δημιουργία ροής». Δώστε του ένα περιγραφικό όνομα (π.χ. "Σελίδα προορισμού - Κίνηση ΗΠΑ"). Επιλέξτε API Mode ως τύπο ενσωμάτωσης.
Διαμορφώστε τουλάχιστον ένα φίλτρο. Για μια βασική ρύθμιση, ενεργοποιήστε το GeoIP (χώρες-στόχοι) και τον εντοπισμό ρομπότ (αποκλεισμός γνωστών ανιχνευτών). Μπορείτε να προσθέσετε περισσότερα φίλτρα αργότερα.
Ορίστε τη διεύθυνση URL της σελίδας προσφοράς (όπου θα πρέπει να προσγειώνονται οι πραγματικοί χρήστες) και τη διεύθυνση URL της Λευκής Σελίδας (όπου ανακατευθύνονται τα bots).
Αποθηκεύστε τη ροή. Αντιγράψτε την ετικέτα ροής και το API key από τη σελίδα Ρυθμίσεις.
Στείλτε ένα αίτημα δοκιμής χρησιμοποιώντας το cURL ή το πρόγραμμα-πελάτη HTTP που προτιμάτε (δείτε παραδείγματα παρακάτω).
Ελέγξτε την καρτέλα Analytics του πίνακα ελέγχου για να δείτε το αίτημά σας δοκιμής να εμφανίζεται με ανάλυση ετυμηγορίας και φίλτρου.
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 προσδιορίζει και ταξινομεί την κυκλοφορία bot χρησιμοποιώντας 29+ διαμορφώσιμα φίλτρα, ευφυΐα IP σε πραγματικό χρόνο και ανάλυση συμπεριφοράς.
Το Magicgate αξιολογεί κάθε εισερχόμενο επισκέπτη σε σχέση με έναν αγωγό ανίχνευσης πολλαπλών επιπέδων. Κάθε φίλτρο λειτουργεί ανεξάρτητα και συμβάλλει στην τελική ετυμηγορία. Ολόκληρη η αξιολόγηση ολοκληρώνεται σε λιγότερο από 10 χιλιοστά του δευτερολέπτου, εξασφαλίζοντας μηδενική αισθητή καθυστέρηση για πραγματικούς χρήστες.
Ο αγωγός ανίχνευσης χωρίζεται σε διάφορες κατηγορίες: έλεγχοι σε επίπεδο δικτύου (φήμη IP, GeoIP, VPN/proxy/Tor ανίχνευση, αναγνώριση κέντρου δεδομένων), έλεγχοι σε επίπεδο προγράμματος περιήγησης (ανάλυση παράγοντα χρήστη, δακτυλικά αποτυπώματα JavaScript, συνέπεια κεφαλίδας), έλεγχοι συμπεριφοράς (μοτίβο ελέγχου ταχύτητας βάσης σύνδεσης και μοτίβο εγκυρότητας βάσης σύνδεσης), μοτίβο ελέγχου ταχύτητας και λίστας αναφοράς (λίστες αποκλεισμού, λίστες επιτρεπόμενων, φιλτράρισμα ISP).
Κάθε φίλτρο μπορεί να ενεργοποιηθεί ή να απενεργοποιηθεί μεμονωμένα ανά ροή. Αυτό το λεπτομερές χειριστήριο σάς επιτρέπει να προσαρμόσετε τον εντοπισμό για διαφορετικές πηγές κυκλοφορίας. Για παράδειγμα, μια καμπάνια που στοχεύει χρήστες κινητών στις ΗΠΑ μπορεί να ενεργοποιήσει το GeoIP (μόνο στις ΗΠΑ), τον εντοπισμό VPN/μεσολάβησης και την επαλήθευση κινητής συσκευής, ενώ απενεργοποιεί το φιλτράρισμα ISP.
Το φιλτράρισμα GeoIP χρησιμοποιεί τοπικά φιλοξενούμενες βάσεις δεδομένων MaxMind που ενημερώνονται εβδομαδιαία για αναζητήσεις μηδενικού λανθάνοντος χρόνου. Μπορείτε να στοχεύσετε ή να εξαιρέσετε την επισκεψιμότητα ανά χώρα, περιοχή ή πόλη. Η βάση δεδομένων καλύπτει διευθύνσεις IPv4 και IPv6 με ακρίβεια 99,8% σε επίπεδο χώρας.
Η ανίχνευση VPN, διακομιστή μεσολάβησης και Tor συνδυάζει πολλαπλές εμπορικές βάσεις δεδομένων και βάσεις δεδομένων ανοιχτού κώδικα. Το Magicgate διατηρεί μια συνεχώς ενημερωμένη λίστα με γνωστούς κόμβους εξόδου VPN, δημόσιους και ιδιωτικούς διακομιστές μεσολάβησης, ρελέ εξόδου Tor και οικιακά δίκτυα μεσολάβησης. Η ανίχνευση καλύπτει το εύρος IPv4 και IPv6.
Η ανίχνευση κέντρου δεδομένων προσδιορίζει την επισκεψιμότητα που προέρχεται από παρόχους cloud (AWS, GCP, Azure, DigitalOcean, OVH, Hetzner και 200+ άλλοι). Αυτό είναι ιδιαίτερα αποτελεσματικό στην σύλληψη αυτοματοποιημένων σεναρίων και προγραμμάτων περιήγησης χωρίς κεφάλι που εκτελούνται σε εικονικές μηχανές.
Η ανάλυση παράγοντα χρήστη αναλύει τη συμβολοσειρά παράγοντα χρήστη του επισκέπτη σε σχέση με μια βάση δεδομένων γνωστών προγραμμάτων ανίχνευσης, ρομπότ και αυτοματοποιημένων εργαλείων. Εντοπίζει επίσης ασυνέπειες -- για παράδειγμα, ένας παράγοντας χρήστη που ισχυρίζεται ότι είναι ο Chrome στα Windows αλλά στέλνει κεφαλίδες ειδικά για το Linux.
Το φίλτρο λίστας αποκλεισμού σάς επιτρέπει να διατηρείτε προσαρμοσμένες λίστες διευθύνσεων IP, περιοχών IP (σημείωση CIDR) και μοτίβων παράγοντα χρήστη που πρέπει πάντα να ταξινομούνται ως bots. Αντίθετα, το φίλτρο της λίστας επιτρεπόμενων σάς επιτρέπει τη λίστα επιτρεπόμενων αξιόπιστων IP (όπως η δική σας υποδομή δοκιμών) που πρέπει πάντα να περνάνε.
Η επικύρωση παραπομπής ελέγχει την κεφαλίδα του 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 είναι ένας δρομολογητής κυκλοφορίας. Κάθε επισκέπτης αξιολογείται με βάση τα διαμορφωμένα φίλτρα σας και εκχωρείται μια ετυμηγορία: "προσφορά" (νόμιμος χρήστης) ή "λευκό" (bot, πρόγραμμα ανίχνευσης ή ανεπιθύμητη επισκεψιμότητα). Η ετυμηγορία καθορίζει πού θα ανακατευθυνθεί ο επισκέπτης.
Η σελίδα προσφοράς είναι η πραγματική σελίδα προορισμού, η σελίδα προσφοράς ή η διοχέτευση μετατροπής -- η σελίδα που θέλετε να βλέπουν οι πραγματικοί άνθρωποι. Η Λευκή Σελίδα είναι ένα δόλωμα ή καλοήθης σελίδα που εμφανίζεται σε bots, προγράμματα ανίχνευσης και αναθεωρητές του δικτύου διαφημίσεων. Οι κοινές λευκές σελίδες περιλαμβάνουν απλές αναρτήσεις ιστολογίου, άρθρα ειδήσεων ή γενικό ενημερωτικό περιεχόμενο.
Αυτός ο διαχωρισμός είναι απαραίτητος για την προστασία της καμπάνιας. Οι αναθεωρητές συμμόρφωσης του δικτύου διαφημίσεων, τα ρομπότ απάτης και οι ανταγωνιστές βλέπουν τη λευκή σελίδα, ενώ οι γνήσιοι χρήστες από το κοινό-στόχο σας φτάνουν στη σελίδα προσφοράς. Η δρομολόγηση γίνεται με διαφάνεια και με ταχύτητα καλωδίου.
Στην Direct Mode, η δρομολόγηση είναι πλήρως αυτόματη. Κατευθύνετε το DNS του τομέα σας στο Magicgate και η πλατφόρμα χειρίζεται ολόκληρο τον κύκλο ζωής του αιτήματος: λήψη του επισκέπτη, αξιολόγηση φίλτρων και έκδοση ανακατεύθυνσης HTTP (302 από προεπιλογή) στον κατάλληλο προορισμό. Ο επισκέπτης δεν βλέπει ποτέ μια ενδιάμεση σελίδα.
Στο API Mode, η εφαρμογή σας καλεί το τελικό σημείο /api/v1/check με χαρακτηριστικά επισκέπτη και λαμβάνει μια απάντηση JSON που περιέχει την ετυμηγορία και τη προτεινόμενη διεύθυνση URL ανακατεύθυνσης. Στη συνέχεια, η εφαρμογή σας χειρίζεται την ίδια την ανακατεύθυνση. Αυτό σας δίνει τον πλήρη έλεγχο της εμπειρίας χρήστη -- μπορείτε να προσθέσετε προσαρμοσμένη λογική, καταγραφή ή δοκιμή A/B πριν από την ανακατεύθυνση.
Το Magicgate υποστηρίζει τρεις λειτουργίες εμφάνισης για τη δρομολόγηση επισκεπτών. Η "Ανακατεύθυνση" (προεπιλογή) εκδίδει μια ανακατεύθυνση HTTP στη διεύθυνση URL προορισμού. Το "Proxy" εξυπηρετεί το περιεχόμενο της σελίδας προορισμού στην αρχική διεύθυνση URL χωρίς αλλαγή της γραμμής διευθύνσεων του προγράμματος περιήγησης. Το 'Iframe' φορτώνει τη σελίδα προορισμού μέσα σε ένα iframe στην αρχική διεύθυνση URL. Η λειτουργία εμφάνισης μπορεί να διαμορφωθεί ανά ροή.
Οι ετυμηγορίες επεξεργάζονται συγχρονισμένα και αποθηκεύονται προσωρινά στην κρυφή μνήμη για να χειρίζονται γρήγορα διαδοχικά αιτήματα από τον ίδιο επισκέπτη (π.χ. φόρτωση πόρων σελίδας μετά την αρχική ανακατεύθυνση). Η κρυφή μνήμη TTL μπορεί να διαμορφωθεί ανά ροή, με προεπιλογή 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 είναι μια προγραμματική ενοποίηση. Η εφαρμογή σας στέλνει ένα αίτημα POST στο τελικό σημείο /api/v1/check με χαρακτηριστικά επισκέπτη (διεύθυνση IP, παράγοντας χρήστη, παραπομπή, κ.λπ.) και λαμβάνει μια απάντηση JSON που περιέχει την ετυμηγορία. Στη συνέχεια, ο κώδικάς σας χειρίζεται τη δρομολόγηση -- ανακατευθύνει τα bots στη λευκή σελίδα και επιτρέπει σε πραγματικούς χρήστες να περάσουν. Αυτή η λειτουργία απαιτεί να γράψετε κώδικα ενσωμάτωσης, αλλά σας δίνει τον πλήρη έλεγχο της ροής αιτημάτων.
Η Direct Mode είναι μια ενοποίηση σε επίπεδο DNS. Μπορείτε να διαμορφώσετε τις εγγραφές DNS του τομέα σας (CNAME σε proxy.magicgate.io ή ALIAS/ANAME για τομείς ρίζας) ώστε να παραπέμπουν στο Magicgate. Όταν φθάνει ένας επισκέπτης, το Magicgate παρεμποδίζει με διαφάνεια το αίτημα, αξιολογεί τον επισκέπτη και εκδίδει μια ανακατεύθυνση HTTP είτε στη σελίδα προσφοράς είτε στη λευκή σελίδα. Δεν χρειάζονται αλλαγές κώδικα στην εφαρμογή σας -- ολόκληρο το επίπεδο φιλτραρίσματος και δρομολόγησης βρίσκεται μπροστά από τον διακομιστή προέλευσης.
Πλεονεκτήματα API Mode: Πλήρης έλεγχος στη λογική δρομολόγησης. Μπορείτε να προσθέσετε προσαρμοσμένη επεξεργασία μεταξύ της λήψης της ετυμηγορίας και της ανακατεύθυνσης του χρήστη -- καταγραφή, ανάθεση δοκιμής A/B, ρύθμιση cookie, συμβάντα αναλυτικών στοιχείων ή λογική υπό όρους βάσει των μεταδεδομένων ετυμηγορίας. Το API Mode λειτουργεί με οποιαδήποτε στοίβα backend και δεν απαιτεί αλλαγές DNS. Είναι επίσης ιδανικό για εφαρμογές μιας σελίδας (SPA) όπου η JavaScript από την πλευρά του πελάτη πραγματοποιεί την κλήση ελέγχου.
Μειονεκτήματα API Mode: Απαιτεί αλλαγές κώδικα στην εφαρμογή σας. Πρέπει να χειριστείτε την κλήση API, τις περιπτώσεις σφαλμάτων (χρονικά όρια, όρια ρυθμών) και τη λογική ανακατεύθυνσης. Η κλήση API προσθέτει ένα δίκτυο μετ' επιστροφής στο χρόνο φόρτωσης της σελίδας σας (συνήθως 10-50 ms ανάλογα με τη γεωγραφική εγγύτητα στο άκρο του Magicgate).
Πλεονεκτήματα Direct Mode: Μηδενικές αλλαγές κωδικών. Σημειώστε το DNS σας και διαμορφώστε τη ροή σας -- οι επισκέπτες φιλτράρονται και ανακατευθύνονται αυτόματα. Η Direct Mode είναι πιο γρήγορη για τον τελικό χρήστη επειδή δεν υπάρχει επιπλέον API μετ' επιστροφής. το φιλτράρισμα γίνεται στο άκρο ως μέρος της ανάλυσης DNS και του αρχικού αιτήματος HTTP. Χειρίζεται επίσης με διαφάνεια όλες τις περιπτώσεις άκρων (χρονικά όρια, επαναλήψεις).
Μειονεκτήματα Direct Mode: Λιγότερος έλεγχος στη διαδικασία δρομολόγησης. Δεν μπορείτε να εισάγετε προσαρμοσμένη λογική μεταξύ της ετυμηγορίας και της ανακατεύθυνσης. Οι αλλαγές στο DNS διαδίδονται αργά (από λεπτά σε ώρες), γεγονός που κάνει τη δοκιμή και την επαναφορά πιο αργή. Η Direct Mode απαιτεί η λευκή σας σελίδα και η σελίδα προσφοράς να είναι προσβάσιμες μέσω δημόσιων διευθύνσεων URL.
Είναι επίσης δυνατή μια υβριδική προσέγγιση. Χρησιμοποιήστε Direct Mode για τις κύριες σελίδες προορισμού σας (όπου η ενσωμάτωση μηδενικού κωδικού είναι προτεραιότητα) και API Mode για συγκεκριμένα τελικά σημεία που χρειάζονται προσαρμοσμένο χειρισμό ετυμηγορίας (π.χ. υποβολές φορμών, τελικά σημεία API ή ροές ολοκλήρωσης αγοράς).
# ---- 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 και βελτιωμένα σήματα εμπιστοσύνης με δίκτυα διαφημίσεων.
Οι προσαρμοσμένοι τομείς σάς επιτρέπουν να χρησιμοποιείτε τη δική σας διεύθυνση URL (π.χ. track.yourbrand.com) αντί για τον κοινόχρηστο τομέα. Αυτό είναι σημαντικό για τη συμμόρφωση με τις διαφημίσεις -- πολλά δίκτυα διαφημίσεων είναι πιο επιεικά με την επισκεψιμότητα που προέρχεται από επώνυμους τομείς παρά από κοινόχρηστους τομείς παρακολούθησης.
Το Magicgate υποστηρίζει τόσο υποτομείς (track.yourbrand.com) όσο και ριζικούς τομείς (yourbrand.com). Οι υποτομείς συνιστώνται επειδή δεν παρεμβαίνουν στη διαμόρφωση DNS του κύριου ιστότοπού σας και είναι ευκολότεροι στη διαχείριση.
Η επαλήθευση τομέα χρησιμοποιεί εγγραφές CNAME που δείχνουν προς proxy.magicgate.io. Όταν προσθέτετε έναν τομέα, διαμορφώνετε μια εγγραφή CNAME από τον τομέα σας σε proxy.magicgate.io. Για ριζικούς τομείς που δεν υποστηρίζουν εγγραφές CNAME, χρησιμοποιήστε μια εγγραφή ALIAS ή ANAME που δείχνει σε proxy.magicgate.io. Το Magicgate επαληθεύει την ιδιοκτησία ελέγχοντας ότι η εγγραφή DNS επιλύεται σωστά στο τελικό σημείο του διακομιστή μεσολάβησης.
Τα πιστοποιητικά SSL παρέχονται αυτόματα μέσω του Let's Encrypt μετά την ολοκλήρωση της διάδοσης του DNS. Το Magicgate χειρίζεται την έκδοση, την ανανέωση και την εγκατάσταση πιστοποιητικού. Ο προσαρμοσμένος τομέας σας θα εξυπηρετεί επισκεψιμότητα μέσω HTTPS με έγκυρο πιστοποιητικό εντός λεπτών από τη διαμόρφωση του DNS.
Για χρήστες Cloudflare, βεβαιωθείτε ότι ο διακομιστής μεσολάβησης (πορτοκαλί σύννεφο) είναι απενεργοποιημένος για την εγγραφή CNAME που δείχνει στο Magicgate. Ο διακομιστής μεσολάβησης του Cloudflare παρεμποδίζει την κυκλοφορία πριν φτάσει στο Magicgate, κάτι που μπορεί να επηρεάσει την αξιολόγηση των επισκεπτών. Ρυθμίστε την εγγραφή σε λειτουργία «μόνο DNS» (γκρι σύννεφο).
Μπορείτε επίσης να αγοράσετε τομείς απευθείας μέσω της αγοράς του Magicgate. Αυτοί οι τομείς είναι προρυθμισμένοι και έτοιμοι για άμεση χρήση -- δεν απαιτείται ρύθμιση ή επαλήθευση DNS. Η αγορά προσφέρει μια επιλογή καθαρών τομέων κατάλληλων για καμπάνιες επισκεψιμότητας.
Μεταβείτε στις Ρυθμίσεις > Τομείς και κάντε κλικ στην «Προσθήκη τομέα». Εισαγάγετε τον προσαρμοσμένο τομέα σας (π.χ. track.yourbrand.com).
Προσθέστε μια εγγραφή CNAME στον πάροχο DNS σας: Όνομα = ο τομέας σας, Τιμή = proxy.magicgate.io. Για ριζικούς τομείς, χρησιμοποιήστε το ALIAS/ANAME εάν ο πάροχος σας δεν υποστηρίζει το CNAME σε τομείς κορυφής. Η διάδοση του DNS μπορεί να διαρκέσει έως και 24 ώρες.
Κάντε κλικ στην «Επαλήθευση DNS» στον πίνακα ελέγχου του Magicgate. Μόλις επαληθευτεί, παρέχεται αυτόματα ένα πιστοποιητικό 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Ρυθμίστε webhook για να λαμβάνετε ειδοποιήσεις σε πραγματικό χρόνο για συμβάντα κυκλοφορίας. Μάθετε σχετικά με τη δομή ωφέλιμου φορτίου, τη λογική επανάληψης, την επαλήθευση υπογραφής και τους τύπους συμβάντων.
Το Webhooks σάς επιτρέπει να λαμβάνετε ειδοποιήσεις HTTP POST σε πραγματικό χρόνο όταν συμβαίνουν σημαντικά συμβάντα στον λογαριασμό σας Magicgate -- όπως αλλαγές ροής, επαλήθευση τομέα ή ενημερώσεις πληρωμών.
Το Magicgate υποστηρίζει συμβάντα webhook σε πολλές κατηγορίες: συμβάντα ροής (flow.created, flow.updated, flow.deleted), συμβάντα τομέα (domain.added, domain.verified, domain.deleted, domain.registration_failed,pagewhite_events. white_page.deleted), συμβάντα μαύρης λίστας (blacklist.created, blacklist.updated, blacklist.deleted), API key συμβάντα (apikey.created, apikey.deleted, apikey.activated, apikey.deactivated (⟧,PH1 συμβάντα), πορτοφόλι wallet.debited), συμβάντα συνδρομής (subscription.changed, subscription.canceled, subscription.plan_changed και πολλά άλλα), συμβάντα χρέωσης (payment.completed, payment.failed) και συμβάντα υποστήριξης (ticket.created, ⟧, PH20⟧, ticket.replied ticket.closed).
Κάθε παράδοση webhook περιλαμβάνει τρεις κεφαλίδες ασφαλείας: X-Webhook-Signature (HMAC-SHA256 hex digest), X-Webhook-Timestamp (χρονοσήμανση Unix) και X-Webhook-ID (αναγνωριστικό σημείου τέλους). Η υπογραφή καλύπτει τη χρονική σήμανση και το σώμα μαζί -- υπολογιζόμενο ως HMAC-SHA256 (secret, timestamp + '.' + body) -- το οποίο αποτρέπει τόσο τις επιθέσεις παραποίησης όσο και τις επιθέσεις επανάληψης. Θα πρέπει να επαληθεύσετε την υπογραφή και να απορρίψετε αιτήματα με χρονικές σφραγίδες παλαιότερες των 5 λεπτών. Το μυστικό υπογραφής δημιουργείται όταν δημιουργείτε το τελικό σημείο του webhook και εμφανίζεται μία φορά -- αποθηκεύστε το με ασφάλεια.
Το Magicgate επαναλαμβάνει αποτυχημένες παραδόσεις webhook. Εάν το τελικό σημείο σας επιστρέψει έναν κωδικό κατάστασης που δεν είναι 2xx ή δεν ανταποκριθεί εντός 10 δευτερολέπτων, η παράδοση επαναλαμβάνεται. Αφού εξαντληθούν όλες οι επαναλήψεις, το συμβάν επισημαίνεται ως αποτυχημένο και ο αριθμός αποτυχιών του τελικού σημείου αυξάνεται.
Τα ωφέλιμα φορτία Webhook κωδικοποιούνται με JSON με τη δομή: { id, event, timestamp, data }. Το πεδίο "συμβάν" περιέχει τη συμβολοσειρά τύπου συμβάντος (π.χ. "domain.verified"), το "αναγνωριστικό" είναι ένα μοναδικό αναγνωριστικό παράδοσης για ανικανότητα, η "χρονική σήμανση" είναι μια ώρα ημερομηνίας ISO 8601 και τα "δεδομένα" περιέχουν λεπτομέρειες για συγκεκριμένο συμβάν.
Μπορείτε να διαμορφώσετε πολλά τελικά σημεία webhook ανά λογαριασμό, καθένα από τα οποία έχει εγγραφεί σε διαφορετικούς τύπους συμβάντων. Αυτό σας επιτρέπει να δρομολογείτε συμβάντα τομέα στον αγωγό ανάπτυξης και τα συμβάντα χρέωσης στο λογιστικό σας σύστημα, για παράδειγμα.
Μεταβείτε στις Ρυθμίσεις > Webhooks στον πίνακα ελέγχου του Magicgate.
Κάντε κλικ στην «Προσθήκη σημείου λήξης» και εισαγάγετε τη διεύθυνση URL του webhook σας (πρέπει να είναι HTTPS).
Επιλέξτε τους τύπους συμβάντων που θέλετε να λαμβάνετε (flow.created, domain.verified, payment.completed, κ.λπ.).
Αντιγράψτε το μυστικό υπογραφής που εμφανίζεται μετά τη δημιουργία. Αποθηκεύστε το στις μεταβλητές του περιβάλλοντος σας.
Εφαρμόστε ένα πρόγραμμα χειρισμού webhook στον διακομιστή σας που λαμβάνει αιτήματα POST και επαληθεύει την υπογραφή.
Δοκιμάστε το webhook χρησιμοποιώντας το κουμπί "Αποστολή δοκιμαστικής εκδήλωσης" στον πίνακα εργαλείων.
Παρακολουθήστε την κατάσταση παράδοσης στην καρτέλα Καταγραφή 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. Κάθε πάροχος υποστηρίζει Bitcoin, Ethereum, USDT, USDC και 50+ επιπλέον κρυπτονομίσματα. Όταν ξεκινάτε μια κατάθεση, δημιουργείται μια διεύθυνση πληρωμής και ένα ποσό. Μόλις το blockchain επιβεβαιώσει τη συναλλαγή, το υπόλοιπο του πορτοφολιού σας ενημερώνεται αυτόματα.
Τα σχέδια καθορίζουν τα όρια δυνατοτήτων σας: έλεγχοι ανά μήνα, αριθμός ροών, κανόνες ανά ροή, πρόσβαση API, προσαρμοσμένοι τομείς και πολλά άλλα. Μπορείτε να δείτε τα διαθέσιμα σχέδια χωρίς έλεγχο ταυτότητας. Η αναβάθμιση ή η υποβάθμιση τίθεται σε ισχύ αμέσως -- το αχρησιμοποίητο υπόλοιπο της τρέχουσας περιόδου καταλογίζεται και πιστώνεται πίσω στο πορτοφόλι σας.
Οι συνδρομές μπορεί να είναι μηνιαίες ή ετήσιες. Οι ετήσιες συνδρομές προσφέρουν έκπτωση. Μπορείτε να ακυρώσετε ανά πάσα στιγμή -- η συνδρομή παραμένει ενεργή μέχρι το τέλος της τρέχουσας περιόδου χρέωσης. Η συνέχιση μιας ακυρωμένης συνδρομής την επαναφέρει χωρίς τη δημιουργία νέας.
Το πορτοφόλι παρακολουθεί όλες τις συναλλαγές: καταθέσεις, χρεώσεις συνδρομής, επιστροφές χρημάτων και πιστώσεις αναλογίας. Κάθε συναλλαγή περιλαμβάνει έναν τύπο αναφοράς και ένα αναγνωριστικό που τη συνδέει με το αρχικό συμβάν (κατάθεση, ανανέωση συνδρομής, αλλαγή προγράμματος κ.λπ.).
Ελέγξτε τα διαθέσιμα σχέδια χρησιμοποιώντας το δημόσιο τελικό σημείο /billing/plans για να βρείτε το σωστό σχέδιο για τις ανάγκες σας.
Εγγραφείτε και μεταβείτε στις Ρυθμίσεις > Χρέωση στον πίνακα ελέγχου.
Προσθέστε χρήματα στο πορτοφόλι σας: κάντε κλικ στην «Κατάθεση», επιλέξτε πάροχο πληρωμών και κρυπτονόμισμα, εισαγάγετε το ποσό.
Ολοκληρώστε την πληρωμή με κρυπτογράφηση χρησιμοποιώντας τη διεύθυνση που δημιουργήθηκε. Το πορτοφόλι σας ενημερώνεται μετά την επιβεβαίωση του blockchain.
Εγγραφείτε σε ένα πρόγραμμα. Η χρέωση της συνδρομής αφαιρείται από το υπόλοιπο του πορτοφολιού σας.
Παρακολουθήστε το υπόλοιπο του πορτοφολιού σας και το ιστορικό συναλλαγών στην ενότητα Χρέωση.
Ρυθμίστε ειδοποιήσεις χαμηλού υπολοίπου για να βεβαιωθείτε ότι το πορτοφόλι σας έχει επαρκή χρήματα για την επόμενη ανανέωση.
# 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 ημέρες. Αυτό σας δίνει μια άμεση αίσθηση της υγείας της κυκλοφορίας και της αποτελεσματικότητας του φιλτραρίσματος.
Η ενότητα Ροές είναι όπου δημιουργείτε και διαχειρίζεστε τις ροές κυκλοφορίας. Κάθε ροή αντιπροσωπεύει μια ξεχωριστή διαμόρφωση φιλτραρίσματος -- ένα σύνολο φίλτρων, μια διεύθυνση URL σελίδας προσφοράς, μια διεύθυνση URL λευκής σελίδας και ρυθμίσεις ενοποίησης (API Mode ή Direct Mode). Μπορείτε να έχετε πολλές ροές για διαφορετικές καμπάνιες, σελίδες προορισμού ή πηγές επισκεψιμότητας.
Στην προβολή λεπτομερειών κάθε ροής, μπορείτε να δείτε αναλυτικά στοιχεία ανά ροή: συνολικούς ελέγχους, ανάλυση ετυμηγοριών, ποσοστά επισκέψεων φίλτρου, γεωγραφική κατανομή και κορυφαία σημεία παραπομπής. Αυτά τα αναλυτικά δεδομένα σάς βοηθούν να βελτιστοποιήσετε τις ρυθμίσεις φίλτρου για κάθε συγκεκριμένη καμπάνια.
Η ενότητα Analytics παρέχει μια ολοκληρωμένη προβολή σε όλες τις ροές. Τα γραφήματα περιλαμβάνουν τάσεις ετυμηγορίας με την πάροδο του χρόνου, αποτελεσματικότητα φίλτρων (τα οποία τα φίλτρα ενεργοποιούνται πιο συχνά), γεωγραφικούς χάρτες θερμότητας που δείχνουν την προέλευση της κυκλοφορίας, αναλύσεις συσκευών και προγράμματος περιήγησης και ωριαία μοτίβα κυκλοφορίας. Όλα τα γραφήματα υποστηρίζουν φιλτράρισμα εύρους ημερομηνιών και φιλτράρισμα συγκεκριμένης ροής.
Η ενότητα Τομείς παραθέτει όλους τους διαμορφωμένους τομείς (κοινόχρηστους και προσαρμοσμένους). Για κάθε τομέα, μπορείτε να δείτε την κατάστασή του (ενεργή, εκκρεμής επαλήθευση, σφάλμα DNS), την κατάσταση του πιστοποιητικού SSL και τις σχετικές ροές. Οι έλεγχοι υγείας τομέα εκτελούνται αυτόματα και σας ειδοποιούν εάν εντοπιστούν προβλήματα DNS ή SSL.
Η ενότητα "Ρυθμίσεις" περιέχει διαμόρφωση για ολόκληρο τον λογαριασμό. Κλειδιά API: δημιουργία και διαχείριση API key με προαιρετικές ημερομηνίες λήξης. Webhooks: διαμόρφωση τελικών σημείων webhook και προβολή αρχείων καταγραφής παράδοσης. Πάροχοι: προσθήκη και διαχείριση πληρωμών και παρόχων DNS. Χρέωση: δείτε το υπόλοιπο πορτοφολιού, το ιστορικό ανανέωσης και την κατάσταση συνδρομής. Ομάδα: προσκαλέστε μέλη της ομάδας με πρόσβαση βάσει ρόλων (χρήστης, διαχειριστής).
Το ταμπλό υποστηρίζει ανοιχτά και σκοτεινά θέματα, με την εναλλαγή θέματος στην επάνω δεξιά γωνία. Όλες οι σελίδες αποκρίνονται και λειτουργούν σε κινητές συσκευές, αν και η εμπειρία στην επιφάνεια εργασίας παρέχει τις πιο ολοκληρωμένες προβολές δεδομένων.