Konfigurując rozwiązanie do filtrowania ruchu, jedną z pierwszych decyzji, jakie podejmiesz, będzie to, jak zintegrować je z istniejącym przepływem pracy. Większość platform oferuje dwa podejścia: interfejs API, który wywołujesz z własnego kodu, lub tryb bezpośredni/przekierowania, który obsługuje wszystko automatycznie. Każdy z nich ma wyraźne zalety.
API Mode: Pełna kontrola dla programistów
API Mode działa poprzez proste żądanie HTTP. Wysyłasz żądanie POST z atrybutami odwiedzającego (adres IP, agent użytkownika, nagłówki itp.) i otrzymujesz odpowiedź JSON z werdyktem: „oferta” dla ruchu legalnego lub „biały” dla ruchu filtrowanego.
Główną zaletą API Mode jest elastyczność. Masz dokładną kontrolę nad sposobem wykorzystania werdyktu — przekierowuj do różnych stron, udostępniaj różne treści bezpośrednio, rejestruj dodatkowe dane lub integruj się z istniejącą logiką zaplecza. API Mode jest idealny do:
- Niestandardowe strony docelowe PHP, Node.js lub Python
- Złożona logika routingu z wieloma wariantami oferty
- Integracja z istniejącymi platformami analitycznymi lub śledzącymi
- Renderowanie po stronie serwera, gdzie potrzebny jest werdykt przed wygenerowaniem strony
Direct Mode: Integracja z kodem zerowym
Direct Mode eliminuje potrzebę jakichkolwiek zmian w kodzie. Wskazujesz domenę do usługi filtrowania, konfigurujesz adresy URL ofert i białych stron, a platforma zajmuje się wszystkim: oceną odwiedzających, decyzjami o routingu i przekierowaniem ruchu.
Direct Mode obsługuje kilka metod routingu:
- Przekierowanie 302: Przeglądarka gościa zostaje przekierowana do adresu URL oferty lub białej strony. Prosty i szeroko kompatybilny.
- Reverse Proxy: Usługa filtrowania pobiera i wyświetla ofertę lub zawartość białej strony w Twojej domenie. Odwiedzający nigdy nie widzi rzeczywistego docelowego adresu URL.
- Osadzanie ramki iframe: Treść jest ładowana w ramce iframe w Twojej domenie. Przydatne, gdy chcesz zachować spójny adres URL.
Direct Mode jest idealny dla marketerów, którzy chcą rozwiązania typu plug-and-play.
Porównanie wydajności
Obydwa tryby mogą osiągnąć czasy oceny poniżej 10 ms, gdy podstawowy silnik jest szybki. Różnica polega na całkowitym cyklu życia żądania:
- API Mode dodaje jedno żądanie HTTP do logiki po stronie serwera. Jeśli Twój serwer znajduje się blisko usługi filtrowania, wydłuża to czas o 5–20 ms.
- Direct Mode wymaga, aby odwiedzający najpierw odwiedził usługę filtrowania, a następnie został przekierowany. Dodaje to pełną podróż w obie strony, ale samo przekierowanie jest obsługiwane na poziomie HTTP, więc jest szybkie.
W praktyce oba podejścia są niezauważalne dla zwiedzających. Wybór powinien opierać się na wymaganiach technicznych, a nie na obawach związanych z wydajnością.
Które wybrać?
Wybierz API Mode, jeśli masz zasoby programistyczne, potrzebujesz niestandardowej logiki routingu lub chcesz zintegrować filtrowanie z istniejącą bazą kodu.
Wybierz Direct Mode, jeśli chcesz najszybszej konfiguracji, nie masz kodu po stronie serwera lub wolisz rozwiązanie zarządzane, w którym platforma obsługuje cały routing.
Wielu użytkowników zaczyna od Direct Mode ze względu na jego prostotę i migruje do API Mode później, gdy potrzebują większej kontroli. Najlepsze platformy obsługują oba tryby z tym samym silnikiem filtrów, dzięki czemu uzyskasz identyczną ochronę niezależnie od metody integracji.