Import/Export rendszer

Elérhető:

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

Áttekintés

A Post Affiliate Pro Import/Export rendszere hatékony eszközöket biztosít a tömeges adatműveletekhez. Akár másik platformról migrál, nagy adatkészleteket kezel, vagy rendszerek között szinkronizál adatokat, az import/export funkcionalitás időt takarít meg és csökkenti a manuális hibákat.

A rendszer támogatja a következők importálását és exportálását:

• Partnerek - Felhasználói fiókok minden profil adattal és kifizetési opciókkal
• Kampányok - Kampánybeállítások, jutaléktípusok, csoportok és mértékek
• Bannerek - Banner definíciók és promóciós anyagok
• Tranzakciók - Eladások, jutalékok és tranzakciós rekordok
• Témák - Egyéni panel témák és sablonok

Partner import/export

Partnerek exportálása

A partner export funkció átfogó CSV fájlt hoz létre, amely tartalmazza a telepítés összes partner adatát. Az export tartalmazza:

Alap partner mezők:

• Felhasználói azonosító (egyedi azonosító)
• Hivatkozási azonosító (refid)
• Felhasználónév (e-mail)
• Keresztnév és vezetéknév
• Fiók státusz (függőben, jóváhagyott, elutasított)
• Beillesztés dátuma és jóváhagyás dátuma
• Szülő felhasználói azonosító (többszintű struktúrákhoz)
• Minimális kifizetési küszöb
• Megjegyzések és fénykép

Egyéni adatmezők:

• Data1-től Data25-ig (egyéni partner mezők)

Kifizetési opciók: Az export tartalmaz egy külön szekciót is a kifizetési opciókhoz:

• Felhasználói azonosító
• Kifizetési mező neve
• Kifizetési mező értéke

Partnerek importálása

Partnerek importálásakor a rendszer feldolgozza a CSV fájlt és vagy új partner fiókokat hoz létre, vagy frissíti a meglévőket a felhasználói azonosító alapján.

Kötelező mezők:

• !USERID - A partner egyedi azonosítója

Kulcsfontosságú viselkedések:

• Ha a megadott felhasználói azonosítóval rendelkező partner létezik, a rekord frissül
• Ha a felhasználói azonosító nem létezik, új partner fiók jön létre
• Az üres státusz mezők alapértelmezetten “Jóváhagyott” értéket kapnak
• A rendszer automatikusan kezeli a szülő-felhasználó kapcsolatokat többszintű struktúráknál
• A jelszavak importálhatók sózott titkosítással vagy anélkül

Mezőmegfeleltetés: A CSV fejlécsor határozza meg a mezőneveket a !MEZONEV formátumban. Például:

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

CSV formátum példa

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,john@example.com,John,Smith,A,50.00
def67890,REF002,jane@example.com,Jane,Doe,A,100.00

Státusz értékek:

• A - Jóváhagyott
• P - Függőben
• D - Elutasított

Kampány import/export

Mit tartalmaz az export

A kampány export átfogó biztonsági mentést készít a kampánystruktúrájáról, beleértve:

Kampányok:

• Kampány azonosító, név és leírás
• Típus és státusz
• Beillesztés dátuma
• Megjelenítési sorrend
• Cookie élettartam és felülírási beállítások
• Földrajzi célzási beállítások (országok, megjelenítési szabályok)
• Érvényességi dátumtartomány beállítások
• Logó URL és termék azonosító

Jutaléktípusok:

• Jutaléktípus azonosító
• Típus (eladás, lead, kattintás stb.)
• Név és kód
• Státusz és jóváhagyási beállítások
• Ismétlődési előbeállítások
• Nulla jutalék kezelési opciók
• Ország és város korlátozások

Jutalékcsoportok:

• Csoport azonosító és név
• Kampány társítás
• Alapértelmezett csoport jelző

Jutalékok:

• Jutalék azonosító
• Szint
• Jutaléktípus (százalék, fix)
• Érték
• Társítás jutaléktípusokhoz és csoportokhoz

Kampányok importálása

