# OptiMonk kampányok integrálása Ontraport-tal Canonical URL: https://support.optimonk.com/hu/articles/integrating-optimonk-campaigns-with-ontraport Az [Ontraport](https://app.ontraport.com/) összekapcsolása egy OptiMonk kampánnyal azt jelenti, hogy minden látogató, aki kitölti a popup űrlapját, bekerül az Ontraport kontaktlistádba – címkével ellátva, és ha szeretnéd, egy sorozatra feliratkoztatva. Nincs exportálás, nincs másolás-beillesztés. **Mielőtt elkezded:** szükséged van egy kampányra, amelynek a popupja már elkészült (a mezők összerendelését a popup beviteli mezőiből olvassa ki a rendszer), valamint egy Ontraport fiókra. --- ## 1. lépés – Szerezd meg az App ID-t és az API Key-t az Ontraportból 1. Jelentkezz be az Ontraport fiókodba. A lap jobb felső sarkában kattints a fiókod nevére a legördülő menü megnyitásához, majd válaszd az **Administration (Adminisztráció)** menüpontot. 2. Az Administration oldalon az **INTEGRATIONS (Integrációk)** szakaszban válaszd az **ONTRAPORT API INSTRUCTIONS AND KEY MANAGER** lehetőséget. 3. Ha még nincs API-kulcsod, kattints a **New API Key (Új API-kulcs)** gombra. Válassz felhasználót a kulcs tulajdonosaként, és engedélyezd azokat a műveleteket, amelyeket a kulcs végezhet – ügyelj rá, hogy az **Add Contacts (Kontaktok hozzáadása)** be legyen jelölve. Adj nevet a kulcsnak, majd kattints a **Save (Mentés)** gombra. 4. Az API Keys oldalon másold ki annak a bejegyzésnek az **APP ID** és **API KEY** értékét, amelyiket használni szeretnéd. Hagyd nyitva ezt a lapot – mindkét értéket beilleszted majd az OptiMonkba. --- ## 2. lépés – Hozd létre a címkéidet (opcionális, de most érdemes) Az OptiMonk varázslója azokat a címkéket kínálja fel, amelyek már léteznek az Ontraportban, ezért hozd létre őket, mielőtt belekezdenél. Az Ontraportban nyisd meg a bal oldali menü **Contacts (Kontaktok)** szakaszából a **Settings (Beállítások)** menüpontot, és kattints a **Manage Tags (Címkék kezelése)** gombra. Itt látod az összes címkédet; újat a **New Tag (Új címke)** gombbal hozhatsz létre. Ha azt is szeretnéd, hogy az új feliratkozók egy drip sorozatba kerüljenek, gondoskodj róla, hogy az a sorozat is létezzen az Ontraportban. --- ## 3. lépés – Kösd össze az Ontraportot a kampányoddal 1. Nyisd meg a bal oldali menüben a **Kampányok** menüpontot, és kattints arra a kampányra, amelyet az Ontraporttal szeretnél összekötni. 2. Nyisd meg a kampány **Integrációk** fülét. 3. Kattints az **Integráció hozzáadása** gombra. Ha ez az első integrációd, ugyanez a lépés *Csatlakoztasd az e-mail- vagy SMS-eszközödet* néven jelenik meg. 4. **Szolgáltató** lépés: válaszd az **Ontraportot**. Ha hosszú a lista, írj a *Szolgáltatók keresése…* mezőbe. A már csatlakoztatott fiókok a lista tetején, a *Csatlakoztatott fiókjaid* alatt jelennek meg – válassz ezek közül, ha nem akarod újra megadni a hitelesítő adatokat. 5. **Fiók** lépés: kattints az **Új fiók csatlakoztatása** gombra, majd illeszd be az 1. lépésben megszerzett két értéket. Az űrlap meg is mondja, honnan valók: *Jelentkezz be az Ontraport fiókodba, és kattints az Administration menüpontra a lap jobb felső sarkában lévő legördülő menüben. A következő oldalon, az Integrations szakaszban, az ONTRAPORT API INSTRUCTIONS AND KEY MANAGER pontnál adhatod hozzá az új API-kulcsot és ID-t.* A kapcsolatnak nevet is adhatsz a **Név (opcionális)** mezőben, hogy később könnyen felismerd – hasznos, ha több Ontraport fiókot kötsz be. Kattints a **Csatlakoztatás** gombra. Ha a hitelesítő adatok hibásak, a varázsló mentés helyett ezt írja ki: *Sikertelen kapcsolódás — ellenőrizd a hitelesítő adatokat*. 6. **Beállítások** lépés: itt tér el az Ontraport egy egyszerű levelezőlista-eszköztől. Lista helyett két választómezőt kapsz, és mindkettő magától betölti az Ontraport fiókodból az opciókat – nincs frissítés gomb, amit meg kellene nyomnod. - **Címke** – az a címke, amelyet ebből a kampányból minden feliratkozó megkap. Kötelező. - **Sorozat (opcionális)** – az a drip sorozat, amelyre az új feliratkozók felkerülnek. Hagyd üresen, ha nem használsz ilyet. Kattints a **Tovább** gombra. 7. **Mezők összerendelése** lépés: döntsd el, hogy az egyes popupmezők hova kerüljenek az Ontraportban (lásd lentebb), majd kattints az **Integráció mentése** gombra. Ezzel készen is vagy. Innentől mindenki, aki a popupodon keresztül feliratkozik, bekerül az Ontraport kontaktjaid közé a kiválasztott címkével – és ha beállítottál sorozatot, arra is felkerül. > **Piszkozat vagy élő:** ha a kampány még nincs publikálva, az integrációnál **Piszkozat** címke jelenik meg, alatta ezzel a megjegyzéssel: *Piszkozatként mentve — a kampány publikálásakor lép élesbe.* Publikált kampányon azonnal érvénybe lép, és **Aktív** állapotot mutat. --- ## Mezők összerendelése Az összerendelési táblázatnak két oszlopa van: bal oldalon a **Popup mező** (a popupod minden beviteli mezője), jobb oldalon az **Ontraport mező**. Az OptiMonk előre kitölti az összerendelést a saját javaslataival, így a legtöbb esetben csak ellenőrizned kell. - Az **e-mail** mező rögzített – mindig az Ontraport e-mail mezőjéhez rendelődik. - Válaszd a **Ne szinkronizáld** lehetőséget minden olyan popupmezőnél, amelyet nem szeretnél elküldeni. - A **Statikus mezők** alatt minden beküldéssel elküldhetsz egy fix értéket is – például egy kampánynevet egy Ontraport tulajdonságba. Kattints a **Statikus mező hozzáadása** gombra, írd be bal oldalra az értéket, jobb oldalon pedig válaszd ki az Ontraport mezőt. Ha olyan adatot szeretnél továbbítani, amely még nincs a listában, azt a popupnak előbb be kell gyűjtenie: kérd meg az asszisztenst a design chatben, hogy adja hozzá a mezőt (például *„adj hozzá egy telefonszám mezőt”*), várd meg, amíg a popup újraépül, majd térj vissza az **Integrációk → Összerendelés szerkesztése** pontra, és rendeld hozzá az új sort. --- ## Az integráció módosítása vagy eltávolítása Az Integrációk fül a kampányon lévő összes integrációt felsorolja, a hozzájuk tartozó címkével (és sorozattal) együtt. - A **Lista módosítása** újra megnyitja a varázslót, így másik címkét vagy sorozatot választhatsz, vagy újra elvégezheted az összerendelést. - Az **Eltávolítás** leveszi az integrációt erről a kampányról: *Eltávolítod erről a kampányról? A fiókkapcsolat megmarad, és bármikor újra hozzáadható.* Az Ontraport hitelesítő adataid nem törlődnek, így egy másik kampányon is felhasználhatod őket. --- ## Ellenőrizd, hogy a leadek tényleg megérkeznek Nyisd meg a bal oldali menüben a **Leadek** menüpontot. Minden beküldésnek van egy **Szinkronizálási állapot** oszlopa: - **Szinkronizálva** – a kontakt eljutott az Ontraportba. - **Integrációs hiba** – a továbbítás nem sikerült. Kattints a sorra, hogy lásd az okát (*Hibás API-kulcs*, *Érvénytelen lista*, *Mezőösszerendelési hiba*, *Fiókhiba*, *A feliratkozó már létezik*…), majd a beállítások javítása után nyomd meg az **Újrapróbálás** gombot. --- Ha további kérdésed van, vagy segítségre lenne szükséged, keress minket bizalommal :)