Integracja co to jest i jak wybrać metodę integracji z Admitad

Integracja to konfiguracja współpracy dwóch niezależnych systemów: twojej witryny i/lub aplikacji oraz platformy Admitad.

Integracja z Admitad to obowiązkowy etap uruchomienia programu partnerskiego, ponieważ integracja umożliwia:

śledzenie celowych działań użytkowników na twojej witrynie i/lub w aplikacji;
wysyłanie zarejestrowanych informacji o działaniach do systemu Admitad.

Informacje o celowym działaniu obejmują kod programu, kod działania, kod taryfy, numer zamówienia, jego wartość i inne parametry działania.

System Admitad zapisuje w statystykach dane wysyłane przez twoją witrynę i/lub aplikację oraz identyfikuje webmastera, z którego witryny użytkownik przeszedł do twojej na stronie i wykonał celowe działanie. W ten sposób działanie celowe jest przypisywane odpowiedniemu webmasterowi.

Poprawnie skonfigurowana integracja pozwala rejestrować wszystkie celowe działania użytkowników i poprawnie przypisywać je webmasterom.

W wyniku tego kontrolujesz swoje wydatki na program partnerski, a webmasterzy otrzymują swoje wynagrodzenie w pełnej wysokości.

Więcej informacji o integracji aplikacji mobilnych można znaleźć w tym artykule.

Metody integracji z Admitad

Nie wszystkie metody integracji umożliwiają skuteczne śledzenie działań. Na przykład, jeśli dane o zamówieniach są przesyłane do Admitad ze strony reklamodawcy za pośrednictwem przeglądarki użytkownika, część z nich może zostać utracona z powodu ustawień prywatności przeglądarki i działania blokujących reklamy — w rezultacie webmasterzy tracą zasłużone wynagrodzenie za pozyskane zamówienia.

Priorytetowe metody integracji S2S

Aby dane o działaniach nie zostały utracone podczas przesyłania, zalecamy przesyłanie ich do Admitad bezpośrednio z pierwotnego źródła — to znaczy, z miejsca, w którym zamówienia zostają wygenerowane. Nazywa się to śledzenie serwer-serwer (S2S).

Pierwotnym źródłem danych może być:

serwer, na którym znajdują się bazy danych z informacjami o zamówieniach;
CRM, w którym generowane są zamówienia;
CMS, w którym generowane są zamówienia.

Do priorytetowych metod integracji z Admitad należą:

Integracja poprzez zapytanie postback z serwera, z CRM lub CMS.
Integracja przez plik XML — eksport zamówień z serwera, z CRM lub CMS do pliku XML, do którego Admitad ma dostęp przez link.
Integracja przez API — jeśli masz własne API lub plany na jego opracowanie.
Integracja przez plugin do 1C-Bitrix — jeśli twoja witryna została stworzona na platformie 1C-Bitrix
Integracja przez plugin dla inSales — jeśli twoja witryna została stworzona na platformie inSales

Zalecamy wybór jednej z tych metod integracji, ponieważ tylko one mogą zapewnić pełne przesyłanie danych. Jeśli możliwości techniczne twojej witryny na to nie pozwalają, możesz skontaktować się z deweloperem i poprosić go o skonfigurowanie możliwości połączenia S2S. Z naszej strony jesteśmy gotowi udzielić mu konsultacji w zakresie logiki realizacji.

Niepożądane metody integracji

Oprócz połączenia S2S możliwe są inne metody integracji, ale niosą ze sobą ryzyko utraty danych. Dlatego nie zalecamy ich używać, chociaż technicznie jest to możliwe.

Od 1 czerwca 2025 roku Admitad przechodzi na nowe standardy integracji i zastosuje politykę korekty strat wobec tych partnerów, którzy stosują niepriorytetowe metody integracji. Zalecamy natychmiastowe przejście do nowych standardów integracji, aby zapewnić dokładne śledzenie działań i uniknąć rozbieżności. Nasz zespół jest gotowy do pomocy w przejściu.

Metody niepożądane integracji obejmują:

Każda integracja frontendowa — gdy dane o działaniach są przesyłane nie z serwera, a z witryny przez przeglądarkę użytkownika. Ograniczenia przeglądarki (np. blokady reklam) prowadzą do utraty części danych.
Integracja z pomocą zewnętrznych systemów analityki internetowej: Google Analytics 4, Yandex.Metrica itd. Te systemy również otrzymują statystyki nie z serwera, a z witryny.
Użycie platformy śledzącej: Affise, Trackier itd. Mimo, że dane są przesyłane z platformy śledzącej do Admitad za pomocą S2S, sama platforma śledząca w większości przypadków uzyskuje te dane z przeglądarki użytkownika.

Jak wybrać sposób integracji

Dla skutecznego śledzenia działań celowych zalecamy wybór priorytetowych metod integracji opisanych w poniższej sekcji. W pozostałych przypadkach wybór zależy od możliwości technicznych twojej witryny.

Schemat wyboru metody integracji

Zielony oznaczony sposób to priorytetowe metody, czerwony — niepożądane.

Jeśli możliwości techniczne Twojej strony nie pozwalają na natychmiastowy wybór priorytetowego sposobu integracji, możesz zwrócić się do programisty i poprosić go o skonfigurowanie możliwości połączenia S2S. Z naszej strony jesteśmy gotowi dostarczyć mu konsultacji w zakresie logiki implementacji.

Specyfika i zalety sposobów integracji

Priorytetowe sposoby

Dla wszystkich tych sposobów integracji dostępne są ustawienia deduplikacji i cross-device trackingu.

