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:
email*,name*,custom_field1,custom_field2
[email protected]*,John Doe*,Value1,Value2
[email protected]*,Jane Smith*,Value3,Value4
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
Adj hozzá egyéni feliratkozókat közvetlenül a felületen keresztül.
Kötelező információ:
- E-mail cím: Érvényes e-mail formátum szükséges
- Név: A feliratkozó teljes neve
Opcionális mezők:
- Egyéni mezők: Bármilyen további adatmező, amelyet konfigurálátál
- Csoport tagság: A feliratkozó hozzáadása egy vagy több csoporthoz
- Hitelesítő e-mail: Megerősítő e-mail azonnali küldése
Folyamat:
- Töltsd ki az e-mailt és nevet (kötelező)
- Add hozzá az egyéni mező adatokat
- Válaszd ki a csoportokat, amelyekhez hozzá szeretnéd adni a feliratkozót
- Válaszd ki, hogy küldj-e hitelesítő e-mailt
- Kattints a "Feliratkozó hozzáadása" gombra
Importálj feliratkozókat programozottan a tömeges upsert API végponton keresztül.
Végpont: POST https://yaplet.com/api/newsletter/contacts/bulk-upsert
const response = await fetch("https://yaplet.com/api/newsletter/contacts/bulk-upsert", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Y-API-Key": "your_api_key_here"
},
body: JSON.stringify({
contacts: [
{
email: "[email protected]",
name: "John Doe",
verification_id: "verification_variant_id",
state: "VERIFIED",
fields: {
custom_field_1: "value_1",
custom_field_2: "value_2"
},
group_add: ["group_id_1", "group_id_2"],
group_remove: ["group_id_3"]
}
]
})
});
const result = await response.json();
curl -X POST "https://yaplet.com/api/newsletter/contacts/bulk-upsert" \\
-H "Content-Type: application/json" \\
-H "Y-API-Key: your_api_key_here" \\
-d '{
"contacts": [
{
"email": "[email protected]",
"name": "John Doe",
"verification_id": "verification_variant_id",
"state": "VERIFIED",
"fields": {
"custom_field_1": "value_1",
"custom_field_2": "value_2"
},
"group_add": ["group_id_1", "group_id_2"],
"group_remove": ["group_id_3"]
}
]
}'
<?php
$url = "https://yaplet.com/api/newsletter/contacts/bulk-upsert";
$apiKey = "your_api_key_here";
$data = [
"contacts" => [
[
"email" => "[email protected]",
"name" => "John Doe",
"verification_id" => "verification_variant_id",
"state" => "VERIFIED",
"fields" => [
"custom_field_1" => "value_1",
"custom_field_2" => "value_2"
],
"group_add" => ["group_id_1", "group_id_2"],
"group_remove" => ["group_id_3"]
]
]
];
$options = [
"http" => [
"header" => "Content-Type: application/json\r\nY-API-Key: $apiKey",
"method" => "POST",
"content" => json_encode($data)
]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);
import requests
import json
url = "https://yaplet.com/api/newsletter/contacts/bulk-upsert"
api_key = "your_api_key_here"
payload = {
"contacts": [
{
"email": "[email protected]",
"name": "John Doe",
"verification_id": "verification_variant_id",
"state": "VERIFIED",
"fields": {
"custom_field_1": "value_1",
"custom_field_2": "value_2"
},
"group_add": ["group_id_1", "group_id_2"],
"group_remove": ["group_id_3"]
}
]
}
headers = {
"Content-Type": "application/json",
"Y-API-Key": api_key
}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
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égesY-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
contactstömböt tartalmaz feliratkozó objektumokkal - Helyettesítők cseréje:
your_api_key_here→ A tényleges API kulcsod[email protected]→ A feliratkozó e-mailjeverification_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őlcustom_field_1,custom_field_2→ Az egyéni mező tag neveidvalue_1,value_2→ Az egyéni mezők tényleges értékei
API megjegyzések:
- Csak az
emailmező kötelező minden kontakthoz, minden más opcionális verification_idnélkül a feliratkozók automatikusan hitelesített állapotba kerülnekverification_idmegadá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
fieldsobjektumbó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á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 :::
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