System Importu/Eksportu

Dostępne w:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Przegląd

System Importu/Eksportu w Post Affiliate Pro zapewnia potężne narzędzia do masowych operacji na danych. Niezależnie od tego, czy migrujesz z innej platformy, zarządzasz dużymi zbiorami danych czy synchronizujesz dane między systemami, funkcjonalność importu/eksportu oszczędza czas i zmniejsza błędy ręczne.

System obsługuje import i eksport:

• Partnerzy - Konta użytkowników ze wszystkimi danymi profilowymi i opcjami wypłat
• Kampanie - Ustawienia kampanii, typy prowizji, grupy i stawki
• Banery - Definicje banerów i materiały promocyjne
• Transakcje - Sprzedaże, prowizje i rekordy transakcji
• Motywy - Niestandardowe motywy paneli i szablony

Import/Eksport Partnerów

Eksportowanie Partnerów

Funkcja eksportu partnerów tworzy kompleksowy plik CSV zawierający wszystkie dane partnerów z Twojej instalacji. Eksport zawiera:

Podstawowe Pola Partnera:

• ID Użytkownika (unikalny identyfikator)
• ID Referencyjne (refid)
• Nazwa użytkownika (email)
• Imię i Nazwisko
• Status konta (oczekujący, zatwierdzony, odrzucony)
• Data wstawienia i Data zatwierdzenia
• ID Użytkownika Nadrzędnego (dla struktur wielopoziomowych)
• Minimalna wypłata
• Notatki i Zdjęcie

Niestandardowe Pola Danych:

• Dane1 do Dane25 (niestandardowe pola partnera)

Opcje Wypłat: Eksport zawiera również osobną sekcję dla opcji wypłat, zawierającą:

• ID Użytkownika
• Nazwa pola wypłaty
• Wartość pola wypłaty

Importowanie Partnerów

Podczas importowania partnerów system przetwarza plik CSV i albo tworzy nowe konta partnerów, albo aktualizuje istniejące na podstawie ID Użytkownika.

Wymagane Pola:

• !USERID - Unikalny identyfikator partnera

Kluczowe Zachowania:

• Jeśli partner z określonym ID Użytkownika istnieje, rekord jest aktualizowany
• Jeśli ID Użytkownika nie istnieje, tworzone jest nowe konto partnera
• Puste pola statusu domyślnie ustawiają się na “Zatwierdzony”
• System automatycznie obsługuje relacje użytkownik-rodzic dla struktur wielopoziomowych
• Hasła mogą być importowane z lub bez szyfrowania salt

Mapowanie Pól: Wiersz nagłówka CSV definiuje nazwy pól przy użyciu formatu !NAZWAPOLA. Na przykład:

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

Przykład Formatu CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,jan@example.com,Jan,Kowalski,A,50.00
def67890,REF002,anna@example.com,Anna,Nowak,A,100.00

Wartości statusu:

• A - Zatwierdzony
• P - Oczekujący
• D - Odrzucony

Import/Eksport Kampanii

Co Zostaje Wyeksportowane

Eksport kampanii tworzy kompleksową kopię zapasową struktury kampanii zawierającą:

Kampanie:

• ID Kampanii, Nazwa i Opis
• Typ i Status
• Data wstawienia
• Kolejność wyświetlania
• Czas życia cookies i ustawienia nadpisywania
• Ustawienia geo-targetowania (kraje, reguły wyświetlania)
• Ustawienia zakresu ważnych dat
• URL Logo i ID Produktu

Typy Prowizji:

• ID Typu Prowizji
• Typ (sprzedaż, lead, kliknięcie itp.)
• Nazwa i Kod
• Status i ustawienia zatwierdzania
• Ustawienia presetów cykliczności
• Opcje obsługi zerowej prowizji
• Ograniczenia krajowe i miejskie

Grupy Prowizji:

• ID Grupy i Nazwa
• Powiązanie z kampanią
• Flaga grupy domyślnej

Prowizje:

• ID Prowizji
• Poziom poziomu
• Typ prowizji (procent, stała)
• Wartość
• Powiązanie z typami prowizji i grupami

Importowanie Kampanii

