Affiliate
W przygotowaniu
W skrócie
Dział zatytułowany „W skrócie”Dwie pozycje menu: Przegląd (wyniki) i Ustawienia (zasady programu).
Co to robi
Dział zatytułowany „Co to robi”Gdzie to znaleźć w aplikacji: Handel → Affiliate
- Śledzi partnerów, ich linki, prowizje i wypłaty.
- Ustawienia to osobny ekran, a nie karta w przeglądzie.
Jak to skonfigurować
Dział zatytułowany „Jak to skonfigurować”Szczegółowa instrukcja krok po kroku jest w przygotowaniu. Na razie ta strona informuje, gdzie funkcja znajduje się w aplikacji i co obejmuje.
Portal partnera i jego wygląd
Dział zatytułowany „Portal partnera i jego wygląd”Partnerzy logują się i rejestrują w publicznym portalu: pod adresem zastępczym …/partner/<kod e-shopu> lub we własnej domenie (karta Domena). U góry jest pas w głównym kolorze programu z kartą logowania (lub rejestracji), a obok karta osoby kontaktowej, czyli menedżera Affiliate ze zdjęciem, telefonem i e-mailem. Opcjonalny opis programu znajduje się poniżej; na telefonie wszystko układa się jedno pod drugim.
Konfiguruje się to w Ustawienia → Program i wygląd: Program (nazwa, tryb rejestracji, automatyczne zatwierdzanie rejestracji partnerów; zatwierdzanie konwersji to ustawienie kampanii, zobacz niżej), Osoba kontaktowa (imię i nazwisko, e-mail, telefon, adres URL zdjęcia profilowego; bez imienia i e-maila karta się nie wyświetla), Wygląd portalu (logo, kolory, link do polityki prywatności) oraz Rejestracja i dane partnera (które pola są wymagane i kiedy). Logo ma jedno źródło: portal używa logo ustawionego dla konta (Ustawienia → E-maile → Logo); kolor tekstu na wybranym kolorze jest obliczany tak, aby pozostał czytelny.
Przy rejestracji partner zaznacza jedno pole: „Akceptuję Warunki programu i przyjmuję do wiadomości Informację o przetwarzaniu danych osobowych”; obie nazwy są linkami, które otwierają treść w nowej karcie. Informacja o prywatności nie jest zgodą na przetwarzanie (przetwarzanie opiera się na umowie i przepisach prawa), dlatego nie jest wymagana osobno; audyt zapisuje akceptację warunków i przyjęcie do wiadomości informacji, każde z odciskiem treści. Partner potwierdza też dokumenty, które zostały oznaczone jako wymagane przy rejestracji (karta Dokumenty). Nazwa dokumentu otwiera PDF w nowej karcie, obok jest Pobierz; dokument bez przesłanej treści nie jest pokazywany partnerom.
Warunki i informacja o prywatności to dokumenty wbudowane na karcie Dokumenty: nowy program otrzymuje je wypełnione we wszystkich językach danymi z Ustawienia → Konto. Są to edytowalne szablony; MitoOps nie gwarantuje ich poprawności prawnej, a za zgodność z prawem danego kraju odpowiada operator programu. Nie można ich usunąć ani wyłączyć, zmienia się tylko ich treść.
Jeden partner, e-shopy pojedynczo
Dział zatytułowany „Jeden partner, e-shopy pojedynczo”Partner to jedno konto dla całego konta klienta (jeden login, jeden publiczny kod), ale program działa dla każdego e-shopu osobno. To, które e-shopy partner widzi, określa członkostwo: rejestracja przez portal e-shopu (…/partner/sk) daje dostęp tylko do tego e-shopu: do jego kampanii, kod partnera powstaje tam i obowiązują tylko dokumenty tego e-shopu (gotowość nigdy nie wymaga umów innych e-shopów). Kolejne e-shopy włącza się lub odbiera w szczegółach partnera, w sekcji E-shopy partnera; partner może o e-shop poprosić z portalu (Kampanie → Twoje e-shopy), a administrator otrzymuje e-mail i decyduje; nic nie włącza się samo. Rejestracja tego samego e-maila przez portal innego e-shopu nie tworzy drugiego konta; zostaje zapisana jako wniosek o dostęp do tego e-shopu: partner otrzymuje o tym e-mail, a wniosek obsługuje się tak samo jak wniosek z portalu (nic nie jest przyznawane automatycznie i nie zmieniają się żadne dane konta). Odebranie e-shopu zachowuje historię (konwersje, kupony); kampanie e-shopu znikają dla partnera, a jego kod w tym e-shopie zostaje zakończony zgodnie z ustawieniami programu, ponowne włączenie go przywraca. Partnerzy sprzed wprowadzenia członkostwa mieli je wywiedzione z e-shopu rejestracji, e-shopów kuponów i konwersji oraz jawnie przypisanych kampanii; partner bez takich danych otrzymał wszystkie podłączone e-shopy.
Wniosek o dostęp do e-shopu razem z kodem. Przycisk Poproś o dostęp w portalu tylko otwiera panel obok e-shopu: partner pisze notatkę (do 500 znaków), wybiera, czy przenieść istniejący kod, zaproponować nowy, czy działać bez kodu, i dopiero potem klika Wyślij wniosek. W szczegółach partnera (sekcja E-shopy i kody partnera) decyduje się w jednym kroku: Zatwierdź dostęp i kod, Zatwierdź tylko dostęp lub Odrzuć z podaniem powodu. Kod powstaje w e-shopie z rabatem kampanii tego e-shopu; jeśli kampania nie ma rabatu, dostęp zostaje przyznany, a wiersz pokazuje „zablokowane” z linkiem do kampanii; po ustawieniu rabatu wystarczy Spróbuj ponownie. Partner otrzymuje e-mail z wynikiem.
Kod partnera ma historię. Jeden kanoniczny kod jest przenoszony do kolejnych e-shopów (także zbiorczo, przez zaznaczenie e-shopów); istniejący kupon e-shopu, na przykład kod, którego partner używał długo przed programem, można przejąć bez tworzenia drugiego: po jego wpisaniu MitoOps znajduje go wśród wczytanych kuponów, pokazuje rabat, ważność i wykorzystanie oraz porównuje rabat z rabatem kampanii (jeśli się różnią, należy potwierdzić przejęcie z pierwotnym rabatem; rabat w e-shopie nie jest zmieniany). Kod, który przyniósł już zamówienia, nigdy nie jest usuwany: wycofuje się go (ważny do wczoraj) lub zastępuje nowym, a stary jest wycofywany dopiero po powodzeniu nowego. Zamówienia ze starym kodem pozostają przy partnerze; partner widzi wycofane kody i to, który kod je zastąpił.
Zarejestrowane strony i dokument do wypłaty
Dział zatytułowany „Zarejestrowane strony i dokument do wypłaty”Szczegóły partnera zawierają dwie rzeczy, o których się decyduje: zarejestrowane strony (partner podaje, gdzie promuje sklep; przychodzą jako Czeka na zatwierdzenie i się je Zatwierdza lub Odrzuca z powodem, który partner widzi; zatwierdzenie wysyła mu e-mail) oraz dokumenty do wypłaty (podstawa do wypłaty prowizji: faktura od partnera z numerem firmy, obejmująca konkretny okres, lub umowa pośrednictwa od partnera bez numeru firmy, ważna do odwołania). Plik przesyła partner w portalu albo administrator przyciskiem Dodaj dokument. Jeśli partner bez numeru firmy ma podpisaną umowę programu, to ona jest podstawą wypłaty i żaden dalszy dokument nie jest potrzebny: karta o tym informuje, a wypłata przechodzi. Dokument nigdy nie jest usuwany, tylko unieważniany. Przebieg wypłaty jest zawsze taki sam: partner prosi o wypłatę, administrator zatwierdza partię i ją wypłaca.
Kod partnera: prowizja to nie rabat
Dział zatytułowany „Kod partnera: prowizja to nie rabat”Kampania ma dwie niezależne wartości: prowizję partnera i rabat klienta na kodzie partnera; żadna nie wynika z drugiej, a partner widzi obie nazwane na karcie Kampanie obok okna atrybucji i trybu zatwierdzania. Zatwierdzony kod powstaje w tych e-shopach partnera, których kampania ma rabat dla klienta; bez niego tworzenie jest Zablokowane: karta Kody rabatowe pokazuje e-shop i kampanię z linkiem prosto do niej, a po ustawieniu rabatu Spróbuj ponownie dokończy tworzenie. Nic nie powstaje dwa razy, a partner w międzyczasie widzi „w przygotowaniu”, nigdy fałszywe „aktywny”.
Link partnera automatycznie stosuje jego kod dołącza kod parametrem mitoops_coupon: to ten sam mechanizm co kupony w Emailingu, stosowany przez kod strony MitoOps; nazwy parametru nie można zmienić. Jeśli e-shop nie ma kodu strony, który potrafi zastosować kupon z adresu URL, ustawienie o tym ostrzega: link niesie kod, ale rabat nie zastosuje się sam w koszyku (atrybucja działa nadal, opiera się na identyfikatorze kliknięcia). Ważność przekliku (okno atrybucji) (np. 30 dni) i Przechowywanie zapisów o kliknięciach (np. 180 dni) to dwa ustawienia: jedno mówi, jak długo po kliknięciu zamówienie jest jeszcze przypisywane, drugie, jak długo kliknięcie pozostaje w analityce.
Teksty portalu i zmienne
Dział zatytułowany „Teksty portalu i zmienne”Teksty, które czyta partner, znajdują się w czterech miejscach: Strony portalu (Logowanie, Rejestracja, Po zalogowaniu: trzy strony systemowe z podglądem i edytorem, który mówi, gdzie tekst się wyświetla), Opis programu (karta Teksty), Opis kampanii (dla każdej kampanii; bez własnego tekstu partner otrzymuje domyślny z wartościami kampanii) oraz Artykuły (karta Artykuły; partnerzy czytają je w sekcji Pomoc). Wszystkie mają domyślny tekst w jedenastu językach, który można zmienić lub przywrócić.
W tekstach można używać zmiennych wypełnianych z ustawień, aby liczba nigdy nie rozeszła się z kampanią: na przykład {{provizia}}, {{atribucia_dni}} i {{schvalenie}} (w kampanii), {{minimum_vyplaty}}, {{zaklad_provizie}}, {{program}}, {{prevadzkovatel}}, {{meno}} i {{kod}} (po zalogowaniu) oraz linki do sekcji ({{odkaz_vyplaty}}). Edytor oferuje tylko zmienne, które mają w danym miejscu wartość: przy każdej widać token, jej nazwę, dymek „i” z wyjaśnieniem i przykładem (działa myszą, klawiaturą i dotykiem) oraz przycisk Kopiuj. Token (na przykład {{prevadzkovatel_email}}) jest taki sam w każdym języku aplikacji; tłumaczona jest tylko nazwa i wyjaśnienie. Zmienne kampanii ({{provizia}}, {{schvalenie}}…) nie są proponowane do wstawienia w opisie programu: są tam wypełniane tylko wtedy, gdy e-shop ma dokładnie jedną publiczną kampanię, w przeciwnym razie należą do opisu kampanii, gdzie stawka jest jednoznaczna; mówi o tym dymek. Zmienna bez wartości nie jest pokazywana partnerowi; blok {{#minimum_vyplaty}}…{{/minimum_vyplaty}} pojawia się tylko wtedy, gdy minimum istnieje. Kampania z ręcznym zatwierdzaniem nie ma {{schvalenie_dni}}: tekst nigdy nie kłamie.
Te same zmienne działają w e-mailach, z aliasami ze starszych szablonów ({{partnerName}} równa się {{meno}}, {{amount}} równa się {{suma}}); pełny rejestr z typem, miejscami użycia i aliasami zwraca affiliate_variables_list. Projekty treści: nowa treść warunków, informacji o prywatności lub własnej umowy może przyjść jako projekt, z aplikacji lub od podłączonego asystenta (MCP). Partnerzy go nie widzą i nic się nie zmienia, dopóki nie zostanie opublikowany na karcie Dokumenty, gdzie widać różnice względem obecnego tekstu; publikacja tworzy nową wersję ze śladem audytu (kto, kiedy, hash). Akceptacje partnerów pozostają powiązane z treścią, którą widzieli; przy włączonym „ponownym potwierdzeniu przy nowej wersji” partnerzy potwierdzają ponownie.
Podgląd portalu (Pokaż podgląd) otwiera prawdziwy portal z fikcyjnym partnerem i liczbami; każdą sekcję można przeklikać i nic nie jest wysyłane. Po zalogowaniu partner widzi po prawej panel Masz pytanie? z osobą kontaktową, tą samą co na stronie publicznej.
Linki partnerów we własnej domenie
Dział zatytułowany „Linki partnerów we własnej domenie”Dopóki e-shop nie ma własnej domeny, partnerzy otrzymują linki w postaci https://<adres aplikacji>/api/r/<kod partnera>?k=<kampania>. Gdy tylko własna domena e-shopu zostanie podłączona i aktywowana, linki są automatycznie składane na niej: w portalu, w e-mailach, w generatorze linków do podstron i przez API. Postać to https://affiliate.twojadomena.pl/api/r/<kod partnera>?k=<kampania>, a tam, gdzie operator platformy ustawił dla domeny także krótką ścieżkę, https://affiliate.twojadomena.pl/r/<kod partnera>?k=<kampania>. Obie działają i mierzą tak samo; krótka jest tylko krótsza. Karta Domena pokazuje dla każdego e-shopu dokładną postać, którą otrzymują partnerzy. Linki, które partnerzy już udostępnili przez adres aplikacji, nadal działają; po dezaktywacji domeny nowe linki wracają do adresu aplikacji. Link jest powiązany z e-shopem domeny: link z kampanią innego e-shopu nie jest na niej honorowany. <kod partnera> to publiczny kod partnera (jego konta); k to numer kampanii, który ustala cel i warunki prowizji.
Domena główna i aliasy. E-shop może mieć jednocześnie kilka zweryfikowanych domen, zwykle przy przenoszeniu z adresu tymczasowego na docelowy. Nowe linki i adresy e-mail są generowane z domeny głównej; pozostałe aktywne domeny to aliasy: linki, które partnerzy już udostępnili, nadal przez nie działają, nowe nie są z nich generowane. Aby przenieść: dodać nową domenę przyciskiem Dodaj kolejną domenę, zapisać rekordy DNS, kliknąć Zweryfikuj i połącz, a następnie Ustaw jako główną; stara domena pozostaje aliasem, dopóki nie zostanie świadomie usunięta lub dezaktywowana. Adres portalu w e-mailach używa domeny na tych samych warunkach co linki: podłączonej (DNS i certyfikat) i aktywowanej.
Wizyty z linków partnerów w Google Analytics. Oprócz identyfikatora kliknięcia przekierowanie dodaje do adresu docelowego znaczniki dla analityki e-shopu: utm_source=affiliate, utm_medium=affiliate, utm_campaign=mitoops-<kod e-shopu>-k<numer kampanii> (na przykład mitoops-de-k5) i utm_content=<kod partnera>. Google Analytics 4 zalicza wtedy wizytę do kanału Affiliates zamiast do ruchu bezpośredniego (direct) / (none), nawet gdy link otwarto z aplikacji lub e-maila, który nie przesyła strony odsyłającej. Znaczniki już obecne w adresie docelowym kampanii lub w podstronie partnera nie są nadpisywane. Wyjątkiem jest medium, które dla linku partnera zawsze wynosi affiliate. Przypisanie zamówienia do partnera nie zależy od tych znaczników; opiera się na identyfikatorze kliknięcia.
Zgoda odwiedzającego na zapisanie kliknięcia
Dział zatytułowany „Zgoda odwiedzającego na zapisanie kliknięcia”Kliknięcie jest liczone zawsze: jest zapisywane na serwerze podczas przekierowania, a w przeglądarce nic nie jest zapisywane. Aby później można było przypisać zamówienie z linku, kod strony zapisuje identyfikator kliknięcia w przeglądarce, i to tylko za zgodą odwiedzającego. Zgodę sprawdza w tej kolejności, a decyduje pierwsze źródło, które ma odpowiedź:
- Własna integracja sklepu: jeśli strona definiuje
window.mitoopsSuhlas, kod pyta ją (window.mitoopsSuhlas('meranie')zwracatruelubfalse). Pozwala to podłączyć dowolne narzędzie do zgód, którego MitoOps nie zna. - Zgoda platformy e-shopu: w Shoptecie jego pasek zgody, w WooCommerce WordPress Consent API.
- TCF (standard zarządzania zgodami): cel 1.
- Google Consent Mode:
analytics_storage. - Jeśli zgody w ogóle nie da się ustalić, identyfikator jest zapisywany.
Dopóki brakuje zgody, kliknięcie nie jest zapisywane, ale też nie ginie: jeśli odwiedzający wyrazi zgodę później na tej samej stronie, zostanie dopisane. Wycofana zgoda usuwa zapisany identyfikator. Atrybucja przez kod rabatowy nie zależy od zgody: kod jest częścią zamówienia.
Własny pomiar sklepu (jego tagi, server-side Google Tag Manager, analityka) nie jest naruszany: kod strony tylko odczytuje Consent Mode i dataLayer, nigdy do nich nie zapisuje i niczego nie wywołuje.
Podpis elektroniczny umów
Dział zatytułowany „Podpis elektroniczny umów”Dla każdego dokumentu programu wybiera się tryb potwierdzenia: zapoznanie się (partner zaznacza, że przeczytał), podpis elektroniczny w portalu lub przesłana podpisana kopia (partner drukuje, podpisuje i przesyła; administrator ją sprawdza). Przy podpisie elektronicznym partner czyta dokładną treść z wypełnionymi wartościami (firma i osoba podpisująca po stronie operatora, jego dane, e-shop i warunki kampanii), wpisuje swoje imię i nazwisko, potwierdza, że podpisuje, i klika Podpisać elektronicznie; odręczny podpis myszą lub palcem jest opcjonalny. Zapisywany jest niezmienny rekord: podpisana treść, jej hash, czas, imię i nazwisko, metoda i weryfikacja tożsamości. Podpisany PDF może w każdej chwili pobrać partner i administrator; jest generowany z rekordu, a nie z bieżącego dokumentu, więc późniejsze zmiany szablonu, kampanii lub danych firmy nigdy go nie zmienią.
Podpisanie przy rejestracji odbywa się przez e-mail: partner otrzymuje link (ważny 24 godziny, jednorazowy), który potwierdza jego adres i otwiera podpis, zanim konto zostanie zatwierdzone. Formularz rejestracji nie zaznacza takiego dokumentu, tylko o nim informuje. Zalogowany partner podpisuje w Dokumentach; gdy zostanie opublikowana nowa wersja z „ponownym potwierdzeniem przy nowej wersji”, widzi Nowa wersja do podpisu i podpisuje ją osobno; pierwotny podpis zostaje zachowany. Konto przejęte przez administratora („Zaloguj się jako partner”) nie może podpisywać.
Karta Podpisane umowy zawiera wszystkie podpisy (filtry według partnera, dokumentu, e-shopu, stanu i okresu), szczegóły z dokładną treścią i dowodami, PDF, eksport CSV oraz partnerów z brakującym podpisem; można im wysłać e-mailem prośbę o podpis. Podpisu nie można edytować; administrator może go odwołać z obowiązkowym powodem (rekord pozostaje jako odwołany). Partnera z podpisaną umową nie można usunąć, można go tylko odrzucić lub usunąć jego dane osobowe.
Wbudowany wzór umowy partnerskiej jest gotowy w każdym języku programu dla każdego konta; jest wyłączony, dopóki nie zostanie włączony w Dokumentach. Treść jest neutralna: operator, partner (firma lub osoba fizyczna), e-shop i warunki kampanii to zmienne wypełniane przy podpisie. Włączenie wymaga osoby podpisującej po stronie operatora w Ustawienia → Program (kto zawiera umowy w imieniu firmy). Wzór edytuje się przez projekt treści; „Nowa umowa z wzoru” tworzy kolejną treść, np. dla jednego e-shopu. Wzór nie jest poradą prawną: przed włączeniem należy dostosować go do prawa, które dotyczy programu. Podpis elektroniczny w MitoOps to elektroniczne oświadczenie woli ze śladem audytu, a nie kwalifikowany podpis elektroniczny w rozumieniu eIDAS.
Strony w PDF. Pod liniami podpisów operator występuje jako osoba prawna z profilu rozliczeniowego konta (Ustawienia → Konto) z numerem firmy, osobą podpisującą i funkcją (Ustawienia → Program); nazwa programu jest w nagłówku dokumentu jako nazwa programu, a nie jako strona umowy. Partner występuje jako firma z numerem firmy, osobą podpisującą i funkcją lub jako osoba fizyczna z imieniem i nazwiskiem. Wartości pochodzą z migawki wykonanej przy podpisie, więc późniejsza zmiana profilu nie zmienia starych umów.
Przejęty kupon niesie w e-shopie znacznik. Gdy istniejący kupon e-shopu zostanie przypisany partnerowi (lub zastąpi nim stary), aplikacja dopisuje do notatki kuponu w panelu e-shopu znacznik „MitoOps Affiliate · partner … · kampania …”. Pierwotna notatka sprzedawcy pozostaje, znacznik nigdy się nie duplikuje, a rabat kuponu nie jest zmieniany. Jeśli e-shop odrzuci zapis, przypisanie kodu pozostaje w mocy, a aplikacja tylko o tym informuje.
Pieczątka i podpis operatora. Obraz pieczątki jest jeden dla całej aplikacji: przesyła się go w Reklamacje → Szablony e-maili | Dokumenty lub w Affiliate → Ustawienia → Dokumenty (oba bloki pokazują ten sam plik). Podpisana umowa otrzymuje go w bloku „Podpisy stron” nad linią podpisu operatora razem z przedstawicielem i funkcją; obok jest podpis partnera z czasem. Pieczątka jest zawsze ograniczona rozmiarem i nigdy nie psuje dokumentu.
Przegląd i statystyki: co oznaczają liczby
Dział zatytułowany „Przegląd i statystyki: co oznaczają liczby”Przegląd i Statystyki (administratora i partnera) są liczone z jednego źródła, więc partner widzi dla tego samego okresu tę samą liczbę co administrator. Filtry: okres, e-shop, kampania, partner. Kliknięcia to ważne przekierowania przez link partnera bez botów i bez powtórzeń z tego samego adresu w krótkim oknie; unikalne oznacza różne adresy. Kliknięcia nie zależą od zgody odwiedzającego na zapis; zgoda decyduje tylko o tym, czy zamówienie zostanie przypisane z linku. Konwersje to przypisane zamówienia bez odrzuconych i anulowanych; wskaźnik to konwersje / kliknięcia. Pieniądze są zawsze według walut. Lejek: kliknięcia → konwersje → zatwierdzone → wypłacone; źródła: śledzony link, kod rabatowy, ręcznie. Dni są liczone w UTC.
Dwa ustawienia, które się mylą: Ważność przekliku (okno atrybucji) to czas po kliknięciu, przez który zamówienie jest jeszcze przypisywane partnerowi; Przechowywanie zapisów o kliknięciach to czas, przez który kliknięcie pozostaje w statystykach (domyślnie 180 dni; kliknięcie, na którym opiera się prowizja, nigdy nie jest usuwane).
Filtr ma także kod rabatowy, źródło atrybucji i stan konwersji oraz tabelę według kodów rabatowych (wycofany kod w niej pozostaje). Z filtrem kodu kliknięcia wynoszą 0: kliknięcie nie niesie kodu. W Przeglądzie partner widzi też Podstawę prowizji za okres i Prowizję za okres, a w Statystykach filtruje tylko według własnych kodów. Zamówienie przypisane partnerowi przez link pojawia się także w Analityce (kanały, lista zamówień) jako „Affiliate · partner”, a nie jako „Nieatrybuowane”; anulowana konwersja nie jest przypisywana.
Powiadomienia zespołu: nowa rejestracja, wniosek o e-shop, kod lub stronę, prośba o wypłatę i podpisana umowa przychodzą do dzwonka oraz, zależnie od tematu, roli i uprawnienia Affiliate, jako push na telefon, z linkiem prosto do miejsca w aplikacji. Rejestracja ma opcjonalne pole O mnie (500 znaków), które widać przy oczekującej rejestracji, w szczegółach i w e-mailu.
Konwersje i prowizja: dwie kwoty, dwie nazwy
Dział zatytułowany „Konwersje i prowizja: dwie kwoty, dwie nazwy”Podstawa prowizji to kwota, od której liczona jest prowizja zgodnie z ustawieniami programu (towar bez VAT lub z VAT; transport i opłata za płatność są domyślnie wyłączone). Wartość zamówienia z VAT to to, co klient faktycznie zapłacił. Przykład z prawdziwego zamówienia: towar 89,55 + 5,31 z VAT (VAT 23 %), darmowa dostawa, prowizja 10 %: podstawa 77,12 (bez VAT), wartość zamówienia z VAT 94,86, prowizja 7,71. Obie kwoty pojawiają się w Konwersjach, w CSV, w e-mailu do partnera ({{revenue}} to podstawa, {{orderTotal}} wartość z VAT) i w portalu partnera; kwoty są zapisywane z zamówienia, nic nie jest szacowane.
Karta Affiliate → Konwersje to ekran roboczy do zatwierdzania: filtry według partnera, e-shopu, okresu, stanu prowizji, źródła, numeru zamówienia i klasyfikacji zamówienia; każda konwersja pokazuje status zamówienia z e-shopu (ten sam co w Zamówienia → Przegląd) sklasyfikowany jako otwarte / zakończone / anulowane. Klasyfikacja to kontekst, a nie decyzja: anulowania i korekty zmieniają prowizję według zasad programu. Odrzucenie i anulowanie wymagają powodu, który partner otrzymuje e-mailem; zatwierdzenie zbiorcze ma potwierdzenie z liczbą. Eksport CSV niesie ten sam filtr, status zamówienia i jednoznaczne kolumny; CSV partnera nie zawiera statusu zamówienia ani danych klienta.
Automatyczne zatwierdzanie konwersji
Dział zatytułowany „Automatyczne zatwierdzanie konwersji”Konwersje mogą zatwierdzać się same, a ustawia się to w kampanii, nie w ustawieniach programu: Affiliate → Kampanie → kampania → Zatwierdzanie konwersji z opcjami Ręcznie (domyślnie) i Automatycznie (po spełnieniu warunków). Przy zatwierdzaniu automatycznym pojawiają się warunki kampanii:
- Zatwierdzać najwcześniej (dni po zamówieniu): okres na zwrot, domyślnie 14. Dni są liczone od utworzenia zamówienia (a nie od doręczenia: e-shop nie przesyła historii statusów, więc „dni od doręczenia” byłyby zgadywaniem).
- Zatwierdzić tylko w statusach zamówienia: wybiera się z rzeczywistych statusów e-shopu kampanii (pole Kampanie e-shopu; na przykład Doręczone, Zrealizowane), tych samych co w Zamówienia → Przegląd i w Automatyzacjach. Kampania należy do jednego e-shopu i nigdy się to nie zmienia; w Nowej kampanii wybiera się jeden lub kilka podłączonych e-shopów, a dla każdego powstaje osobna kampania z identycznymi ustawieniami; kampania innego e-shopu ma własne statusy. Puste = dowolny status. Zamówienie, którego statusu aplikacja nie zna (na przykład ręcznie dodana konwersja bez zamówienia w lustrze danych), nigdy nie zostanie zatwierdzone, dopóki lista jest wypełniona.
- Wymagać opłaconego zamówienia: domyślnie Nie, ponieważ pobranie jest płacone przy odbiorze. Przy Tak zatwierdzane jest tylko zamówienie, którego stan płatności to opłacone (flaga zapłaty w Shoptecie, stan płatności w WooCommerce); zamówienie z nieznanym stanem płatności nie.
Konwersja jest zatwierdzana dopiero wtedy, gdy spełnione są wszystkie wybrane warunki. Raz na godzinę aplikacja przechodzi przez nowe konwersje kampanii z automatycznym zatwierdzaniem; partner otrzymuje ten sam e-mail co przy zatwierdzeniu ręcznym, a audyt zapisuje „system” jako decydującego. Konwersja, która jeszcze nie spełnia warunków, nadal czeka; obok jej stanu na karcie Konwersje widać, na co czeka automatyka (na przykład „czeka na okres wstrzymania (3 d)” lub „zamówienie nie jest opłacone”). Partnerzy widzą okres w opisie kampanii przez zmienną {{schvalenie}}.
Co obowiązuje zawsze, niezależnie od ustawień:
- Anulowanie zamówienia odrzuca konwersję (zatwierdzona zostaje anulowana), a korekta ją zmniejsza lub, przy zwrocie całego zamówienia, anuluje; tak samo przy zatwierdzaniu ręcznym i automatycznym. Automatyka nigdy nie zatwierdzi anulowanego zamówienia ani całkowicie zwróconego, nawet jeśli wszystkie pozostałe warunki się zgadzają; częściowo zwrócone zamówienie zostanie zatwierdzone z obniżoną prowizją.
- Wypłaconej prowizji system nigdy nie rusza: jest rozliczona z partnerem.
- Ustawienie obowiązuje dla każdej kampanii: każda kampania należy do jednego e-shopu i ma własny tryb, okres i statusy.
- Istniejące kampanie nie zmieniły się po dodaniu warunków: kampania, która miała „automatycznie po okresie”, nadal zatwierdza tylko według okresu, dopóki nie zostaną dodane warunki.
Jeśli potrzebny jest warunek, którego kampania nie ma (minimalna wartość, konkretny partner), należy pozostawić Ręcznie i decydować na karcie Konwersje, gdzie każda konwersja pokazuje status zamówienia i stan płatności.
Częste pytania: Jak odrzucić konwersję? Na karcie Konwersje kliknąć Odrzuć przy nowej konwersji i podać powód; partner otrzyma go e-mailem; zatwierdzoną konwersję można Anulować, wypłaconej nie. Czy można zatwierdzać tylko zakończone lub doręczone zamówienia? Tak: wystarczy wybrać statusy w Zatwierdzić tylko w statusach zamówienia w kampanii. Czy MitoOps sprawdza, czy zamówienie jest opłacone? Tak, pobiera stan płatności z e-shopu i pokazuje go przy konwersji; wpływa on na zatwierdzanie automatyczne tylko wtedy, gdy włączone jest Wymagać opłaconego zamówienia. Co się dzieje przy anulowaniu lub zwrocie pieniędzy? Anulowanie odrzuca lub anuluje konwersję, korekta ją zmniejsza lub anuluje przy zwrocie całego zamówienia; automatycznie, w obu trybach zatwierdzania.
API i MCP
Dział zatytułowany „API i MCP”Z zakresem affiliate:read własny program lub asystent AI odczytuje przegląd, partnerów, kampanie, kody, konwersje, wypłaty, ustawienia, dokumenty, stan portalu, szablony e-maili, artykuły pomocy i wnioski o kody. Odczytuje też treść dokumentów prawnych według języków z hashami (affiliate_documents_get; podpisy elektroniczne partnerów tylko do odczytu przez affiliate_signatures_list i affiliate_signatures_get) oraz rejestr zmiennych (affiliate_variables_list). Z wrażliwym zakresem affiliate:write (tylko MCP) może zatwierdzić, odrzucić lub zawiesić konto partnera, włączyć lub odebrać e-shop partnera (affiliate_partners_set_market), obsłużyć wniosek o kod, zaktualizować niefinansowe ustawienia, teksty portalu, artykuły pomocy (tworzyć, edytować, przywracać domyślną treść, włączać lub wyłączać; nigdy nie usuwać), szablony, kampanie i politykę dokumentów. Nowa treść prawna (w tym informacja o prywatności) jest zapisywana tylko jako projekt (affiliate_documents_draft_create); obowiązującą treść publikuje się w aplikacji. Konwersje (affiliate_conversions_list, szczegóły affiliate_conversions_get) niosą podstawę prowizji i wartość zamówienia z VAT, powód stanu i status zamówienia z e-shopu z filtrem orderState. Automatyczne zatwierdzanie odczytuje się i ustawia w kampanii przez interfejs: affiliate_campaigns_get zwraca approval (manual / automatic), approveAfterDays, requiredOrderStatusIds i paidRequired; affiliate_campaigns_update zmienia je z zakresem affiliate:write (identyfikatory statusów muszą być statusami e-shopu kampanii). Każda konwersja na liście i w szczegółach niesie approvalPolicy (politykę swojej kampanii) i approvalEligibility: czy automatyka zatwierdziłaby ją w tej chwili i dlaczego nie (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual, …); jest to dokładnie to obliczenie, które działa co godzinę, a nie druga kopia. Lista ma filtry orderPaid, minCommission, orderState, state, okres i stronicowanie (offset, hasMore), więc asystent może „przejrzeć nowe konwersje z ostatnich dwóch miesięcy, pokazać nieopłacone lub te powyżej 20 €”, a następnie wywołać affiliate_conversions_decide dla każdej wskazanej konwersji osobno. Asystent w aplikacji wyjaśnia i odczytuje to samo, ale niczego nie zmienia. Decyzje o prowizjach mają własny wrażliwy zakres affiliate:approve (tylko MCP): asystent może zatwierdzić, odrzucić lub anulować jedną konkretną konwersję, którą wskaże użytkownik (odrzucenie i anulowanie z powodem, wypłacona prowizja nigdy nie jest cofana), tą samą drogą co w aplikacji. Nie ma zbiorczego zatwierdzania w jednym wywołaniu. Wypłaty są przez interfejs tylko do odczytu (affiliate_payouts_list): utworzenia partii, jej dokumentu, wysłania go partnerowi ani polecenia bankowego nie można uruchomić przez API ani MCP; pozostają w aplikacji. Szczegóły w interfejsie MCP.