Přehled
Seznamy kontaktů
Seznamy kontaktů jsou seznamy, na které posíláte kampaně. Vytvářejte seznamy, spravujte odběratele, zjistěte limit odběratelů ve vašem tarifu a pracujte se seznamy přes API.
Seznam kontaktů je pojmenovaný seznam kontaktů, například „Newsletter“ nebo „Novinky v produktu“. Jako příjemce kampaně zvolíte jeden nebo více seznamů a lidi do seznamu můžete přidat ručně, importem, přes API, nebo přes hostovanou URL pro přihlášení.
Jak seznamy kontaktů fungují
Každá osoba v seznamu je odběratel: vazba mezi jedním kontaktem a seznamem s vlastním příznakem Subscribed. Stejný kontakt může být ve více seznamech a k některým být přihlášený a z jiných odhlášený.
- Kampaně se posílají odběratelům, kteří mají příznak Subscribed zapnutý, jejichž kontakt není globálně odhlášený a jejichž adresa není zablokovaná. Kontakt, který je ve více vybraných seznamech, dostane jednu kopii.
- Odhlášení příznak vypne, ale odběratele v seznamu ponechá, takže o historii nepřijdete. Viz Odhlášení.
- Smazání odběratele osobu ze seznamu odebere. Kontakt ve vašem workspace zůstane.
Stránka Audiences
Na stránce Email MarketingAudiences uvidíte své seznamy kontaktů s údaji Name, Subscribers a datem Created. Sloupec Subscribers ukazuje, kolik odběratelů má každý seznam v poměru k limitu vašeho tarifu, například 1.2k/10k. Nabídka řádku obsahuje volby Manage subscribers, Rename a Delete.
Nový seznam vytvoříte tak, že vyberete Create audience, do pole Name zadáte název a vyberete Create. Názvy musí být ve workspace jedinečné.
Stránka seznamu kontaktů
Po otevření seznamu můžete spravovat jeho odběratele. V záhlaví je počet odběratelů, označení s limitem a tyto akce:
| Akce | Co dělá |
|---|---|
| Rename | Změní název seznamu. |
| Subscribe URL | Zobrazí hostovanou URL pro přihlášení k tomuto seznamu a umožní ji obnovit. Viz URL pro přihlášení. |
| Add subscriber | Přidá osobu podle e-mailové adresy. Když je seznam v tarifu Pay as you go plný, nahradí ho tlačítko Upgrade. |
| Delete (v nabídce) | Smaže seznam i všechny jeho odběratele. Kontakty ve vašem workspace zůstanou. Tuto akci nelze vrátit zpět. |
Pod ním je tabulka odběratelů se sloupci Email, First name, Last name, Subscribed a Created, s vyhledáváním, filtry a nabídkou řádku s volbami Edit a Delete pro každého odběratele. Viz Správa odběratelů.
Limity
Každý tarif omezuje, kolik odběratelů může mít jeden seznam. Počet seznamů omezený není.
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Odběratelé na seznam | 10 000 | 50 000 | 250 000 | Neomezeně |
Do limitu se počítají všichni odběratelé v seznamu, včetně lidí, kteří se odhlásili. Místo uvolníte tak, že smažete odběratele, které už nepotřebujete, přejdete na vyšší tarif nebo požádáte o vyšší limit tlačítkem Request Increase v panelu Sending Limits na úvodní stránce webového rozhraní.
Když je seznam plný, tlačítko Add subscriber je neaktivní a každý způsob přidání lidí, včetně API, importů a URL pro přihlášení, se odmítne s kódem 422 a zprávou jako „Pro includes 50,000 subscribers per audience.“. Chyba z API obsahuje aktuální usage:
{
"error": "Pro includes 50,000 subscribers per audience.",
"usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}Práce s API
API seznamů kontaktů umožňuje seznamy vytvářet, načítat, přejmenovávat, vypisovat a mazat a API odběratelů spravuje lidi v nich. V URL můžete místo ID aud_ použít název seznamu. API potřebuje API klíč s oprávněním Full Access.
curl https://api.emailit.com/v2/audiences \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Newsletter" }'Odpovědi se seznamem kontaktů obsahují subscribers_count a objekt usage s poli used, limit a plan. Vytvoření, načtení a úprava seznamu navíc vrací jeho token, tajnou část jeho URL pro přihlášení. Duplicitní název vrací 409.
Události
Změny seznamů a odběratelů vyvolávají události, které můžete přijímat webhooky a které spouštějí automatizace:
| Událost | Kdy nastane |
|---|---|
audience.created, audience.updated, audience.deleted |
Seznam se vytvoří, přejmenuje nebo smaže. Smazání seznamu nevyvolá událost pro každého z jeho odběratelů. |
subscriber.created |
Někdo se do seznamu přidá ve webovém rozhraní, nebo přes API. Spouští automatizace Added to audience. |
subscriber.updated |
Změní se údaje odběratele, nebo jeho příznak Subscribed. |
subscriber.deleted |
Odběratel se odebere. Spouští automatizace Removed from audience. |
Importy a URL pro přihlášení události odběratelů nevyvolávají.