Systém importu a exportu

Dostupné v:

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

Prehľad

Systém importu/exportu v Post Affiliate Pro poskytuje výkonné nástroje pre hromadné dátové operácie. Či už migrujete z inej platformy, spravujete veľké datasety alebo synchronizujete údaje medzi systémami, funkcia importu/exportu šetrí čas a znižuje manuálne chyby.

Systém podporuje import a export:

• Afiliátov - Používateľské účty so všetkými údajmi profilu a možnosťami výplaty
• Kampaní - Nastavenia kampaní, typy provízií, skupiny a sadzby
• Bannerov - Definície bannerov a propagačné materiály
• Transakcií - Predaje, provízie a transakčné záznamy
• Tém - Vlastné témy panelov a šablóny

Import/Export afiliátov

Export afiliátov

Funkcia exportu afiliátov vytvára komplexný CSV súbor obsahujúci všetky údaje afiliátov z vašej inštalácie. Export zahŕňa:

Základné polia afiliáta:

• ID používateľa (jedinečný identifikátor)
• Referenčné ID (refid)
• Používateľské meno (e-mail)
• Meno a priezvisko
• Stav účtu (čakajúci, schválený, zamietnutý)
• Dátum vloženia a dátum schválenia
• ID nadradeného používateľa (pre viacúrovňové štruktúry)
• Minimálna výplata
• Poznámky a fotka

Vlastné dátové polia:

• Data1 až Data25 (vlastné polia afiliáta)

Možnosti výplaty: Export tiež obsahuje samostatnú sekciu pre možnosti výplaty, obsahujúcu:

• ID používateľa
• Názov poľa výplaty
• Hodnota poľa výplaty

Import afiliátov

Pri importe afiliátov systém spracuje CSV súbor a buď vytvorí nové afiliátske účty alebo aktualizuje existujúce na základe ID používateľa.

Povinné polia:

• !USERID - Jedinečný identifikátor afiliáta

Kľúčové správanie:

• Ak afiliát so špecifikovaným ID používateľa existuje, záznam sa aktualizuje
• Ak ID používateľa neexistuje, vytvorí sa nový afiliátsky účet
• Prázdne polia stavu sa predvolene nastavia na “Schválený”
• Systém automaticky spracováva vzťahy nadradený-používateľ pre viacúrovňové štruktúry
• Heslá môžu byť importované so šifrovaním salt alebo bez neho

Mapovanie polí: Hlavičkový riadok CSV definuje názvy polí pomocou formátu !NÁZOVPOĽA. Napríklad:

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

Príklad formátu CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,jan@example.com,Ján,Novák,A,50.00
def67890,REF002,jana@example.com,Jana,Nováková,A,100.00

Hodnoty stavu:

• A - Schválený
• P - Čakajúci
• D - Zamietnutý

Import/Export kampaní

Čo sa exportuje

Export kampaní vytvára komplexnú zálohu štruktúry vašich kampaní vrátane:

Kampane:

• ID kampane, názov a popis
• Typ a stav
• Dátum vloženia
• Poradie zobrazenia
• Životnosť cookie a nastavenia prepísania
• Nastavenia geografického cielenia (krajiny, pravidlá zobrazenia)
• Nastavenia rozsahu platných dátumov
• URL loga a ID produktu

Typy provízií:

• ID typu provízie
• Typ (predaj, lead, klik atď.)
• Názov a kód
• Stav a nastavenia schválenia
• Nastavenia predvoľby opakovania
• Možnosti spracovania nulovej provízie
• Obmedzenia krajín a miest

Provízne skupiny:

• ID skupiny a názov
• Priradenie ku kampani
• Príznak predvolenej skupiny

Provízie:

• ID provízie
• Úroveň tier
• Typ provízie (percentuálna, pevná)
• Hodnota
• Priradenie k typom provízií a skupinám

Import kampaní

Import kampaní podporuje vytváranie alebo aktualizáciu kampaní so všetkými ich súvisiacimi províznymi štruktúrami.

Povinné polia podľa sekcie:

• Kampane: !CAMPAIGNID
• Typy provízií: !COMMTYPEID
• Provízne skupiny: !COMMISSIONGROUPID
• Provízie: !COMMISSIONID

Import spracováva každú sekciu postupne, zabezpečujúc správne vzťahy medzi kampaňami, typmi provízií, skupinami a províznymi sadzbami.

Import/Export bannerov

Štruktúra údajov bannerov

Import/export bannerov spracováva metadáta a konfiguráciu vašich propagačných materiálov:

Exportované polia:

• ID bannera
• ID účtu a ID kampane
• Typ bannera (obrázok, HTML, textový odkaz atď.)
• Stav (aktívny/neaktívny)
• Názov a popis
• Cieľová URL
• Rozmery
• Dátové polia (Data1-Data4) pre obsah špecifický pre typ
• Poradie zobrazenia
• SEO reťazec
• ID wrappera
• Dátum vloženia

Dôležitá poznámka: Import/export bannerov spracováva iba definície, nie fyzické obrázkové súbory alebo assety. Zabezpečte, aby odkazované obrázky boli dostupné na špecifikovaných URL po importe.

Povinné pole:

• !BANNERID - Jedinečný identifikátor bannera

Príklad formátu CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Letný výpredaj Banner,https://example.com/vypredaj,A
ban67890,camp001,T,Textový odkaz Promo,https://example.com/promo,A

Typy bannerov:

• I - Obrázkový banner
• T - Textový odkaz
• H - HTML banner
• A ďalšie podporované typy

Import transakcií

Prehľad

Import transakcií je výkonná funkcia pre hromadné načítanie predajov, provízií a iných transakčných záznamov. Je to obzvlášť užitočné pre:

• Migráciu historických údajov z iných platforiem
• Import offline predajov
• Dávkové spracovanie aktualizácií transakcií
• Synchronizáciu s externými systémami

Dostupné polia

Import transakcií podporuje komplexnú sadu polí:

Základné polia transakcií:

• ID transakcie
• ID účtu
• ID používateľa (afiliát) - podporuje ID, refid alebo používateľské meno
• ID bannera a ID nadradeného bannera
• ID kampane
• ID objednávky a ID produktu
• Stav (čakajúci, schválený, zamietnutý)
• Typ (predaj, lead, klik, refundácia, chargeback)
• Dátum vloženia a dátum schválenia
• Suma provízie
• Celková cena a pevná cena
• Úroveň tier

Informácie o sledovaní:

• Kód krajiny
• IP adresa
• Prehliadač
• URL referrera
• Metóda sledovania
• Počet klikov
• Kanál
• ID návštevníka

Dodatočné údaje:

• Extra dátové polia (Data1-Data5)
• Poznámka obchodníka a systémová poznámka
• ID alebo kód kupónu
• Informácie o mene (ID, hodnota, kurz)
• ID typu provízie a ID skupiny
• Sieťový poplatok
• ID predaja a informácie o rozdelení

Možnosti importu

Porovnávanie transakcií: Import môže porovnávať existujúce transakcie podľa:

• ID objednávky - Aktualizuje transakcie so zodpovedajúcim ID objednávky
• ID transakcie - Aktualizuje konkrétnu transakciu podľa ID
• ID objednávky (Všetky úrovne) - Aktualizuje všetky úrovňové transakcie pre objednávku

Automatický výpočet provízií: Povolenie automatického výpočtu provízií umožní systému vypočítať sumy provízií na základe:

• Nastavení provízií kampane
• Províznej skupiny afiliáta
• Hodnoty celkovej ceny
• Pravidiel typu provízie

Generovanie viacúrovňových provízií: Keď je povolené, import automaticky vytvára úrovňové provízie na základe upline štruktúry afiliáta a nastavení kampane.

Spracovanie stavu:

• Nastaviť konkrétny stav pre všetky importované transakcie
• Použiť stav zo súboru (hodnota poľa)
• Zachovať pôvodný stav pri aktualizácii existujúcich transakcií

Predvoľby formátu importu

Môžete uložiť a znovu použiť konfigurácie formátu importu:

• Definovať mapovania stĺpcov
• Nastaviť možnosti importu
• Uložiť ako pomenované predvoľby pre opakované importy

Príklad formátu 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

Spracovanie refundácií a chargebackov

Pri importe refundácií alebo chargebackov:

• Nastavte typ transakcie na refundáciu (R) alebo chargeback (H)
• Poskytnite ID nadradenej transakcie alebo ID objednávky pre referenciu
• Sumy provízií sa automaticky vypočítajú ako záporné hodnoty pri použití automatického výpočtu

Import/Export tém

Export tém

Exportujte vlastné témy ako kompletné balíčky pre zálohu alebo migráciu:

Čo sa exportuje:

• Konfigurácia témy (nastavenia theme.php)
• Všetky súbory šablón (.tpl a .stpl)
• Vlastné CSS súbory (custom.css, custom_colors.css)
• Obrázkové assety (JPEG, PNG, GIF, BMP)

Export vytvára ZIP archív obsahujúci kompletnú štruktúru témy.

Konfigurácia témy zahŕňa:

• Názov a popis témy
• Autora a URL
• Modul (obchodnícky/afiliátsky panel)
• Režim zobrazenia (single/window)
• Predvolené nastavenia tapety
• Náhľadový obrázok
• Nastavenia prepísania CSS
• Referenciu na pôvodnú tému

Import tém

Importujte témy z ZIP balíčkov pre rýchle nasadenie vlastných dizajnov:

Požiadavky:

• Platný ZIP archív s konfiguráciou theme.php
• Správna syntax šablón (validovaná počas importu)
• Platná referencia na pôvodnú tému
• Špecifikovaný náhľadový obrázok

Validácia: Proces importu validuje:

• Kompletnosť konfigurácie témy
• Syntax Smarty šablón
• Existenciu pôvodnej témy
• Obmedzenia typov súborov (iba povolené prípony)

Podporované typy súborov:

• Šablóny: .tpl, .stpl
• Štýly: .css (iba custom.css, custom_colors.css)
• Obrázky: .jpg, .jpeg, .png, .gif, .bmp

