Sign inGet Started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

Kategorie

Każdy wysyłany e-mail ma kategorię określającą cel wysyłki, ustawianą polem category w POST /v1/email/messages. Przyjmuje jedną z dwóch wartości, marketing lub transactional, i ma jeden efekt: decyduje, które wpisy blokowania i preferencje rezygnacji z subskrypcji mogą zablokować wiadomość.
Rezygnacja z subskrypcji newslettera mówi coś o marketingu, a nic o resetowaniu haseł. Kategoria pozwala odróżnić te dwa cele.

Dwie kategorie

  • marketing: wiadomości, które odbiorca wybrał i z których może zrezygnować. Kampanie, newslettery, ogłoszenia produktowe, oferty promocyjne. Wszystko, gdzie "I don't want this anymore" jest odpowiedzią, którą musisz uszanować.
  • transactional: wiadomości wymagane przez działanie odbiorcy. Resetowanie haseł, weryfikacja adresu e-mail, kody jednorazowe, potwierdzenia zamówień, alerty bezpieczeństwa i konta. Muszą dotrzeć niezależnie od preferencji marketingowych odbiorcy.
Zadaj sobie pytanie, co się stanie, jeśli wiadomość nigdy nie dotrze. Jeśli przerwany zostanie proces, który odbiorca sam rozpoczął, to wiadomość transakcyjna. Jeśli to Ty zainicjowałeś rozmowę, to marketing.
Te dwie wartości to kompletny zbiór: żadne API nie tworzy ani nie konfiguruje kategorii, a pole jest walidowane względem tych wartości. Jeśli potrzebujesz dokładniejszej segmentacji, użyj tagów obok kategorii.

Jak kategoria steruje polityką blokowania

Zasada sprowadza się do jednego zdania: marketing jest blokowana przez każdy powód blokowania i każdą rezygnację, natomiast transactional przechodzi mimo blokady za skargę lub rezygnacji wyłącznie z marketingu. Twarde odbicia, ręczne blokady i rezygnacja zapisana dla wszystkich wiadomości blokują obie kategorie.
Ta asymetria wynika z tego, co oznacza każdy powód. Twarde odbicie oznacza, że adres nie istnieje, więc wysyłka jest bezcelowa niezależnie od kategorii. Ręczna blokada to decyzja Twojego zespołu, której nigdy nie podważamy. Skargi i rezygnacje z subskrypcji to preferencje dotyczące niechcianej poczty: zatrzymują Twoje wysyłki marketing, ale odbiorca, który zgłosił newsletter jako spam, nadal otrzyma reset hasła. Wyjątek też jest celowy: rezygnacja może być zapisana dla wszystkich wiadomości, a nie tylko marketingowych (opcja Wiadomości do zatrzymania w oknie Zapisz preferencję lub coverage: all w POST /v1/preferences), a to jest prośba odbiorcy o ciszę, więc blokuje również wiadomości transakcyjne.
Zablokowani odbiorcy są odrzucani w widocznym dla Ciebie miejscu, po jednym wierszu na odbiorcę z dołączonym powodem. Blokowanie zawiera tabelę powodów i opisuje, jak adresy trafiają na listę.

Wartość domyślna i dlaczego wysyłki transakcyjne muszą z niej zrezygnować

Pomiń category, a wysyłka będzie marketing. To błąd w bezpieczną stronę: wiadomość bez jawnej kategorii respektuje rezygnacje i skargi oraz zawiera link rezygnacji z subskrypcji, więc kampania jest zgodna z przepisami bez dodatkowej pracy.
Dwie ścieżki wysyłki pobierają kategorię z innego źródła. Wysyłka korzystająca z zapisanego szablonu, w której pominiesz category, przyjmuje klasyfikację szablonu, więc szablon utworzony jako transactional wysyła jako transakcyjny. Ustaw category na wysyłce, aby zaklasyfikować pojedynczą wiadomość inaczej, a wartość wysyłki wygrywa. Wiadomości przesłane przez SMTP pobierają kategorię z konfiguracji SMTP klucza API, która wynosi transactional dla klucza, którego nie skonfigurowałeś.
Dlatego poczta operacyjna musi z tego zrezygnować. Reset hasła wysłany bez kategorii jest traktowany jako marketing: zawiera link rezygnacji z subskrypcji, którego nie powinien mieć, a rezygnacja z newslettera blokuje go, mimo że odbiorca sam o niego poprosił. Ustaw category: "transactional" na potwierdzeniach, resetach, kodach weryfikacyjnych i alertach konta:
Przykład kodu
{
  "from": "no-reply@yourdomain.com",
  "to": ["delivered@messagebird.dev"],
  "subject": "Reset your password",
  "html": "<p>Click the link below to reset your password...</p>",
  "category": "transactional"
}

Kategorie jako wymiar analityczny

Kategoria zostaje przy wiadomości i pojawia się wszędzie tam, gdzie wiadomość jest widoczna, więc dzieli statystyki doręczeń, odbić i zaangażowania na ruch marketingowy i operacyjny bez konieczności tagowania każdej wysyłki. Lista wiadomości filtruje po kategorii, statystyki API rozbijają metryki według niej, a dziennik e-mail w dashboardzie oferuje ten sam filtr.

Następne kroki

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikGetting started with emailPoznaj możliwościEmailPodążaj ścieżką naukiBuild your first integrationPrzewodnik wdrożeniowySend your first email
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy