Importálás / Exportálás

Tudd meg, hogyan importálhatsz feliratkozókat tömegesen fájlokból vagy API-n keresztül, és hogyan exportálhatod a feliratkozói adataidat külső felhasználásra.

Feliratkozók importálása

Adj hozzá feliratkozókat a hírlevéledhez tömegesen CSV fájlokkal, egyéni bevitelekkel vagy az API-n keresztül.

Tölts fel egy CSV vagy TXT fájlt több feliratkozó egyszerre történő importálásához.

Fájl követelmények:

  • Kötelező mezők: email*, name* (a csillag jelöli a kötelezőt)
  • Egyéni mezők: Bármilyen további mező, amelyet a feliratkozóidhoz hoztál létre
  • Formátum: Vesszővel elválasztott értékek, soronként egy feliratkozó

Sablon példák:

Basic Template
email*,name*,custom_field1,custom_field2
[email protected]*,John Doe*,Value1,Value2
[email protected]*,Jane Smith*,Value3,Value4
Advanced Template
email*,firstname*,lastname*,custom_field1,custom_field2
[email protected]*,John*,Doe*,Value1,Value2
[email protected]*,Jane*,Smith*,Value3,Value4

A kötelező oszlopok csillaggal (*) vannak jelölve. A rendszer automatikusan felismeri és kombinálja a névvel kapcsolatos oszlopokat (name, firstname, lastname) egyetlen teljes név mezővé.

Importálási lehetőségek:

  • Hozzáadás csoportokhoz: Válassz meglévő csoportokat az importált feliratkozók hozzáadásához
  • Hitelesítő e-mail küldése: Megerősítő e-mailek küldése az új feliratkozóknak
Automatikusan töröljük a duplikált e-mail címeket és kiszűrjük az érvénytelen e-maileket. A duplikátumok kezelése automatikus - a meglévő feliratkozók frissítésre kerülnek, nem duplikálódnak. Győződj meg róla, hogy az adataid tartalmazzák a megfelelő engedélyt ezen feliratkozók e-mailezéséhez.
Amikor hitelesítő e-mailek kerülnek kiküldésre, a feliratkozók "ÚJ" állapotban maradnak és nem kapnak hírlevél e-maileket, amíg nem kattintanak a hitelesítő linkre az e-mailjükben.
name
string
A feliratkozó teljes neve. Opcionális - ha nincs megadva, az e-mail felhasználónév részt használja.
verification_id
string
Egy hitelesítő e-mail variáns azonosítója. Megadása esetén hitelesítő e-mailt küld és a kontakt állapotát "NEW"-ra állítja. Opcionális - elhagyása esetén a kontakt automatikusan hitelesítettként lesz jelölve.
state
string
Kontakt állapot. Érvényes értékek: "VERIFIED", "UNVERIFIED", "REMOVED". Csak "VERIFIED"-re állítható, ha a kontakt jelenleg "REMOVED". Opcionális - alapértelmezett a hitelesítési beállítások alapján.
fields
object
Egyéni mező adatok kulcs-érték párokként. Az értékek a meglévő mezőkkel összefésülésre kerülnek (nem lecserélésre). A mezőtípusok automatikusan konvertálódnak (dátumok, számok). Opcionális.
group_add
string[]
Csoport azonosítók tömbje, amelyekhez a kontaktot hozzá kell adni. A csoportoknak léteznie kell és a szervezetedhez kell tartozniuk. Opcionális.
group_remove
string[]
Csoport azonosítók tömbje, amelyekből a kontaktot el kell távolítani. A csoportoknak léteznie kell és a szervezetedhez kell tartozniuk. Opcionális.

Kódpélda magyarázat:

  • URL: https://yaplet.com/api/newsletter/contacts/bulk-upsert - A teljes API végpont URL
  • Fejlécek:
    • Content-Type: application/json - JSON payload-hoz szükséges
    • Y-API-Key: your_api_key_here - Cseréld ki a tényleges API kulcsodra a vezérlőpultról
  • Kérés törzs: Egy contacts tömböt tartalmaz feliratkozó objektumokkal
  • Helyettesítők cseréje:
    • your_api_key_here → A tényleges API kulcsod
    • [email protected] → A feliratkozó e-mailje
    • verification_variant_id → Azonosító a hitelesítő e-mail variánsaidból (ha hitelesítő e-maileket küldesz)
    • group_id_1, group_id_2 → Tényleges csoport azonosítók a szervezetedből
    • custom_field_1, custom_field_2 → Az egyéni mező tag neveid
    • value_1, value_2 → Az egyéni mezők tényleges értékei