Požiadavky na formát údajov

Štruktúra CSV súboru

Všeobecné požiadavky:

• Použite kódovanie UTF-8 pre správne spracovanie znakov
• Prvý riadok by mal obsahovať hlavičky stĺpcov
• Konzistentný oddeľovač v celom súbore (čiarka, bodkočiarka alebo tabulátor)
• Správne escapované špeciálne znaky

Formát názvov polí:

• Povinné polia sú prefixované znakom ! (napr. !USERID)
• Názvy polí nerozlišujú veľké/malé písmená
• Vlastné mapovanie umožňuje flexibilné poradie stĺpcov

Formát dátumu: Dátumy by mali byť v rozpoznateľnom formáte:

• YYYY-MM-DD HH:MM:SS (odporúčané)
• Štandardné formáty dátumu sa automaticky parsujú

Číselné hodnoty:

• Použite bodku (.) ako desatinný oddeľovač
• Žiadne oddeľovače tisícov
• Záporné hodnoty podporované (napr. pre refundácie)

Viacsekciové súbory

Niektoré exporty (afiliáti, kampane) obsahujú viacero dátových sekcií:

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

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

Každá sekcia je identifikovaná značkou hlavičky a má vlastnú štruktúru stĺpcov.

Osvedčené postupy pre hromadné operácie

Pred importom

1. Vytvorte zálohu Vždy exportujte svoje aktuálne údaje pred vykonávaním hromadných importov, najmä pri použití možnosti vymazania.

2. Validujte svoje údaje

   • Skontrolujte duplicitné ID
   • Overte prítomnosť povinných polí
   • Zabezpečte konzistenciu formátov dátumov
   • Validujte kódy stavov a typov

3. Testujte s malým datasetom Najprv importujte niekoľko záznamov na overenie mapovania a správania pred spracovaním veľkých súborov.

4. Skontrolujte závislosti

   • Zabezpečte existenciu odkazovaných kampaní pred importom bannerov
   • Overte existenciu afiliátskych účtov pred importom transakcií
   • Potvrďte nastavenie typov provízií pred importom provízií

Počas importu

5. Monitorujte priebeh Import beží ako úloha na pozadí so sledovaním priebehu. Kontrolujte notifikácie úloh pre aktualizácie stavu a chybové správy.

6. Spracovávajte chyby elegantne Systém loguje chyby pre jednotlivé záznamy pričom pokračuje v spracovaní platných záznamov. Skontrolujte log importu pre riešenie neúspešných záznamov.

Po importe

7. Overte výsledky

   • Namátkovo skontrolujte importované záznamy
   • Overte, že súčty a počty zodpovedajú očakávaniam
   • Testujte prihlásenia afiliátov, ak boli importované heslá

8. Aktualizujte súvisiace záznamy Niektoré importy môžu vyžadovať následné akcie:

   • Priradiť afiliátov ku kampaniam
   • Nahrať obrázky bannerov
   • Nakonfigurovať provízne sadzby

Úvahy o výkone

9. Spracovanie veľkých súborov Systém importu spracováva údaje v dávkach na prevenciu timeoutov. Veľmi veľké súbory môžu trvať niekoľko minút.

10. Plánujte počas nízkej aktivity Pre najlepší výkon plánujte veľké importy počas mimo špičkových hodín, keď je zaťaženie systému nižšie.

Bezpečnostné poznámky

11. Citlivé údaje

    • Polia hesiel sa spracovávajú bezpečne so salt šifrovaním
    • Vyhnite sa importu citlivých informácií o výplatách cez nezabezpečené kanály
    • Skontrolujte importové súbory pre neúmyselné vystavenie údajov

12. Riadenie prístupu Funkcie importu/exportu vyžadujú príslušné oprávnenia administrátora obchodníka.

Bežné prípady použitia

Migrácia z inej platformy

1. Exportujte údaje z vašej existujúcej platformy vo formáte CSV
2. Namapujte stĺpce na názvy polí Post Affiliate Pro
3. Najprv importujte afiliátov na vytvorenie používateľských účtov
4. Importujte kampane a provízne štruktúry
5. Importujte historické transakcie
6. Nahrajte bannery a propagačné materiály

Mesačná synchronizácia transakcií

1. Vytvorte predvoľbu formátu importu pre váš externý systém
2. Exportujte transakcie z vašej e-commerce platformy
3. Importujte pomocou porovnávania ID objednávky na aktualizáciu existujúcich transakcií
4. Skontrolujte log importu pre akékoľvek nezrovnalosti

Záloha a nasadenie témy

1. Prispôsobte svoju tému v vývojovom prostredí
2. Exportujte tému ako ZIP balíček
3. Importujte do produkčnej inštalácie
4. Overte vzhľad a funkčnosť témy

Hromadné aktualizácie afiliátov

1. Exportujte aktuálne údaje afiliátov
2. Upravte CSV súbor s aktualizovanými informáciami
3. Importujte s porovnávaním podľa ID používateľa
4. Overte správne aplikované aktualizácie