Wszystko, czego potrzebujesz, aby zintegrować i skonfigurować Magicgate pod kątem swoich potrzeb w zakresie filtrowania ruchu.
Rozpocznij pracę z Magicgate w mniej niż 5 minut. Ten przewodnik przeprowadzi Cię przez proces tworzenia pierwszego przepływu ruchu, konfigurowania podstawowych filtrów i testowania interfejsu API.
Magicgate oddziela ruch botów od rzeczywistych użytkowników, oceniając każdego odwiedzającego na podstawie konfigurowalnego zestawu filtrów. Platforma zwraca werdykt – „biały” (bot/crawler/unwanted) lub „oferta” (prawdziwy użytkownik) – w czasie krótszym niż 10 milisekund.
Istnieją dwa tryby integracji. API Mode umożliwia wysyłanie atrybutów gościa za pośrednictwem punktu końcowego REST i otrzymywanie werdyktu JSON, na podstawie którego działa Twoja aplikacja. Direct Mode wszystko obsługuje automatycznie: wskaż swoją domenę na Magicgate, a odwiedzający zostaną przefiltrowani i przekierowani bez żadnych zmian w kodzie z Twojej strony.
Ten szybki start koncentruje się na API Mode, ponieważ zapewnia największą kontrolę i najszybszą pętlę informacji zwrotnej podczas programowania. Gdy już poczujesz się komfortowo, możesz przejść na Direct Mode w przypadku wdrożeń produkcyjnych, w których preferowana jest integracja bez kodu.
Zarejestruj się na magicgate.io i zweryfikuj swój adres e-mail. Wylądujesz na desce rozdzielczej ze świeżym obszarem roboczym.
Przejdź do Przepływów i kliknij „Utwórz przepływ”. Nadaj mu opisową nazwę (np. „Strona docelowa – ruch w USA”). Wybierz API Mode jako typ integracji.
Skonfiguruj co najmniej jeden filtr. Aby uzyskać podstawową konfigurację, włącz GeoIP (kraje docelowe) i wykrywanie botów (blokuj znane roboty indeksujące). Później możesz dodać więcej filtrów.
Ustaw adres URL strony oferty (gdzie powinni trafiać prawdziwi użytkownicy) i adres URL białej strony (gdzie przekierowywane są boty).
Zapisz przepływ. Skopiuj etykietę przepływu i swój API key ze strony Ustawienia.
Wyślij żądanie testowe za pomocą cURL lub wybranego klienta HTTP (zobacz przykłady poniżej).
Sprawdź kartę Analityka w panelu kontrolnym, aby wyświetlić żądanie testu wraz z werdyktem i zestawieniem filtrów.
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
# }Dowiedz się, w jaki sposób Magicgate identyfikuje i klasyfikuje ruch botów, korzystając z ponad 29 konfigurowalnych filtrów, inteligencji IP w czasie rzeczywistym i analizy behawioralnej.
Magicgate ocenia każdego przychodzącego gościa na podstawie wielowarstwowego potoku wykrywania. Każdy filtr działa niezależnie i ma wpływ na ostateczny werdykt. Cała ocena trwa mniej niż 10 milisekund, zapewniając zerowe zauważalne opóźnienia dla prawdziwych użytkowników.
Proces wykrywania jest podzielony na kilka kategorii: kontrole na poziomie sieci (reputacja IP, wykrywanie GeoIP, VPN/proxy/Tor, identyfikacja centrum danych), kontrole na poziomie przeglądarki (analiza klienta użytkownika, odcisk palca JavaScript, spójność nagłówków), kontrole behawioralne (wzorce kliknięć, prędkość sesji, sprawdzanie poprawności strony odsyłającej) i kontrole oparte na listach (listy bloków, listy dozwolonych, filtrowanie ISP).
Każdy filtr można indywidualnie włączyć lub wyłączyć dla każdego przepływu. Ta szczegółowa kontrola pozwala dostosować wykrywanie do różnych źródeł ruchu. Na przykład kampania skierowana do użytkowników telefonów komórkowych w USA może włączyć wykrywanie GeoIP (tylko w USA), VPN/proxy i weryfikację urządzenia mobilnego, wyłączając filtrowanie ISP.
Filtrowanie GeoIP wykorzystuje lokalnie hostowane bazy danych MaxMind, aktualizowane co tydzień w celu wyszukiwania bez opóźnień. Możesz kierować lub wykluczać ruch według kraju, regionu lub miasta. Baza danych obejmuje adresy IPv4 i IPv6 z dokładnością na poziomie kraju wynoszącą 99,8%.
Wykrywanie VPN, proxy i Tora łączy wiele komercyjnych i otwartych baz danych. Magicgate utrzymuje stale aktualizowaną listę znanych węzłów wyjściowych VPN, publicznych i prywatnych serwerów proxy, przekaźników wyjściowych Tora i domowych sieci proxy. Wykrywanie obejmuje zarówno zakresy IPv4, jak i IPv6.
Wykrywanie centrów danych identyfikuje ruch pochodzący od dostawców usług w chmurze (AWS, GCP, Azure, DigitalOcean, OVH, Hetzner i ponad 200 innych). Jest to szczególnie skuteczne przy przechwytywaniu zautomatyzowanych skryptów i przeglądarek bezgłowych działających na maszynach wirtualnych.
Analiza klienta użytkownika porównuje ciąg znaków klienta użytkownika z bazą danych znanych robotów indeksujących, botów i zautomatyzowanych narzędzi. Wykrywa także niespójności — na przykład klient użytkownika podający się za przeglądarkę Chrome w systemie Windows, ale wysyłający nagłówki specyficzne dla systemu Linux.
Filtr listy blokowanych umożliwia tworzenie niestandardowych list adresów IP, zakresów adresów IP (notacja CIDR) i wzorców agentów użytkownika, które zawsze powinny być klasyfikowane jako boty. Z drugiej strony filtr listy dozwolonych umożliwia dodanie do białej listy zaufanych adresów IP (takich jak własna infrastruktura testowa), które zawsze powinny przechodzić.
Walidacja Referer sprawdza nagłówek HTTP Referer pod kątem oczekiwanych wzorców. Możesz wymagać, aby ruch pochodził z określonych domen (np. Google, Facebook) lub blokować ruch z pustymi, brakującymi lub podejrzanymi stronami odsyłającymi.
# 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
# }Dowiedz się, jak Magicgate kieruje odwiedzających do właściwego miejsca docelowego na podstawie werdyktów filtrów. Zrozumienie modelu białej strony i strony oferty, mechanizmów przekierowań i przetwarzania werdyktów.
W swojej istocie Magicgate jest routerem ruchu. Każdy odwiedzający jest oceniany na podstawie skonfigurowanych filtrów i przypisywany jest mu werdykt: „oferta” (prawowity użytkownik) lub „biały” (bot, robot indeksujący lub niechciany ruch). Od werdyktu zależy, gdzie użytkownik zostanie przekierowany.
Strona oferty to rzeczywista strona docelowa, strona oferty lub ścieżka konwersji — strona, którą chcesz, aby zobaczyli prawdziwi użytkownicy. Biała strona to zwodnicza lub złośliwa strona wyświetlana botom, robotom indeksującym i recenzentom sieci reklamowych. Typowe białe strony obejmują proste wpisy na blogu, artykuły prasowe lub ogólną treść informacyjną.
To oddzielenie jest niezbędne dla ochrony kampanii. Osoby sprawdzające zgodność sieci reklamowej, boty służące do oszustw związanych z kliknięciami oraz konkurenci widzą białą stronę, podczas gdy prawdziwi użytkownicy z Twojej grupy docelowej trafiają na stronę oferty. Trasowanie odbywa się w sposób przejrzysty i z szybkością drutu.
W Direct Mode routing jest w pełni automatyczny. Wskazujesz DNS swojej domeny na Magicgate, a platforma obsługuje cały cykl życia żądania: przyjęcie gościa, ocena filtrów i wydanie przekierowania HTTP (domyślnie 302) do odpowiedniego miejsca docelowego. Odwiedzający nigdy nie widzi strony pośredniej.
W API Mode aplikacja wywołuje punkt końcowy /api/v1/check z atrybutami odwiedzającego i otrzymuje odpowiedź JSON zawierającą werdykt i zalecany adres URL przekierowania. Twoja aplikacja następnie sama obsługuje przekierowanie. Daje to pełną kontrolę nad doświadczeniem użytkownika — przed przekierowaniem możesz dodać niestandardową logikę, rejestrowanie lub testy A/B.
Magicgate obsługuje trzy tryby wyświetlania do kierowania gości. „Przekierowanie” (domyślnie) powoduje przekierowanie HTTP do docelowego adresu URL. „Proxy” udostępnia zawartość strony docelowej pod oryginalnym adresem URL bez zmiany paska adresu przeglądarki. „Iframe” ładuje stronę docelową wewnątrz ramki iframe pod oryginalnym adresem URL. Tryb wyświetlania można konfigurować dla każdego przepływu.
Werdykty są przetwarzane synchronicznie i krótko zapisywane w pamięci podręcznej, aby obsłużyć szybko następujące po sobie żądania od tego samego odwiedzającego (np. ładowanie zasobów strony po początkowym przekierowaniu). TTL pamięci podręcznej można konfigurować dla każdego przepływu, domyślnie wynosi 30 sekund.
# 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
# }Porównaj dwa tryby integracji oferowane przez Magicgate. Dowiedz się, kiedy używać API Mode dla maksymalnej kontroli, a kiedy Direct Mode zapewnia najprostszą ścieżkę wdrożenia.
Magicgate oferuje dwa różne tryby integracji, każdy zaprojektowany dla różnych zastosowań i wymagań technicznych. Wybór odpowiedniego trybu wpływa na złożoność wdrożenia, kontrolę nad doświadczeniem użytkownika i obciążenie operacyjne.
API Mode to integracja programowa. Twoja aplikacja wysyła żądanie POST do punktu końcowego /api/v1/check z atrybutami odwiedzającego (adres IP, klient użytkownika, strona odsyłająca itp.) i otrzymuje odpowiedź JSON zawierającą werdykt. Twój kod następnie obsługuje routing – przekierowując boty na białą stronę i umożliwiając przejście prawdziwym użytkownikom. Ten tryb wymaga napisania kodu integracyjnego, ale zapewnia pełną kontrolę nad przepływem żądań.
Direct Mode to integracja na poziomie DNS. Konfigurujesz rekordy DNS swojej domeny (CNAME do proxy.magicgate.io lub ALIAS/ANAME w przypadku domen głównych), aby wskazywały na Magicgate. Kiedy odwiedzający przybywa, Magicgate w przejrzysty sposób przechwytuje żądanie, ocenia odwiedzającego i generuje przekierowanie HTTP na stronę oferty lub białą stronę. Aplikacja nie wymaga żadnych zmian w kodzie — cała warstwa filtrowania i routingu znajduje się przed serwerem początkowym.
Zalety API Mode: Pełna kontrola nad logiką routingu. Możesz dodać niestandardowe przetwarzanie między otrzymaniem werdyktu a przekierowaniem użytkownika – logowanie, przypisanie testu A/B, ustawienie plików cookie, zdarzenia analityczne lub logikę warunkową opartą na metadanych werdyktu. API Mode działa z dowolnym stosem backendu i nie wymaga zmian w DNS. Jest także idealny do aplikacji jednostronicowych (SPA), gdzie JavaScript po stronie klienta wykonuje wywołanie sprawdzające.
Wady API Mode: Wymaga zmian w kodzie aplikacji. Musisz obsłużyć wywołanie API, przypadki błędów (przekroczenia limitu czasu, limity szybkości) i logikę przekierowań. Wywołanie API dodaje czas ładowania strony w obie strony (zwykle 10–50 ms, w zależności od geograficznej bliskości krawędzi Magicgate).
Zalety Direct Mode: Zero zmian w kodzie. Wskaż DNS i skonfiguruj przepływ — odwiedzający są automatycznie filtrowani i przekierowywani. Direct Mode jest szybszy dla użytkownika końcowego, ponieważ nie ma dodatkowej komunikacji API w obie strony; filtrowanie odbywa się na krawędzi w ramach rozdzielczości DNS i początkowego żądania HTTP. W przejrzysty sposób obsługuje także wszystkie przypadki brzegowe (przekroczenia limitu czasu, ponowne próby).
Wady Direct Mode: Mniejsza kontrola nad procesem routingu. Nie można wprowadzić niestandardowej logiki między werdyktem a przekierowaniem. Zmiany DNS rozprzestrzeniają się powoli (od minut do godzin), co powoduje, że testowanie i wycofywanie zmian jest wolniejsze. Direct Mode wymaga, aby Twoja biała strona i strona z ofertami były dostępne za pośrednictwem publicznych adresów URL.
Możliwe jest również podejście hybrydowe. Użyj Direct Mode dla swoich głównych stron docelowych (gdzie priorytetem jest integracja z zerowym kodem) i API Mode dla określonych punktów końcowych, które wymagają niestandardowej obsługi werdyktów (np. przesyłanie formularzy, punkty końcowe API lub przepływy transakcji).
# ---- 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.Dodaj niestandardowe domeny do swojego konta Magicgate, skonfiguruj rekordy DNS i zarządzaj weryfikacją domeny. Obejmuje integrację z Cloudflare i obsługę certyfikatów SSL.
Każde konto Magicgate ma dostęp do wspólnej domeny (go.magicgate.io) do natychmiastowego użycia. Plany Starter i wyższe umożliwiają dodawanie niestandardowych domen dla markowych adresów URL i ulepszonych sygnałów zaufania w sieciach reklamowych.
Domeny niestandardowe umożliwiają użycie własnego adresu URL (np. track.yourbrand.com) zamiast domeny współdzielonej. Jest to ważne dla zgodności reklam — wiele sieci reklamowych jest łagodniejszych w przypadku ruchu pochodzącego z domen markowych, a nie z udostępnionych domen śledzących.
Magicgate obsługuje zarówno subdomeny (track.yourbrand.com), jak i domeny główne (yourbrand.com). Subdomeny są zalecane, ponieważ nie zakłócają konfiguracji DNS Twojej głównej witryny i są łatwiejsze w zarządzaniu.
Weryfikacja domeny wykorzystuje rekordy CNAME wskazujące na proxy.magicgate.io. Kiedy dodajesz domenę, konfigurujesz rekord CNAME ze swojej domeny na proxy.magicgate.io. W przypadku domen głównych, które nie obsługują rekordów CNAME, użyj zamiast tego rekordu ALIAS lub ANAME wskazującego na proxy.magicgate.io. Magicgate weryfikuje własność, sprawdzając, czy rekord DNS jest poprawnie rozpoznawany jako punkt końcowy proxy.
Certyfikaty SSL są dostarczane automatycznie przez Let's Encrypt po zakończeniu propagacji DNS. Magicgate zajmuje się wydawaniem, odnawianiem i instalacją certyfikatów. Twoja domena niestandardowa będzie obsługiwać ruch przez HTTPS z ważnym certyfikatem w ciągu kilku minut od konfiguracji DNS.
W przypadku użytkowników Cloudflare upewnij się, że serwer proxy (pomarańczowa chmura) jest wyłączony dla rekordu CNAME wskazującego na Magicgate. Serwer proxy Cloudflare przechwytuje ruch, zanim dotrze do Magicgate, co może zakłócać ocenę odwiedzających. Ustaw rekord na tryb „Tylko DNS” (szara chmura).
Możesz także kupić domeny bezpośrednio na rynku Magicgate. Domeny te są wstępnie skonfigurowane i gotowe do natychmiastowego użycia – nie jest wymagana żadna konfiguracja DNS ani weryfikacja. Rynek oferuje wybór czystych domen odpowiednich dla kampanii ruchu.
Przejdź do Ustawienia > Domeny i kliknij „Dodaj domenę”. Wprowadź swoją domenę niestandardową (np. track.yourbrand.com).
Dodaj rekord CNAME u swojego dostawcy DNS: Nazwa = Twoja domena, Wartość = proxy.magicgate.io. W przypadku domen głównych użyj ALIAS/ANAME, jeśli Twój dostawca nie obsługuje CNAME w domenach wierzchołkowych. Propagacja DNS może zająć do 24 godzin.
Kliknij „Zweryfikuj DNS” w panelu kontrolnym Magicgate. Po weryfikacji certyfikat SSL jest udostępniany automatycznie. Status Twojej domeny zmieni się na Aktywny.
# 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 okSkonfiguruj webhooki, aby otrzymywać powiadomienia w czasie rzeczywistym o zdarzeniach drogowych. Dowiedz się więcej o strukturze ładunku, logice ponawiania prób, weryfikacji podpisu i typach zdarzeń.
Webhooks umożliwia otrzymywanie w czasie rzeczywistym HTTP powiadomień POST, gdy na Twoim koncie Magicgate wystąpią ważne zdarzenia – takie jak zmiany przepływu, weryfikacja domeny lub aktualizacje płatności.
Magicgate obsługuje zdarzenia webhooka w wielu kategoriach: zdarzenia przepływu (flow.created, flow.updated, flow.deleted), zdarzenia domeny (domain.added, domain.verified, domain.deleted, domain.registration_failed), zdarzenia białej strony (white_page.ready, white_page.failed, white_page.deleted), zdarzenia na czarnej liście (blacklist.created, blacklist.updated, blacklist.deleted), zdarzenia API key (apikey.created, apikey.deleted, apikey.activated, apikey.deactivated), zdarzenia portfela (wallet.credited, wallet.debited), zdarzenia subskrypcji (subscription.changed, subscription.canceled, subskrypcja.plan_changed i inne), zdarzenia rozliczeniowe (payment.completed, payment.failed) i zdarzenia wsparcia (ticket.created, ticket.replied, ticket.resolved, ticket.closed).
Każdy element webhook zawiera trzy nagłówki zabezpieczeń: X-Webhook-Signature (skrót szesnastkowy HMAC-SHA256), X-Webhook-Timestamp (sygnał czasowy Unix) i X-Webhook-ID (identyfikator punktu końcowego). Podpis obejmuje łącznie znacznik czasu i treść — obliczane jako HMAC-SHA256 (sekret, znacznik czasu + „.” + treść) — co zapobiega zarówno atakom manipulacyjnym, jak i polegającym na ponownym odtwarzaniu. Należy zweryfikować podpis i odrzucić żądania ze znacznikami czasu starszymi niż 5 minut. Sekret podpisywania jest generowany podczas tworzenia punktu końcowego elementu webhook i jest wyświetlany jednokrotnie — przechowuj go w bezpiecznym miejscu.
Magicgate ponawia nieudane dostarczenie elementu webhook. Jeśli punkt końcowy zwróci kod stanu inny niż 2xx lub nie odpowie w ciągu 10 sekund, dostawa zostanie ponowiona. Po wyczerpaniu wszystkich ponownych prób zdarzenie jest oznaczane jako zakończone niepowodzeniem, a liczba niepowodzeń punktu końcowego jest zwiększana.
Ładunki Webhook są kodowane JSON ze strukturą: { id, event, timestamp, data }. Pole „event” zawiera ciąg znaków typu zdarzenia (np. „domain.verified”), „id” to unikalny identyfikator dostarczenia dla idempotencji, „timestamp” to data/godzina ISO 8601, a „data” zawiera szczegółowe informacje dotyczące zdarzenia.
Na konto możesz skonfigurować wiele punktów końcowych webhooka, z których każdy jest subskrybowany do różnych typów zdarzeń. Umożliwia to na przykład kierowanie zdarzeń domenowych do potoku wdrożenia, a zdarzeń rozliczeniowych do systemu księgowego.
Przejdź do opcji Ustawienia > Webhooks na pulpicie nawigacyjnym Magicgate.
Kliknij „Dodaj punkt końcowy” i wprowadź adres URL webhooka (musi to być HTTPS).
Wybierz typy zdarzeń, które chcesz odbierać (flow.created, domain.verified, payment.completed itp.).
Skopiuj sekret podpisu wyświetlony po utworzeniu. Zapisz go w zmiennych środowiskowych.
Zaimplementuj na swoim serwerze moduł obsługi webhooka, który odbiera żądania POST i weryfikuje podpis.
Przetestuj webhook za pomocą przycisku „Wyślij zdarzenie testowe” na pulpicie nawigacyjnym.
Monitoruj status dostawy w zakładce Webhook Logi, aby zweryfikować pomyślny odbiór.
# 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"Poznaj model rozliczeń oparty na portfelu Magicgate, obsługiwanych dostawców płatności i zarządzanie planami. Zarządzaj swoją subskrypcją i depozytami za pośrednictwem pulpitu nawigacyjnego.
Magicgate korzysta z modelu rozliczeń opartego na portfelu. Dodajesz środki do swojego portfela poprzez depozyty kryptowalutowe, a Twoja subskrypcja odnawia się automatycznie z salda portfela w każdym cyklu rozliczeniowym. Eliminuje to konieczność powtarzających się opłat za kartę i zapewnia pełną kontrolę nad wydatkami.
Obsługiwanych jest trzech dostawców płatności: CCPayment, NowPayments i TransVoucher. Każdy dostawca obsługuje Bitcoin, Ethereum, USDT, USDC i ponad 50 dodatkowych kryptowalut. Po zainicjowaniu wpłaty generowany jest adres i kwota płatności. Gdy blockchain potwierdzi transakcję, saldo Twojego portfela zostanie automatycznie zaktualizowane.
Plany określają limity funkcji: miesięczne kontrole, liczbę przepływów, reguły na przepływ, dostęp do API, domeny niestandardowe i nie tylko. Możesz przeglądać dostępne plany bez uwierzytelniania. Podwyższenie lub obniżenie wersji następuje natychmiast – niewykorzystane saldo z bieżącego okresu jest proporcjonalnie liczone i przekazywane z powrotem do Twojego portfela.
Subskrypcje mogą być miesięczne lub roczne. Roczne subskrypcje oferują zniżkę. Możesz zrezygnować w dowolnym momencie – subskrypcja pozostaje aktywna do końca bieżącego okresu rozliczeniowego. Wznowienie anulowanej subskrypcji przywraca ją bez tworzenia nowej.
Portfel śledzi wszystkie transakcje: depozyty, opłaty subskrypcyjne, zwroty pieniędzy i kredyty proporcjonalne. Każda transakcja zawiera typ referencyjny i identyfikator łączący ją ze zdarzeniem źródłowym (depozyt, odnowienie subskrypcji, zmiana planu itp.).
Sprawdź dostępne plany, korzystając z publicznego punktu końcowego /billing/plans, aby znaleźć plan odpowiedni do Twoich potrzeb.
Zarejestruj się i przejdź do opcji Ustawienia > Rozliczenia w panelu kontrolnym.
Dodaj środki do swojego portfela: kliknij „Wpłata”, wybierz dostawcę płatności i kryptowalutę, wprowadź kwotę.
Dokończ płatność kryptowalutą, korzystając z wygenerowanego adresu. Twój portfel aktualizuje się po potwierdzeniu blockchain.
Zapisz się na plan. Opłata za subskrypcję jest pobierana z salda Twojego portfela.
Monitoruj saldo swojego portfela i historię transakcji w sekcji Rozliczenia.
Ustaw alerty o niskim saldzie, aby mieć pewność, że w Twoim portfelu znajdują się wystarczające środki na kolejne odnowienie.
# 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 }Efektywnie poruszaj się po panelu Magicgate. Poznaj widoki analityczne, zarządzanie przepływami, panele ustawień i sposób monitorowania filtrowania ruchu w czasie rzeczywistym.
Pulpit nawigacyjny Magicgate to centralny panel kontrolny umożliwiający zarządzanie przepływem ruchu, monitorowanie analiz i konfigurowanie ustawień konta. Po zalogowaniu przejdziesz na stronę Przegląd, która zawiera podsumowanie kluczowych wskaźników Twojego konta.
Strona Przegląd wyświetla całkowitą liczbę przetworzonych kontroli, rozkład werdyktów (oferta vs biała), aktywne przepływy i ostatnią aktywność. Wykres szeregów czasowych przedstawia natężenie ruchu w ciągu ostatnich 24 godzin, 7 dni lub 30 dni. Dzięki temu możesz natychmiast sprawdzić stan ruchu i skuteczność filtrowania.
Sekcja Przepływy umożliwia tworzenie przepływów ruchu i zarządzanie nimi. Każdy przepływ reprezentuje odrębną konfigurację filtrowania — zestaw filtrów, adres URL strony z ofertą, adres URL białej strony i ustawienia integracji (API Mode lub Direct Mode). Możesz mieć wiele przepływów dla różnych kampanii, stron docelowych lub źródeł ruchu.
W szczegółowym widoku każdego przepływu można zobaczyć statystyki poszczególnych przepływów: łączną liczbę kontroli, zestawienie werdyktów, współczynniki trafień filtrów, dystrybucję geograficzną i najważniejsze strony odsyłające. Te szczegółowe dane pomagają zoptymalizować ustawienia filtrów dla każdej konkretnej kampanii.
Sekcja Analityka zapewnia kompleksowy wgląd we wszystkie przepływy. Wykresy obejmują trendy ocen w czasie, skuteczność filtrów (które filtry uruchamiają się najczęściej), geograficzne mapy cieplne pokazujące pochodzenie ruchu, awarie urządzeń i przeglądarek oraz godzinowe wzorce ruchu. Wszystkie wykresy obsługują filtrowanie zakresu dat i filtrowanie specyficzne dla przepływu.
Sekcja Domeny zawiera listę wszystkich skonfigurowanych domen (współdzielonych i niestandardowych). Dla każdej domeny możesz zobaczyć jej status (aktywna, oczekująca na weryfikację, błąd DNS), status certyfikatu SSL i powiązane przepływy. Kontrole stanu domeny są uruchamiane automatycznie i powiadamiają Cię w przypadku wykrycia problemów z DNS lub SSL.
Sekcja Ustawienia zawiera konfigurację obejmującą całe konto. Klucze API: generuj i zarządzaj kluczami API key z opcjonalnymi datami wygaśnięcia. Webhooks: skonfiguruj punkty końcowe webhooka i przeglądaj dzienniki dostaw. Dostawcy: dodawaj i zarządzaj dostawcami płatności i DNS. Rozliczenia: przeglądaj saldo portfela, historię doładowań i status subskrypcji. Zespół: zaproś członków zespołu z dostępem opartym na rolach (użytkownik, administrator).
Pulpit nawigacyjny obsługuje zarówno jasne, jak i ciemne motywy, a przełącznik motywu znajduje się w prawym górnym rogu. Wszystkie strony są responsywne i działają na urządzeniach mobilnych, chociaż wersja na komputery stacjonarne zapewnia najbardziej wszechstronne widoki danych.