Import kampanii obsługuje tworzenie lub aktualizowanie kampanii ze wszystkimi powiązanymi strukturami prowizji.

Wymagane Pola według Sekcji:

• Kampanie: !CAMPAIGNID
• Typy Prowizji: !COMMTYPEID
• Grupy Prowizji: !COMMISSIONGROUPID
• Prowizje: !COMMISSIONID

Import przetwarza każdą sekcję sekwencyjnie, zapewniając prawidłowe relacje między kampaniami, typami prowizji, grupami i stawkami prowizji.

Import/Eksport Banerów

Struktura Danych Banera

Import/eksport banerów obsługuje metadane i konfigurację materiałów promocyjnych:

Eksportowane Pola:

• ID Banera
• ID Konta i ID Kampanii
• Typ Banera (graficzny, HTML, link tekstowy itp.)
• Status (aktywny/nieaktywny)
• Nazwa i Opis
• Docelowy URL
• Wymiary rozmiaru
• Pola danych (Dane1-Dane4) dla treści specyficznej dla typu
• Kolejność wyświetlania
• String SEO
• ID Wrappera
• Data wstawienia

Ważna Uwaga: Import/eksport banerów obsługuje tylko definicje, nie fizyczne pliki obrazów ani zasoby. Upewnij się, że referencyjne obrazy są dostępne pod określonymi URLami po imporcie.

Wymagane Pole:

• !BANNERID - Unikalny identyfikator banera

Przykład Formatu CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Baner Letnia Wyprzedaz,https://example.com/wyprzedaz,A
ban67890,camp001,T,Promo Link Tekstowy,https://example.com/promo,A

Typy banerów:

• I - Baner graficzny
• T - Link tekstowy
• H - Baner HTML
• I inne obsługiwane typy

Import Transakcji

Przegląd

Import transakcji to potężna funkcja do masowego ładowania sprzedaży, prowizji i innych rekordów transakcji. Jest to szczególnie przydatne do:

• Migracji danych historycznych z innych platform
• Importowania sprzedaży offline
• Wsadowego przetwarzania aktualizacji transakcji
• Synchronizacji z zewnętrznymi systemami

Dostępne Pola

Import transakcji obsługuje kompleksowy zestaw pól:

Podstawowe Pola Transakcji:

• ID Transakcji
• ID Konta
• ID Użytkownika (partner) - obsługuje ID, refid lub nazwę użytkownika
• ID Banera i ID Banera Nadrzędnego
• ID Kampanii
• ID Zamówienia i ID Produktu
• Status (oczekująca, zatwierdzona, odrzucona)
• Typ (sprzedaż, lead, kliknięcie, zwrot, obciążenie zwrotne)
• Data wstawienia i Data zatwierdzenia
• Kwota prowizji
• Całkowity Koszt i Koszt Stały
• Poziom poziomu

Informacje Śledzenia:

• Kod Kraju
• Adres IP
• Przeglądarka
• URL Referrera
• Metoda Śledzenia
• Liczba Kliknięć
• Kanał
• ID Odwiedzającego

Dodatkowe Dane:

• Pola Dodatkowych Danych (Dane1-Dane5)
• Notatka Sprzedawcy i Notatka Systemowa
• ID lub Kod Kuponu
• Informacje o walucie (ID, wartość, kurs)
• ID Typu Prowizji i ID Grupy
• Opłata Sieci
• ID Sprzedaży i informacje o Podziale

Opcje Importu

Dopasowywanie Transakcji: Import może dopasowywać istniejące transakcje według:

• ID Zamówienia - Aktualizuje transakcje z pasującym ID zamówienia
• ID Transakcji - Aktualizuje konkretną transakcję według ID
• ID Zamówienia (Wszystkie Poziomy) - Aktualizuje wszystkie transakcje poziomów dla zamówienia

Automatyczne Obliczanie Prowizji: Włącz automatyczne obliczanie prowizji, aby system obliczał kwoty prowizji na podstawie:

• Ustawień prowizji kampanii
• Grupy prowizji partnera
• Wartości całkowitego kosztu
• Reguł typu prowizji

