# OptiMonk kampányok integrálása a Marketóval

Canonical URL: https://support.optimonk.com/hu/articles/integrating-optimonk-campaigns-with-marketo

Integrálás [Marketo](http://www.marketo.com) Ha összekapcsolod az OptiMonkot a Marketóval, leadeket gyűjthetsz a popupjaiddal, és tovább dolgozhatsz velük a Marketóban — így mindenki, aki az OptiMonkon keresztül feliratkozik, megkapja a jövőbeli promócióidat és híreidet is.

> **Hol állítható be ez** A Marketo nem szerepel az új kampányszerkesztő szolgáltatólistájában, ezért a fiók összekapcsolása **egyszer, a klasszikus admin felületen történik**. Ezt követően a kapcsolat itt is elérhető lesz a kampányaidhoz, a *Csatlakoztatott fiókjaid*.

**Mielőtt elkezdenéd:** szükséged van egy kampányra, amelynek popupja már elkészült (a mezőleképezés a popup beviteli mezőiből olvasható ki), valamint egy Marketo fiókra REST API hozzáféréssel.

---

## 1. lépés — API hívások engedélyezése a Marketóban és az adatok összegyűjtése

Jelentkezz be a Marketo fiókodba egy másik lapon, és kövesd a [REST API gyorsindítási útmutatóját](http://developers.marketo.com/blog/quick-start-guide-for-marketo-rest-api/). Három értékre lesz szükséged belőle.

**Host URL (Gazdagép URL)** — kattints az **Admin** gombra, majd válaszd az **Integration → Web Services (Integráció → Webszolgáltatások)** menüpontot a bal oldali menüben, és másold ki a **HOST URL** -t a **REST API** mezőből.

*Fontos: távolítsd el a `/rest` részt az URL-ből — például `https://123-ABC-456.mktorest.com`.*

**Client ID és Client Secret (Kliensazonosító és Kliens titkos kulcs)** — válaszd az **Integration → LaunchPoint** lehetőséget. Megjelenik az általad létrehozott szolgáltatások listája; válaszd ki a létrehozott szolgáltatást, és kattints a **View details (Részletek megtekintése)** gombra, hogy megjelenjen a **Client ID** és a **Client Secret**.

---

## 2. lépés — A Marketo fiók összekapcsolása a klasszikus admin felületen

1. Az OptiMonkban kattints a neved a bal oldali menü alján, majd válaszd a **Vissza a klasszikus adminba** lehetőséget. Ugyanazzal a fiókkal leszel bejelentkezve ott is.

2. Nyisd meg a kampányt, amelyet használni szeretnél, és kattints a **Beállítások szerkesztése** gombra.

3. Kattints az **Új integráció hozzáadása** gombra az **Integráció hozzáadása**.

4. Válaszd a **Marketo** lehetőséget az elérhető integrációk listájából.

5. Illeszd be a **Host URL**-t, a **Client ID** -t és a **Client Secret** -et a megfelelő mezőkbe, majd mentsd el az integrációt.

*Opcionális:* hozzáadhatod az OptiMonkkal gyűjtött feliratkozókat egy adott Marketo listához. Ha nem választasz listát, a leadek egyszerűen az általános lead-adatbázisodba kerülnek, vagy egy általad a Marketóban beállított Smart Listbe.

---

## 3. lépés — A kapcsolat használata egy új appban épített kampányon

Amint a fiók összekapcsolásra került, az OptiMonk fiókodhoz tartozik — nem egy adott kampányhoz —, így hozzákapcsolhatod bármelyik itt épített kampányodhoz:

1. Nyisd meg a **Kampányok** menüpontot a bal oldali menüben, és kattints a kampányodra.

2. Nyisd meg az **Integrációk** fület, és kattints az **Integráció hozzáadása** gombra.

3. A **Szolgáltató** lépésben nézd meg a **Csatlakoztatott fiókjaid** részt — a Marketo-kapcsolatod ott lesz felsorolva. Kattints rá. (A Marketo nem szerepel az alábbi szolgáltatórácsban; az a rács csak azokat a szolgáltatókat tartalmazza, amelyeket innen tudsz csatlakoztatni.)

4. Válaszd ki a célt a Marketóban, majd kattints a **Tovább** gombra.

5. A **Mezők összerendelése** lépésben döntsd el, hogy melyik popup mező hova kerüljön (lásd alább), majd kattints az **Integráció mentése** gombra.

> **Vázlat vs. élő:** ha a kampányt még nem publikáltad, az integráció egy **Piszkozat** jelölést és a *Piszkozatként mentve — a kampány publikálásakor lép élesbe.* Egy publikált kampányon azonnal alkalmazásra kerül, és **Aktív**.

---

## Mezőleképezés

A leképezési táblázatnak két oszlopa van: **Popup mező** a bal oldalon (minden beviteli mező, amit a popupod összegyűjt), és **Marketo mező** a jobb oldalon — a mezőazonosítók a Marketo fiókodból. Az OptiMonk saját javaslataival előre kitölti a leképezést.

- Az **email** mező fix.

- Válaszd a **Ne szinkronizálja** lehetőséget minden olyan popup mezőnél, amit nem szeretnél elküldeni.

- Ha a Marketo nem ad vissza kiválasztható mezőlistát, a jobb oldal egy szövegmező: *Írd be a pontos Marketo mező- vagy tulajdonságnevet (pl. first_name). Hagyd üresen, ha ki akarsz hagyni egy mezőt.*

Ahhoz, hogy egy olyan adatot továbbíts, amely nincs a bal oldalon, a popupnak először összegyűjtenie kell azt: kérd meg az ügynököt a design chatben, hogy adja hozzá a mezőt, hagyd, hogy a popup újraépüljön, majd nyisd meg újra az **Integrációk → Leképezés szerkesztése**.

---

## Ellenőrizd, hogy a leadek valóban megérkeznek

Nyisd meg a **Közönség** menüpontot a bal oldali menüben. Minden beküldésnek van egy **Szinkron állapot** oszlopa: **Szinkronizálva** azt jelenti, hogy a lead megérkezett a Marketóba, **Integrációs hiba** azt jelenti, hogy a továbbítás sikertelen volt. Kattints a sorra az okért (*Hibás API kulcs*, *Érvénytelen lista*, *Mezőmegfeleltetési hiba*, *Fiók probléma*…), majd nyomd meg az **Újra próbálás** gombot, miután javítottad a beállításokat.