API megjegyzések:

  • Csak az email mező kötelező minden kontakthoz, minden más opcionális
  • verification_id nélkül a feliratkozók automatikusan hitelesített állapotba kerülnek
  • verification_id megadásával a kontaktok "NEW" állapotban maradnak, amíg a hitelesítő e-mailre nem kattintanak
  • Az állapotváltozások a jelenlegi kontakt állapot alapján korlátozottak
  • A fields objektumból hiányzó értékek nem kerülnek frissítésre/beszúrásra
  • A csoport azonosítóknak a szervezetedhez kell tartozniuk, különben a művelet sikertelen lesz

Feliratkozók exportálása

Töltsd le a feliratkozói adataidat CSV fájlként külső felhasználásra vagy biztonsági mentésre.

Exportálási lehetőségek

Összes exportálása

Hely: Jobb felső "Összes exportálása" gomb
Hatókör: A szervezeted összes feliratkozójának letöltése
Felhasználási eset: Teljes feliratkozói biztonsági mentés vagy migráció

Szűrt exportálás

Hely: Jobb felső "Szűrt exportálás" gomb (csak szűrők alkalmazásával) Hatókör: Az aktuális szűrőknek megfelelő összes feliratkozó
Felhasználási eset: Specifikus szegmensekből vagy csoportokból származó feliratkozók exportálása

Kijelöltek exportálása

Hely: Csoport műveletek menü → "CSV exportálás"
Hatókör: Csak a kijelölt feliratkozók az aktuális nézetből
Felhasználási eset: Szűrt vagy manuálisan kiválasztott feliratkozók exportálása

Exportálási viselkedés

Oszlop kiválasztás:

  • Csak a látható oszlopok kerülnek bele az exportba
  • Használd az oszlop láthatósági vezérlőket mezők megjelenítéséhez/elrejtéséhez exportálás előtt
  • Az alapmezők (E-mail, Név, Hozzáadva, Állapot) alapértelmezetten láthatók
  • Az egyéni mezők alapértelmezetten rejtettek, hacsak nem engedélyezed

Fájl formátum:

  • Formátum: Vesszővel elválasztott értékek (.csv)
  • Kódolás: UTF-8
  • Fejlécek: Oszlopnevek az első sorban
  • Adatok: Soronként egy feliratkozó
Exportálás előtt állítsd be az oszlop láthatósági beállításokat, hogy csak a szükséges adatmezőket tartalmazza a CSV fájlod.

Exportálási folyamat

Exportálási módszer kiválasztása

  • Kattints az "Összes exportálása" gombra a teljes feliratkozói listához
  • Vagy alkalmazz szűrőket, jelölj ki feliratkozókat, majd használd a "CSV exportálás" opciót a csoport műveletekből

Oszlopok konfigurálása

Használd az oszlop láthatósági vezérlőket a mezők megjelenítéséhez/elrejtéséhez az exportban

Exportálás megerősítése

Tekintsd át a megerősítő párbeszédablakot nagy exportálásoknál

Fájl letöltése

A CSV fájl automatikusan letöltődik az alapértelmezett letöltési mappádba :::

Nagy exportálások (10 000+ feliratkozó) feldolgozása több percet vehet igénybe. Értesítést kapsz, amikor az exportálás megkezdődik.

Tömeges műveletek és exportálás

Csoport műveletek használatakor exportáláshoz:

  • Összes kijelölése: Az aktuális szűrt nézetben lévő összes feliratkozó exportálása
  • Egyéni kijelölés: Csak a bejelölt feliratkozók exportálása (legfeljebb 10 000)
  • Szűrt eredmények: Az aktuális lekérdezésszerkesztő szűrőket alkalmazza az exportálásra
Az exportálás figyelembe veszi az összes aktív szűrőt, szegmenst és csoportkorlátozást. Csak az aktuális nézetedben látható feliratkozók kerülnek bele a CSV-be.