Generowanie Prowizji Wielopoziomowych: Po włączeniu import automatycznie tworzy prowizje poziomowe na podstawie struktury nadrzędnej partnera i ustawień kampanii.

Obsługa Statusu:

• Ustaw konkretny status dla wszystkich importowanych transakcji
• Użyj statusu z pliku (wartość pola)
• Zachowaj oryginalny status przy aktualizowaniu istniejących transakcji

Presety Formatu Importu

Możesz zapisywać i ponownie używać konfiguracje formatu importu:

• Definiuj mapowania kolumn
• Ustawiaj opcje importu
• Zapisuj jako nazwane presety dla powtarzających się importów

Przykład Formatu CSV

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,ORD-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,ORD-002,P,2025-01-10 11:45:00

Obsługa Zwrotów i Obciążeń Zwrotnych

Podczas importowania zwrotów lub obciążeń zwrotnych:

• Ustaw typ transakcji na zwrot (R) lub obciążenie zwrotne (H)
• Podaj ID transakcji nadrzędnej lub ID zamówienia jako referencję
• Kwoty prowizji są automatycznie obliczane jako wartości ujemne przy użyciu automatycznego obliczania

Import/Eksport Motywów

Eksport Motywu

Eksportuj swoje niestandardowe motywy jako kompletne pakiety do backupu lub migracji:

Co Zostaje Wyeksportowane:

• Konfiguracja motywu (ustawienia theme.php)
• Wszystkie pliki szablonów (.tpl i .stpl)
• Niestandardowe pliki CSS (custom.css, custom_colors.css)
• Zasoby graficzne (JPEG, PNG, GIF, BMP)

Eksport tworzy archiwum ZIP zawierające kompletną strukturę motywu.

Konfiguracja Motywu Zawiera:

• Nazwa i opis motywu
• Autor i URL
• Moduł (panel sprzedawcy/partnera)
• Tryb wyświetlania (pojedynczy/okno)
• Domyślne ustawienia tapety
• Obraz miniatury
• Ustawienia nadpisywania CSS
• Referencja oryginalnego motywu

Import Motywu

Importuj motywy z pakietów ZIP, aby szybko wdrażać niestandardowe projekty:

Wymagania:

• Prawidłowe archiwum ZIP z konfiguracją theme.php
• Prawidłowa składnia szablonów (walidowana podczas importu)
• Prawidłowa referencja oryginalnego motywu
• Określony obraz miniatury

Walidacja: Proces importu waliduje:

• Kompletność konfiguracji motywu
• Składnię szablonów Smarty
• Istnienie oryginalnego motywu
• Ograniczenia typu pliku (tylko dozwolone rozszerzenia)

Obsługiwane Typy Plików:

• Szablony: .tpl, .stpl
• Style: .css (tylko custom.css, custom_colors.css)
• Obrazy: .jpg, .jpeg, .png, .gif, .bmp

Wymagania Formatu Danych

Struktura Pliku CSV

Ogólne Wymagania:

• Używaj kodowania UTF-8 do prawidłowej obsługi znaków
• Pierwszy wiersz powinien zawierać nagłówki kolumn
• Spójny separator w całym pliku (przecinek, średnik lub tabulacja)
• Prawidłowe znaki specjalne z escape

Format Nazwy Pola:

• Wymagane pola są poprzedzone ! (np. !USERID)
• Nazwy pól nie są wrażliwe na wielkość liter
• Niestandardowe mapowanie pozwala na elastyczną kolejność kolumn

Format Daty: Daty powinny być w rozpoznawalnym formacie:

• RRRR-MM-DD GG:MM:SS (zalecane)
• Standardowe formaty dat są automatycznie parsowane

Wartości Numeryczne:

• Używaj kropki (.) jako separatora dziesiętnego
• Bez separatorów tysięcy
• Obsługiwane wartości ujemne (np. dla zwrotów)

Pliki Wielosekcyjne

Niektóre eksporty (partnerzy, kampanie) zawierają wiele sekcji danych:

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Każda sekcja jest identyfikowana przez znacznik nagłówka i ma własną strukturę kolumn.

Najlepsze Praktyki dla Operacji Masowych