A kampány import támogatja kampányok létrehozását vagy frissítését az összes kapcsolódó jutalékstruktúrával.

Kötelező mezők szekciónként:

• Kampányok: !CAMPAIGNID
• Jutaléktípusok: !COMMTYPEID
• Jutalékcsoportok: !COMMISSIONGROUPID
• Jutalékok: !COMMISSIONID

Az import minden szekciót egymás után dolgoz fel, biztosítva a megfelelő kapcsolatokat a kampányok, jutaléktípusok, csoportok és jutalékmértékek között.

Banner import/export

Banner adatstruktúra

A banner import/export kezeli a promóciós anyagok metaadatait és konfigurációját:

Exportált mezők:

• Banner azonosító
• Fiók azonosító és kampány azonosító
• Banner típus (kép, HTML, szöveges link stb.)
• Státusz (aktív/inaktív)
• Név és leírás
• Cél URL
• Méret dimenziók
• Adatmezők (Data1-Data4) típusspecifikus tartalomhoz
• Megjelenítési sorrend
• SEO karakterlánc
• Wrapper azonosító
• Beillesztés dátuma

Fontos megjegyzés: A banner import/export csak a definíciókat kezeli, nem a fizikai képfájlokat vagy eszközöket. Győződjön meg arról, hogy a hivatkozott képek elérhetők a megadott URL-eken az importálás után.

Kötelező mező:

• !BANNERID - Egyedi banner azonosító

CSV formátum példa

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Nyári akció banner,https://example.com/sale,A
ban67890,camp001,T,Szöveges link promó,https://example.com/promo,A

Banner típusok:

• I - Kép banner
• T - Szöveges link
• H - HTML banner
• És egyéb támogatott típusok

Tranzakció import

Áttekintés

A tranzakció import hatékony funkció eladások, jutalékok és egyéb tranzakciós rekordok tömeges betöltéséhez. Ez különösen hasznos:

• Korábbi adatok migrálásához más platformokról
• Offline eladások importálásához
• Tranzakció frissítések kötegelt feldolgozásához
• Külső rendszerekkel való szinkronizáláshoz

Elérhető mezők

A tranzakció import mezők átfogó készletét támogatja:

Alap tranzakciós mezők:

• Tranzakció azonosító
• Fiók azonosító
• Felhasználói azonosító (partner) - támogatja az azonosítót, refid-et vagy felhasználónevet
• Banner azonosító és szülő banner azonosító
• Kampány azonosító
• Rendelési azonosító és termék azonosító
• Státusz (függőben, jóváhagyott, elutasított)
• Típus (eladás, lead, kattintás, visszatérítés, visszaterhelés)
• Beillesztés dátuma és jóváhagyás dátuma
• Jutalék összeg
• Teljes költség és fix költség
• Szint

Követési információk:

• Országkód
• IP-cím
• Böngésző
• Hivatkozó URL
• Követési módszer
• Kattintás szám
• Csatorna
• Látogató azonosító

További adatok:

• Extra adatmezők (Data1-Data5)
• Kereskedői megjegyzés és rendszermegjegyzés
• Kupon azonosító vagy kód
• Pénznem információk (azonosító, érték, árfolyam)
• Jutaléktípus azonosító és csoport azonosító
• Hálózati díj
• Eladás azonosító és felosztási információ

Import opciók

Tranzakció egyeztetés: Az import egyeztetheti a meglévő tranzakciókat:

• Rendelési azonosító - Frissíti a megfelelő rendelési azonosítójú tranzakciókat
• Tranzakció azonosító - Frissíti a konkrét tranzakciót azonosító alapján
• Rendelési azonosító (minden szint) - Frissíti egy rendelés összes szintű tranzakcióját

Automatikus jutalékszámítás: Engedélyezze az automatikus jutalékszámítást, hogy a rendszer kiszámítsa a jutalék összegeket a következők alapján:

• Kampány jutalék beállítások
• Partner jutalékcsoportja
• Teljes költség érték
• Jutaléktípus szabályok

