Smart Delivery daje Ci kontrolę nad tym, ile wiadomości otrzyma odbiorca i kiedy. Ustawisz, że kontakt, który dziś otrzymał newsletter, nie otrzyma jednocześnie automatyzacji – albo odwrotnie. Efekt: mniej przesyconych odbiorców, lepsza dostarczalność i czystsza baza danych.
Smart Delivery – inteligentna wysyłka
Spis treści:
1. Co umożliwia Smart Delivery
Funkcja składa się z dwóch niezależnych części. Możesz włączyć jedną, drugą lub obie naraz:
Priorytetowa kwarantanna – kontakt, który w ciągu ostatnich N godzin otrzymał dowolny e-mail (w wybranym zakresie), tym razem e-maila nie otrzyma.
Limit częstotliwości – kontakt, który w ciągu ostatnich N dni otrzymał X lub więcej e-maili, tym razem e-maila nie otrzyma.
Odbiorcy, którzy nie otrzymają e-maila z powodu Smart Delivery, nie giną bezpowrotnie – w logu kampanii lub automatyzacji zobaczysz ich oznaczonych jako skip.
⚠️ Dostępność: Smart Delivery jest obecnie dostępne dla kampanii masowych i automatyzacji. Obsługa SMS jest w planach.
2. Priorytetowa kwarantanna
Kwarantanna działa w oknie czasowym 0–24 godziny wstecz. Przed wysłaniem każdej wiadomości system sprawdza, czy odbiorca nie otrzymał e-maila w ustawionym oknie i zakresie. Jeśli tak, wiadomość zostanie pominięta.
Jak ustawić zakres (scope):
Zakres | Wartość scope | Co obejmuje | Typowe zastosowanie |
„Uwzględnij wszystko" | all | Kampanie i automatyzacje | Maksymalna ochrona |
Tylko kampanie | campaigns | Tylko kampanie masowe | Nie wpływa na automatyzacje |
Wszystkie automatyzacje | pipelines_all | Dowolna automatyzacja | Newslettery przechodzą swobodnie |
Inne automatyzacje (tylko AUTM) | pipelines_other | Pozostałe automatyzacje | Chroni bieżący scenariusz |
2.1 Kiedy czego użyć – praktyczne przykłady
Uwzględnij wszystko (all)
Odbiorca dziś dostał newsletter o zniżkach Black Friday. Jednocześnie tego samego dnia ma go zaadresować automatyzacja porzuconego koszyka. Przy ustawieniu „Uwzględnij wszystko" automatyzacja poczeka lub e-mail zostanie pominięty. Przydatne, gdy najważniejsze jest niepresycanie odbiorcy.
Tylko kampanie (campaigns)
Chcesz, aby automatyzacje (onboarding, koszyk) działały bez zakłóceń, ale newslettery brały pod uwagę siebie nawzajem. Jeśli odbiorca dostał ręcznie wysłaną kampanię, nowa kampania go pominie. Automatyzacje nie są w ten sposób ograniczane.
Wszystkie automatyzacje (pipelines_all)
Masz dwie równoległe automatyzacje (np. „Porzucony koszyk" i „Święto"). Nie chcesz, aby odbiorca dostał oba e-maile tego samego dnia. Przy tym ustawieniu druga automatyzacja pominie e-mail. Newslettery przechodzą swobodnie.
Inne automatyzacje (pipelines_other) – zalecane dla automatyzacji
Masz serię onboardingową (Lekcja 1 → Lekcja 2 → Lekcja 3). Chcesz, aby lekcje wychodziły w dokładnej kolejności i w szybkim tempie, ale nie chcesz, aby wskoczyła w to inna automatyzacja („Dawno Cię nie widzieliśmy"). Ten scenariusz rozwiązuje właśnie pipelines_other.
💡 Wskazówka: Dla automatyzacji w większości przypadków najodpowiedniejszy jest zakres „inne automatyzacje" (pipelines_other). Chroni przebieg bieżącego scenariusza, a jednocześnie zostawia wolne pole newsletterom.
3. Limit częstotliwości
Limit częstotliwości pilnuje liczby e-maili w ciągu ostatnich 1–7 dni. Jeśli odbiorca w ustawionym czasie otrzymał taką samą lub większą liczbę e-maili niż wynosi Twój limit, wiadomości nie otrzyma.
Co ustawiasz:
Liczbę e-maili – od 1 do 50
Liczbę dni – od 1 do 7
Zakres – te same opcje co przy kwarantannie (all, campaigns, pipelines_all); dla automatyzacji dodatkowo pipelines_other
Przykład:
Ustawiasz: maks. 3 e-maile na 7 dni, zakres „wszystko". Odbiorca, który w tym tygodniu otrzymał już 3 e-maile (kampanie i automatyzacje razem), nie otrzyma nowej wiadomości. Odbiorca z 2 e-mailami – otrzyma.
4. Co dzieje się z pominiętymi odbiorcami
Odbiorca pominięty przez Smart Delivery nie traci niczego na stałe. Zależy to od tego, jak dany krok jest powiązany w automatyzacji:
Pominięcie bez oczekiwania (skip) – odpowiednie dla samodzielnych, zbywalnych wiadomości. Odbiorca przechodzi do kolejnego kroku automatyzacji i kontynuuje dalej. Analityka pozostaje czysta.
Poczekaj i spróbuj ponownie (wait & retry) – odpowiednie dla scenariuszy sekwencyjnych (seria onboardingowa). Jeśli pominięcie zaburzyłoby logikę, ustaw przed daną wiadomością oczekiwanie, po którym wysyłka zostanie ponowiona.
ℹ️ Uwaga: Ocena Smart Delivery odbywa się zawsze tuż przed samą wysyłką, a nie w momencie wejścia odbiorcy do automatyzacji. Nawet kampania zaplanowana z wyprzedzeniem jest oceniana dopiero w momencie wysyłki.
5. Jak skonfigurować Smart Delivery
W kampanii masowej
Otwórz ustawienia odbiorców podczas przygotowywania kampanii.
Znajdź sekcję Smart Delivery.
Priorytetowa kwarantanna: wpisz liczbę godzin (0–24) i wybierz zakres.
Limit częstotliwości: wpisz maksymalną liczbę e-maili, liczbę dni i zakres.
Zapisz ustawienia i wyślij kampanię w standardowy sposób.
W automatyzacji
Otwórz edycję akcji „Wyślij e-mail" w odpowiednim kroku automatyzacji.
Rozwiń sekcję Smart Delivery.
Priorytetowa kwarantanna: wpisz liczbę godzin i wybierz zakres (zalecamy pipelines_other).
Limit częstotliwości: wpisz limit e-maili, liczbę dni i zakres.
Zapisz akcję i aktywuj automatyzację.
💡 Wskazówka: Obie funkcje są niezależne. Możesz spokojnie włączyć tylko limit częstotliwości bez kwarantanny i odwrotnie.
6. Konfiguracja przez API
Smart Delivery wysyłasz jako obiekt smartDelivery (camelCase w AUTM) lub smart_delivery (snake_case w kampanii) w ramach standardowego wywołania zapisu kampanii lub akcji automatyzacji.
Kampania – POST /campaigns/{id}/edit
{ "recepient_lists": { "...": "wybór odbiorców" }, "smart_delivery": { "priority_window_hours": 24, "priority_scope": "all", "frequency_cap_email_count": 3, "frequency_cap_email_days": 7, "frequency_cap_email_scope": "campaigns" } }
Automatyzacja – POST lub PATCH /automation/{id}/add-action lub edit-action
{ "actionId": "abc1234567", "properties": { "template": 1, "smartDelivery": { "priorityWindowHours": 12, "priorityScope": "pipelines_other", "frequencyCapEmailCount": 5, "frequencyCapEmailDays": 7, "frequencyCapEmailScope": "pipelines_other" } } }
Opis parametrów
Parametr (camelCase) | Wartości / zakres | Opis |
priorityWindowHours | 0–24 | Długość okna kwarantanny w godzinach. 0 = kwarantanna wyłączona. |
priorityScope | patrz tabela scope | Zakres kwarantanny. |
frequencyCapEmailCount | 1–50 | Maks. dozwolona liczba e-maili. |
frequencyCapEmailDays | 1–7 | Długość okna dla limitu częstotliwości, w dniach. |
frequencyCapEmailScope | patrz tabela scope | Zakres limitu częstotliwości. |
Zasady walidacji:
Priorytetowa kwarantanna: włączona, jeśli wyślesz priorityWindowHours > 0. Jeśli wysyłasz to pole, musisz wysłać także priorityScope.
Limit częstotliwości: włączony, jeśli wyślesz wszystkie trzy pola (count, days, scope). Muszą przyjść wszystkie albo żadne – inaczej zwróci błąd 422.
Wyłączenie: nie wysyłaj danych parametrów w ogóle.
ℹ️ Uwaga: Endpoint PATCH /campaigns/{id} używa camelCase (smartDelivery), natomiast POST /campaigns/{id}/edit używa snake_case (smart_delivery). Automatyzacje zawsze camelCase.
7. Najczęstsze pytania
a) Jak poznam, kto otrzymał e-mail, a kto został pominięty?
W logu kampanii lub w historii automatyzacji znajdziesz odbiorców oznaczonych jako skip. Przy każdym wpisie podany jest powód pominięcia — priorytetowa kwarantanna lub limit częstotliwości.
b) Czy mogę mieć jednocześnie ustawioną kwarantannę i limit częstotliwości?
Tak. Obie funkcje są niezależne i mogą działać równolegle. Odbiorca zostaje pominięty, jeśli wychwyci go co najmniej jedna z nich.
c) Czy Smart Delivery działa też dla SMS?
Obecnie Smart Delivery działa wyłącznie dla e-maili. Obsługa SMS jest przygotowana na poziomie danych i zostanie udostępniona w kolejnym kroku.
d) Co jeśli mam serię onboardingową i nie chcę przerywać kolejności lekcji?
Ustaw zakres na pipelines_other. Dzięki temu zapewnisz, że inne automatyzacje nie przerwą odbiorcy w trakcie onboardingu, ale poszczególne lekcje serii (w tej samej automatyzacji) będą wychodzić normalnie.
e) Czy Smart Delivery ustawiam raz dla całej automatyzacji, czy osobno dla każdego kroku?
Ustawiasz go osobno dla każdej akcji „Wyślij e-mail". Dzięki temu w jednej automatyzacji możesz mieć różne priorytety — na przykład potwierdzenie transakcyjne bez ograniczeń i marketingowe wskazówki z limitem częstotliwości.
f) Co się stanie, jeśli wyślę priority_scope bez priority_window_hours?
Zwróci się błąd 422. Jeśli wysyłasz priorityWindowHours, musisz wysłać również priorityScope. Jeśli nie chcesz kwarantanny, nie wysyłaj żadnego z tych pól.
Podsumowanie: jakie ustawienie dla jakiego przypadku
Ustawienie | Priorytet wiadomości | Główny cel |
Uwzględnij wszystko | Niski | Maks. higiena bazy danych |
Wszystkie automatyzacje | Średni | Zapobieganie kolizji automatyzacji |
Inne automatyzacje | Wysoki (sekwencyjny) | Zachowanie przebiegu scenariusza |
Tylko kampanie | Średni | Nie zakłócać bieżącej promocji |
Nie ograniczaj | Krytyczny | Kluczowa informacja / transakcyjna |
❓
Jeśli masz pytania, napisz do nas na [email protected]