Przed Importem

1. Utwórz Kopię Zapasową Zawsze eksportuj swoje bieżące dane przed wykonywaniem masowych importów, szczególnie przy użyciu opcji usuwania.

2. Zwaliduj Swoje Dane

   • Sprawdź duplikaty ID
   • Zweryfikuj obecność wymaganych pól
   • Upewnij się, że formaty dat są spójne
   • Zwaliduj kody statusu i typu

3. Testuj na Małym Zestawie Danych Najpierw zaimportuj kilka rekordów, aby zweryfikować mapowanie i zachowanie przed przetwarzaniem dużych plików.

4. Sprawdź Zależności

   • Upewnij się, że referencyjne kampanie istnieją przed importowaniem banerów
   • Zweryfikuj, że konta partnerów istnieją przed importowaniem transakcji
   • Potwierdź, że typy prowizji są skonfigurowane przed importowaniem prowizji

Podczas Importu

5. Monitoruj Postęp Import działa jako zadanie w tle ze śledzeniem postępu. Sprawdzaj powiadomienia zadań pod kątem aktualizacji statusu i komunikatów o błędach.

6. Obsługuj Błędy Gracefully System loguje błędy dla poszczególnych rekordów, kontynuując przetwarzanie prawidłowych wpisów. Przejrzyj log importu, aby naprawić nieudane rekordy.

Po Imporcie

7. Zweryfikuj Wyniki

   • Sprawdź wyrywkowo zaimportowane rekordy
   • Zweryfikuj, że sumy i liczby odpowiadają oczekiwaniom
   • Przetestuj logowanie partnerów jeśli hasła były importowane

8. Zaktualizuj Powiązane Rekordy Niektóre importy mogą wymagać działań następczych:

   • Przypisz partnerów do kampanii
   • Prześlij obrazy banerów
   • Skonfiguruj stawki prowizji

Rozważania Wydajnościowe

9. Obsługa Dużych Plików System importu przetwarza dane w partiach, aby zapobiec timeoutom. Bardzo duże pliki mogą zająć kilka minut na ukończenie.

10. Planuj Podczas Niskiej Aktywności Dla najlepszej wydajności planuj duże importy poza godzinami szczytu, gdy obciążenie systemu jest niższe.

Uwagi Bezpieczeństwa

11. Dane Wrażliwe

    • Pola haseł są obsługiwane bezpiecznie z szyfrowaniem salt
    • Unikaj importowania wrażliwych informacji o wypłatach przez niezabezpieczone kanały
    • Przeglądaj pliki importu pod kątem nieumyślnego ujawnienia danych

12. Kontrola Dostępu Funkcje importu/eksportu wymagają odpowiednich uprawnień administratora sprzedawcy.

Typowe Przypadki Użycia

Migracja z Innej Platformy

1. Wyeksportuj dane z istniejącej platformy w formacie CSV
2. Zmapuj kolumny na nazwy pól Post Affiliate Pro
3. Najpierw zaimportuj partnerów, aby ustanowić konta użytkowników
4. Zaimportuj kampanie i struktury prowizji
5. Zaimportuj historyczne transakcje
6. Prześlij banery i materiały promocyjne

Miesięczna Synchronizacja Transakcji

1. Utwórz preset formatu importu dla swojego zewnętrznego systemu
2. Wyeksportuj transakcje z platformy e-commerce
3. Zaimportuj używając dopasowania ID Zamówienia do aktualizacji istniejących transakcji
4. Przejrzyj log importu pod kątem rozbieżności

Backup i Wdrożenie Motywu

1. Dostosuj motyw w środowisku deweloperskim
2. Wyeksportuj motyw jako pakiet ZIP
3. Zaimportuj do instalacji produkcyjnej
4. Zweryfikuj wygląd i funkcjonalność motywu

Masowe Aktualizacje Partnerów

1. Wyeksportuj bieżące dane partnerów
2. Zmodyfikuj plik CSV z aktualnymi informacjami
3. Zaimportuj z dopasowaniem według ID Użytkownika
4. Zweryfikuj, że aktualizacje zostały prawidłowo zastosowane