Többszintű jutalék generálás: Ha engedélyezve van, az import automatikusan létrehozza a szintjutalékokat a partner upline struktúrája és kampánybeállítások alapján.

Státusz kezelés:

• Állítson be konkrét státuszt minden importált tranzakcióhoz
• Használja a fájl státuszát (mezőérték)
• Őrizze meg az eredeti státuszt meglévő tranzakciók frissítésekor

Import formátum előbeállítások

Mentheti és újrahasználhatja az import formátum konfigurációkat:

• Oszlopmegfeleltetések definiálása
• Import opciók beállítása
• Mentés elnevezett előbeállításként ismétlődő importokhoz

CSV formátum példa

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

Visszatérítések és visszaterhelések kezelése

Visszatérítések vagy visszaterhelések importálásakor:

• Állítsa a tranzakció típusát visszatérítésre (R) vagy visszaterhelésre (H)
• Adja meg a szülő tranzakció azonosítót vagy rendelési azonosítót hivatkozásként
• A jutalék összegek automatikusan negatív értékként számítódnak automatikus számítás használatakor

Téma import/export

Téma export

Exportálja egyéni témáit teljes csomagokként biztonsági mentéshez vagy migráláshoz:

Mit tartalmaz az export:

• Téma konfiguráció (theme.php beállítások)
• Minden sablonfájl (.tpl és .stpl)
• Egyéni CSS fájlok (custom.css, custom_colors.css)
• Kép eszközök (JPEG, PNG, GIF, BMP)

Az export ZIP archívumot hoz létre a teljes témastruktúrával.

Téma konfiguráció tartalmazza:

• Téma név és leírás
• Szerző és URL
• Modul (kereskedői/partner panel)
• Megjelenítési mód (single/window)
• Alapértelmezett háttérkép beállítások
• Bélyegkép
• CSS felülírási beállítások
• Eredeti téma hivatkozás

Téma import

Importáljon témákat ZIP csomagokból az egyéni tervek gyors telepítéséhez:

Követelmények:

• Érvényes ZIP archívum theme.php konfigurációval
• Megfelelő sablon szintaxis (importálás során validálva)
• Érvényes eredeti téma hivatkozás
• Megadott bélyegkép

Validálás: Az import folyamat validálja:

• Téma konfiguráció teljességét
• Smarty sablon szintaxist
• Eredeti téma létezését
• Fájltípus korlátozásokat (csak engedélyezett kiterjesztések)

Támogatott fájltípusok:

• Sablonok: .tpl, .stpl
• Stílusok: .css (csak custom.css, custom_colors.css)
• Képek: .jpg, .jpeg, .png, .gif, .bmp

Adatformátum követelmények

CSV fájl struktúra

Általános követelmények:

• Használjon UTF-8 kódolást a megfelelő karakterkezeléshez
• Az első sor oszlopfejléceket tartalmazzon
• Konzisztens elválasztó az egész fájlban (vessző, pontosvessző vagy tabulátor)
• Megfelelően escape-elt speciális karakterek

Mezőnév formátum:

• A kötelező mezők ! előtaggal rendelkeznek (pl. !USERID)
• A mezőnevek nem érzékenyek a kis- és nagybetűkre
• Az egyéni megfeleltetés rugalmas oszlopsorrendet tesz lehetővé

Dátum formátum: A dátumoknak felismerhető formátumban kell lenniük:

• ÉÉÉÉ-HH-NN ÓÓ:PP:MM (ajánlott)
• A standard dátumformátumok automatikusan feldolgozásra kerülnek

Numerikus értékek:

• Használjon pontot (.) tizedeselválasztóként
• Ne használjon ezres elválasztót
• Negatív értékek támogatottak (pl. visszatérítésekhez)

Több szekciós fájlok

Egyes exportok (partnerek, kampányok) több adatszekciót tartalmaznak:

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

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

Minden szekciót fejléc jelölő azonosít, és saját oszlopstruktúrával rendelkezik.

Tömeges műveletek legjobb gyakorlatai

Importálás előtt

1. Készítsen biztonsági mentést Mindig exportálja aktuális adatait tömeges importálás előtt, különösen a törlés opció használatakor.

2. Validálja adatait

   • Ellenőrizze a duplikált azonosítókat
   • Győződjön meg a kötelező mezők jelenlétéről
   • Biztosítsa a dátumformátumok konzisztenciáját
   • Validálja a státusz és típuskódokat

3. Teszteljen kis adatkészlettel Először importáljon néhány rekordot a megfeleltetés és viselkedés ellenőrzésére, mielőtt nagy fájlokat dolgozna fel.

4. Ellenőrizze a függőségeket

   • Győződjön meg a hivatkozott kampányok létezéséről bannerek importálása előtt
   • Ellenőrizze a partner fiókok létezését tranzakciók importálása előtt
   • Győződjön meg a jutaléktípusok beállításáról jutalékok importálása előtt

Importálás közben

5. Figyelje a folyamatot Az import háttérfeladatként fut folyamatkövetéssel. Ellenőrizze a feladat értesítéseket a státuszfrissítésekért és hibaüzenetekért.

6. Kezelje a hibákat megfelelően A rendszer naplózza az egyedi rekordok hibáit, miközben folytatja az érvényes bejegyzések feldolgozását. Tekintse át az import naplót a sikertelen rekordok kezeléséhez.

Importálás után

7. Ellenőrizze az eredményeket

   • Szúrópróbaszerűen ellenőrizze az importált rekordokat
   • Ellenőrizze, hogy az összegek és számok megfelelnek a várakozásoknak
   • Tesztelje a partner bejelentkezéseket, ha jelszavak kerültek importálásra

8. Frissítse a kapcsolódó rekordokat Egyes importok utólagos műveleteket igényelhetnek:

   • Partnerek hozzárendelése kampányokhoz
   • Banner képek feltöltése
   • Jutalékmértékek konfigurálása

Teljesítmény megfontolások

9. Nagy fájlok kezelése Az import rendszer kötegekben dolgozza fel az adatokat az időtúllépések megelőzésére. Nagyon nagy fájlok feldolgozása több percig tarthat.

10. Ütemezés alacsony aktivitási időszakra A legjobb teljesítmény érdekében ütemezze a nagy importokat csúcsidőn kívüli órákra, amikor a rendszerterhelés alacsonyabb.

Biztonsági megjegyzések

11. Érzékeny adatok

    • A jelszó mezők biztonságosan kezeltek sózott titkosítással
    • Kerülje az érzékeny kifizetési információk importálását nem biztonságos csatornákon keresztül
    • Vizsgálja át az importfájlokat a nem szándékos adatexponálás szempontjából

12. Hozzáférés-vezérlés Az import/export funkciók megfelelő kereskedői adminisztrátori jogosultságokat igényelnek.

Gyakori felhasználási esetek

Migrálás másik platformról

1. Exportálja az adatokat meglévő platformjáról CSV formátumban
2. Feleltetse meg az oszlopokat a Post Affiliate Pro mezőnevekhez
3. Először importálja a partnereket a felhasználói fiókok létrehozásához
4. Importálja a kampányokat és jutalékstruktúrákat
5. Importálja a korábbi tranzakciókat
6. Töltse fel a bannereket és promóciós anyagokat

Havi tranzakció szinkronizálás

1. Hozzon létre import formátum előbeállítást a külső rendszeréhez
2. Exportálja a tranzakciókat az e-kereskedelmi platformjáról
3. Importáljon rendelési azonosító egyeztetéssel a meglévő tranzakciók frissítéséhez
4. Tekintse át az import naplót az eltérésekért

Téma biztonsági mentés és telepítés

1. Testreszabja témáját fejlesztési környezetben
2. Exportálja a témát ZIP csomagként
3. Importálja az éles telepítésbe
4. Ellenőrizze a téma megjelenését és funkcionalitását

Tömeges partner frissítések

1. Exportálja az aktuális partner adatokat
2. Módosítsa a CSV fájlt a frissített információkkal
3. Importáljon felhasználói azonosító egyeztetéssel
4. Ellenőrizze a frissítések helyes alkalmazását