Deduplikacja — sposób przetwarzania danych, który pozwala prawidłowo określić płatne źródło ruchu, aby przypisać mu zamówienie, a także wyeliminować dublujące się działania celowe, jeśli takie istnieją.
Płatne źródło ruchu — to każdy zewnętrzny zasób, któremu płacisz za przyciąganie użytkowników na swoją stronę na określonych warunkach: za każde kliknięcie w stronę, wyświetlenie reklamy, zamówienie, rejestrację lub zakup. Na exemplo reklama targetowana i kontekstowa, płatne posty na kanałach liderów opinii itd.
Crossdevice-tracking — jest to technologia, która pozwala śledzić działania celowe, wykonane przez użytkownika na różnych urządzeniach. Czytaj więcej

Integracja przez zapytanie postback

Przy integracji przez zapytanie postback, Twój serwer wysyła serwerowi Admitad zapytanie postback z danymi o celowych działaniach wykonanych przez użytkowników na Twojej stronie.

Serwer Admitad otrzymuje te dane i rejestruje je w statystykach, na podstawie których dokonywana jest kalkulacja z webmasterami.

Zalety:

Zapytanie postback zapewnia bezpieczne przesyłanie danych, ponieważ zawiera prywatny klucz autoryzacji. W razie potrzeby źródło zapytania można zidentyfikować w dziennikach.
Zmiany na stronie (front-end) nie mają wpływu na przesyłanie danych o działaniach, ponieważ zapytanie postback jest wysyłane z serwera (back-end).

Wady:

Aby wdrożyć rozwiązanie, trzeba mieć dostęp do części serwerowej strony.

Więcej informacji o tym sposobie integracji i jego ustawieniach można znaleźć w artykule „Integracja przez zapytanie postback”.

Integracja przez XML

W przypadku integracji przez XML, dane o celowych działaniach użytkowników są eksportowane do pliku XML o określonej strukturze. Do tego pliku, na określonym okresie, serwer Admitad odwołuje się i ściąga dane o nowych działaniach z pliku do statystyki Admitad.

Zalety:

Możliwość ograniczenia dostępu do pliku za pomocą loginu i hasła.
Przy odpowiednich ustawieniach webmasterzy mogą otrzymywać informacje o działaniach z minimalnym opóźnieniem.
W przypadku awarii technicznych, informacje o działaniach w statystyce Admitad można łatwo przywrócić.

Wady:

Przy zwiększeniu kolejki przetwarzania pliku XML, mogą wystąpić opóźnienia w ukazaniu się danych.

Więcej informacji na temat tej metody integracji i jej ustawień znajdziesz w artykule „Integracja przez XML”.

Integracja przez API

Jeśli dla Twojej strony opracowano interfejs programowania, możesz przekazać dokumentację API specjaliście działu Usług Integracji, aby opracował indywidualną opcję integracji.

Zalety:

Możliwość elastycznego dostosowywania warunków gromadzenia danych.
Minimalne zmiany API z Twojej strony.
Możliwość dostosowania deduplikacji działań i crossdevice-trackingu.

Wady:

Najbardziej czasochłonny sposób integracji, ponieważ wymaga zaangażowania programistów do realizacji i testowania kodu.

Niepożądane sposoby

Od 1 czerwca 2025 roku Admitad przechodzi na nowe standardy integracji i będzie stosować politykę korekty strat wobec tych partnerów, którzy korzystają z wymienionych poniżej sposobów integracji. Zdecydowanie zalecamy przejście na nowe standardy integracji już teraz, aby zapewnić dokładne śledzenie działań i uniknąć niezgodności. Nasz zespół jest gotowy, aby pomóc w przejściu.

Jak rozpocząć integrację

1. Przed rozpoczęciem integracji, upewnij się, że w Twoim programie zostało dodane przynajmniej jedno działanie celowe i taryfa dla niego — bez tego nie można przeprowadzić integracji.

Jeśli masz osobistego menedżera, doda działania i taryfy za Ciebie.
Jeśli nie masz menedżera, musisz samodzielnie dodać działania i taryfy w sekcji Actions (menu → Program → Actions) — instrukcja dodawania działań.

2. Określ sposób integracji swojej strony i/lub aplikacji z Admitad.

Jeśli masz trudności z wyborem sposobu integracji, skonsultuj się ze swoimi programistami lub przejdź do tej sekcji instrukcji.

3. Następnie w panelu użytkownika przejdź do sekcji Integration (menu → Program → Integration) i kliknij Next..

4. Przejdź do jednej z zakładek w zależności od wybranego sposobu:

integracja przez wtyczki – jeśli chcesz przeprowadzić integrację przez gotową wtyczkę dla strony na bazie systemu CMS, jak WordPress, Shopify, inSales lub 1C-Bitrix;
niestandardowa integracja – jeśli wolisz integrację przez zapytanie postback, XML, skrypt śledzący lub API Google Analytics.

5. Zaznacz odpowiedni sposób i kliknij Next..

6. Na następnej stronie Integration Settings zobaczysz sekcje:

Ustawienia integracji: unikalne wartości parametrów dla Twojego programu — w tej sekcji przedstawione są wartości parametrów dla Twojego programu, które są potrzebne, aby przeprowadzić integrację.
Ustawienia deduplikacji — w tej sekcji znajduje się link do instrukcji dotyczącej ustawień deduplikacji.
Testowanie integracji — w tej sekcji znajduje się link testowy, za pomocą którego możesz sprawdzić, czy integracja została pomyślnie przeprowadzona, a działania celowe na Twojej stronie są poprawnie śledzone.

7. Przejdź do instrukcji dotyczącej wybranej metody integracji i wykonaj wszystkie opisane w niej kroki.

Instrukcje dotyczące priorytetowych metod integracji:

Instrukcje dotyczące niepożądanych metod integracji: