# OptiMonk kampányok integrálása Maileon-nal Canonical URL: https://support.optimonk.com/hu/articles/integrating-optimonk-campaigns-with-maileon A [Maileon](https://maileon.hu/) integráció lehetővé teszi, hogy feliratkozókat adj a Maileon kontaktlistádhoz, amikor kitöltik egy OptiMonk popup űrlapot – az általad választott opt-in engedéllyel, és a kontakton tárolni kívánt extra adatokkal. **Mielőtt elkezdenéd:** szükséged van egy kampányra, amelynek popupja már elkészült (a mezőmegfeleltetés a popup beviteli mezőiből olvasódik ki), valamint egy Maileon fiókra. --- ## 1. Szerezd meg a Maileon API kulcsodat Jelentkezz be a Maileon fiókodba, és lépj a **SETTINGS → API KEYS (Beállítások → API kulcsok)** menüpontba. - Ha már van API kulcsod, másold ki. - Ha nincs, kattints a **Generate new API key (Új API kulcs generálása)** gombra. Válassz egy tetszőleges nevet, állítsd a státuszt **Aktív**-ra, és adj engedélyt a **kontaktok létrehozására és frissítésére** funkcióhoz. Ezen engedélyek nélkül az OptiMonk nem tudja hozzáadni a feliratkozót. Az OptiMonk saját súgó szövege ehhez a mezőhöz így szól: *Please find the API key within Maileon account, under Settings then API keys options. (ex.: 9b6e40f4-db7b-4059-8d4a-2db082d709df)* --- ## 2. Double opt-in beállítása a Maileon-ban (opcionális) Ha azt szeretnéd, hogy az új feliratkozók megerősítsék a címüket, először állítsd be a folyamatot a Maileon oldalán: **Settings → Dispatches: Double Opt-In (Beállítások → Kiküldések: Double Opt-In)** Ezután a 3. lépésben az OptiMonk-ban választod ki a megfelelő engedélyszintet. --- ## 3. Hozz létre egy kontaktmezőt a forrás számára (opcionális) Ha a Maileon listádat szegmentálni szeretnéd aszerint, honnan érkezett a kontakt, hozz létre egy mezőt ennek tárolására: lépj a **LISTS & CONTACTS → CONTACT FIELDS (Listák és kontaktok → Kontaktmezők)** menüpontra, kattints a lista jobb felső sarkában lévő zöld plusz jelre, válassz egy nevet, állítsd be a **Field type (Mezőtípus)** értéket **Text (Szöveg)**-ra, és kattints a **create new contact field (Új kontaktmező létrehozása)** gombra. Ezt a mezőt az OptiMonk-ból fogod feltölteni a mezőmegfeleltetés lépésben, statikus mezőként. --- ## 4. Kapcsold össze a Maileon-t a kampányoddal 1. Nyisd meg a **Kampányok** menüpontot a bal oldali menüben, és kattints arra a kampányra, amelyet a Maileon-nal szeretnél összekapcsolni. 2. Nyisd meg az **Integrációk** fület a kampányon. 3. Kattints az **Integráció hozzáadása** gombra. Ha ez a kampány első integrációja, ugyanez a lépés *Kösd össze az email vagy SMS eszközöddel*. 4. **Szolgáltató** lépésként jelenik meg. Válaszd a **Maileon**-t. Használd a *Szolgáltató keresése…* mezőt, ha hosszú a lista. Ha korábban már kapcsolódtál a Maileon-hoz, a fiók a lista tetején jelenik meg a *Csatlakoztatott fiókjaid* alatt – válaszd ki ott, és ugorj a 6. lépésre. 5. **Fiók** lépés: illeszd be a kulcsot az **API kulcs** mezőbe, opcionálisan adj nevet a kapcsolatnak (**Név (opcionális)**), és kattints a **Csatlakoztatás** gombra. Az OptiMonk azonnal ellenőrzi a hitelesítő adatokat: ha hibásak, a lépés ezt írja ki: **Sikertelen kapcsolódás — ellenőrizd a hitelesítő adatokat**. 6. **Beállítások** lépés – itt döntöd el az opt-in beállítást: - **Opt-in engedély** – az engedélyszint, amellyel az új kontakt létrejön: *Nincs*, *Egyszeres opt-in*, *Megerősített opt-in*, *Dupla opt-in*, *Dupla opt-in plusz*, *Egyéb* . Alapértelmezetten *None* van beállítva, ezért tudatosan állítsd be. - **Double opt-in e-mail küldése** – jelöld be, hogy a Maileon elküldje a megerősítő e-mailt. 7. Kattints a **Folytatás** gombra, majd a **Mezők összerendelése** lépésben döntsd el, hogy az egyes popup mezők hova kerüljenek a Maileon-ban (lásd lent), majd kattints az **Integráció mentése** gombra. Ennyi! Amikor egy látogató feliratkozik a popupodon keresztül, hozzáadódik a Maileon kontaktlistádhoz. Az adatai az OptiMonk-ban is megmaradnak – ezeket a **Közönség** menüpont alatt találod a bal oldali menüben. > **Vázlat vs. élő:** ha a kampány még nincs publikálva, az integráció egy **Piszkozat** jelölővel és a következő megjegyzéssel jelenik meg: *Piszkozatként mentve — a kampány publikálásakor lép élesbe.* Egy publikált kampányon **Aktív** -ként jelenik meg, és azonnal alkalmazásra kerül. --- ## Mezőmegfeleltetés és a forrás elküldése A Maileon-nál nincs lista, amelyből választhatnál, ezért a varázsló középső lépése **Beállítások** lesz lista helyett, és a megfeleltetés lépés közvetlenül ez után következik. A megfeleltetési táblázatnak két oszlopa van: **Popup mező** a bal oldalon (minden beviteli mező, amit a popupod összegyűjt), és **Maileon mező** a jobb oldalon. Az OptiMonk saját javaslataival előre kitölti. - Az **e-mail** sor rögzített – ez mindig a Maileon e-mail mezőjéhez van megfeleltetve. - Mivel a Maileon lista nélkül van konfigurálva, a jobb oldali oszlop egy szabadszöveges mező: *Type the exact Maileon field or property name (e.g. first_name). Leave empty to skip a field. (Írd be a pontos Maileon mező- vagy tulajdonságnevet (pl. first_name). Hagyd üresen, ha ki akarsz hagyni egy mezőt.)* Írd be a kontaktmező nevét pontosan úgy, ahogyan a Maileon-ban szerepel. - **A forrás is itt kerül megadásra.** Kattints a **Statikus mező hozzáadása** gombra, írd be az értéket a bal oldalon – bármilyen szöveget, például `OptiMonk`, vagy `OptiMonk Winter Campaign` -t, ha meg akarod különböztetni a kampányokat – majd add meg a jobb oldalon a 3. lépésben létrehozott kontaktmező nevét. Ez az érték minden feliratkozással elküldésre kerül. --- ## Az integráció módosítása vagy eltávolítása Az Integrations fül felsorolja a kampányon lévő minden integrációt, alattuk pedig az általad kiválasztott opt-in beállítások láthatók. - **Lista módosítása** újra megnyitja a varázslót a Settings lépésnél, így módosíthatod az opt-in engedélyt vagy a megfeleltetést. - **Eltávolítás** leveszi az integrációt erről a kampányról: *Eltávolítod ebből a kampányból? A fiók-kapcsolat megmarad, és később újra hozzáadható.* A Maileon hitelesítő adataid nem törlődnek, így egy másik kampányon is felhasználhatod őket.