Broadcasty
Broadcast wysyła jeden e-mail do całej grupy odbiorców: newsletter, ogłoszenie lub dowolną pojedynczą treść kierowaną do wielu adresatów naraz. Lista odbiorców jest tworzona z członków grupy w momencie rozpoczęcia wysyłki, więc broadcast trafia do każdego, kto jest członkiem grupy w tej chwili.
Twórz wysyłki masowe w Email > Broadcasts w dashboardzie, przez broadcasts API, za pomocą bird email broadcasts lub przez serwer MCP. SDK dla TypeScript, Python, Go i PHP udostępniają zasób broadcasts obejmujący cały cykl życia: utwórz wersję roboczą, zmień ją, dopóki jest jeszcze szkicem, wyślij natychmiast lub w późniejszym terminie, wyświetl listę wysyłek masowych w obszarze roboczym, odczytaj jedną wraz z jej licznikami, anuluj zaplanowaną lub trwającą, usuń tę, która jest jeszcze szkicem, a także odczytaj jej odbiorców, zdarzenia, kliknięte linki, limit wysyłek, z którego wysyłka korzysta, oraz liczebności odbiorców, które wysyłka rozwiązuje. Aby wysłać jednorazową listę odbiorców, użyj wysyłki zbiorczej lub wysyłek pojedynczych.
Tworzenie wersji roboczej
Zacznij od listy Broadcasts i kliknij New broadcast. Kompozytor to jedna strona: pasek z odbiorcami i nadawcą u góry, treść e-maila poniżej, a na końcu kontrolka ustawień kategorii, śledzenia i tagów. Nie ma osobnego kroku zapisu. Każda zmiana jest automatycznie zapisywana, gdy broadcast ma ustawionych odbiorców i nadawcę, więc szkic powstaje natychmiast po wybraniu tych dwóch elementów, a wysłanie go później to oddzielna, jawna akcja.
Użyj pola To, żeby wybrać odbiorców, albo wybierz New, żeby utworzyć ich bez wychodzenia z kompozytora.
Otwórz kontrolkę ustawień w nagłówku kompozytora, żeby zobaczyć trzy dodatkowe opcje:
- Przełączniki śledzenia otwarć i kliknięć.
- Do 20 tagów, każdy złożony z nazwy i wartości, pozwalających później filtrować ten broadcast.
- Kategoria, domyślnie ustawiona na
marketing.
Adres nadawcy
Broadcast jest wysyłany z adresu w zweryfikowanej domenie wysyłkowej. Połącz część lokalną z jedną ze swoich zweryfikowanych domen i dodaj nazwę wyświetlaną, jeśli chcesz. Dodaj adres Reply-To, jeśli odpowiedzi mają trafiać gdzie indziej. Wybranie Review ostrzeże cię, jeśli domena nie jest zweryfikowana.
Szablon
Broadcast wskazuje na jeden z szablonów e-mail w twoim obszarze roboczym, a szablon zawiera temat i treść, które broadcast wysyła. Właściwości kontaktu każdego odbiorcy wypełniają zmienne szablonu w momencie wysyłki, więc jeden broadcast personalizuje treść dla każdego odbiorcy. Broadcast może wypełniać tylko właściwości kontaktu, więc zmienna szablonu odwołująca się do czegokolwiek innego jest odrzucana przy wysyłce, a błąd wskazuje tę zmienną.
Wpisz treść bezpośrednio w polu edycji poniżej tematu albo wybierz Choose a template, żeby zacząć od istniejącego szablonu. Ta opcja jest dostępna tylko gdy broadcast jest pusty, ponieważ wybranie szablonu po wpisaniu tematu lub treści nadpisałoby je. Broadcast wysyła opublikowaną wersję szablonu, więc szablon, który ma tylko szkic, nie może być podstawą wysyłki.
Szablon z więcej niż jednym językiem wysyła jeden z nich do całej grupy odbiorców. Podaj go jako template.language podczas tworzenia lub aktualizacji kampanii, a pomiń, aby wysłać domyślny język szablonu. Zmiana samego języka nie zmienia wersji, do której kampania jest przypisana, jeśli już takową ma. Kampania zostaje przypisana do wersji w momencie przygotowania do wysyłki, więc zaplanowana kampania wysyła wersję opublikowaną w tym momencie, niezależnie od tego, czy wcześniej zmienisz jej język.
Wyślij lub zaplanuj
Wkrótce: Opisane poniżej oczekiwanie na środki i opcje wznowienia nie są jeszcze dostępne. Obecnie broadcast, któremu zabraknie środków, kończy się błędem quota_exceeded. Użyj Get a broadcast, aby sprawdzić failure_detail, i dodaj środki, jeśli wskazuje niewystarczające saldo. Doładowanie nie uruchamia ponownie nieudanego broadcastu; przed utworzeniem kolejnej wysyłki sprawdź, do których odbiorców nie wysłano wiadomości. Wiadomość przyjęta do dostarczenia, ale wciąż odroczona, jest już wysłana; wyklucz tego odbiorcę z nowego broadcastu.
Wysyłka to oddzielna, jawna czynność, dostępna z poziomu przycisku Review w edytorze lub ze strony szczegółów kampanii przez Send or reschedule. Każda z tych opcji otwiera okno dialogowe, które sprawdza, czy kampania jest kompletna, ostrzega o elementach mogących spowodować niepowodzenie wysyłki, a następnie pozwala wybrać Send now lub wskazać czas do roku w przód. Zaplanowana kampania pozostaje edytowalna i można ją przeplanować aż do momentu faktycznego rozpoczęcia wysyłki.
Przy wysyłce sprawdzane jest, czy w grupie odbiorców nadal jest ktoś, do kogo można dotrzeć. Grupa, w której nikt nie ma adresu e-mail lub w której każdy adres jest objęty suppresją, zostaje odrzucona w tym momencie, zamiast kończyć się niepowodzeniem później.
Przy wysyłce sprawdzane są dwa limity na poziomie organizacji.
Pierwszy to liczba broadcastów, które możesz wysłać w okresie rozliczeniowym, jeśli Twój plan określa taką liczbę. Zapisane szkice nie wliczają się do niej, a anulowanie broadcastu nie zwraca wykorzystanego limitu. Gdy go wyczerpiesz, poczekaj na kolejny okres rozliczeniowy albo przejdź na plan z wyższym limitem.
Drugi ogranicza równoczesne kampanie. Jeśli wybierzesz Send now, gdy limit jest osiągnięty, żądanie zostaje odrzucone. Zaplanowana kampania czeka na wolne miejsce.
Przed wysyłką sprawdź w oknie Send szacowany koszt dla odbiorców, którzy mogą otrzymać broadcast, oraz ewentualne ostrzeżenie o limicie. Członkowie z dostępem do rozliczeń widzą też saldo portfela i to, czy automatyczne doładowanie jest włączone. Koszt obejmuje podatek, jeśli cena jest dostępna; ceny i zużycie mogą się zmienić przed wysyłką. Jeśli Twój plan nie ma szacunku dla broadcastów, okno informuje o tym zamiast pokazywać zerowy koszt. Limit jest szacunkiem wspólnym z innymi wysyłkami e-mail. Zaplanowanie broadcastu nie rezerwuje jego salda, a inny broadcast może wykorzystać środki, zanim ten się zakończy.
Jeśli automatyczne doładowanie jest włączone, Twoje obecne ustawienia mogą obciążyć zapisaną metodę płatności więcej niż raz w trakcie wysyłki kampanii. Rozpoczęcie kampanii nie zwiększa kwoty doładowania ani nie autoryzuje osobnej płatności za całą grupę odbiorców.
Jeśli saldo się wyczerpie, broadcast wyświetla Waiting for funds przez maksymalnie 20 minut, niezależnie od tego, czy automatyczne doładowanie jest włączone. Raz na minutę sprawdza dostępność środków. Dodanie środków ręcznie lub przez automatyczne doładowanie może ponownie uruchomić wysyłanie w tym czasie. Doładowanie, po którym konto nadal jest zablokowane z powodu niewystarczających środków, nie uruchamia wysyłania. Częściowe doładowania nie przedłużają bieżącego okresu oczekiwania. Po wznowieniu wysyłania kolejna przerwa rozpoczyna nowy okres oczekiwania wynoszący 20 minut.
Jeśli oczekiwanie skończy się, zanim wysyłka będzie mogła być kontynuowana, kampania przechodzi w stan Paused, a kontakty rozliczeniowe Twojej organizacji otrzymują e-mail. Sprawdź saldo i w razie potrzeby dodaj środki. Oczekujące kampanie zachowują swoje miejsce na równoczesną wysyłkę; wstrzymane kampanie je zwalniają.
Otwórz kampanię i wybierz Resume broadcast. Sprawdź, czy jej daty, oferty i terminy są nadal aktualne: pozostali odbiorcy otrzymają wiadomość później, niż planowano.
W oknie Resume broadcast rozwiń Preview email, aby sprawdzić zapisany szablon obszaru roboczego. Podgląd wymaga email_management:read; jeśli nie masz tego uprawnienia, poproś o sprawdzenie uprawnioną osobę z zespołu. Wbudowane szablony i brakująca zapisana treść nie są tutaj dostępne do podglądu. Jeśli podgląd jest niedostępny, wykonaj opisane poniżej czynności sprawdzania szablonu i pozostaw kampanię wstrzymaną, dopóki nie możesz zweryfikować, co otrzymają pozostali odbiorcy. Podgląd jest opcjonalny i nie blokuje wznowienia.
W przypadku kampanii rozpoczętej co najmniej 24 godziny temu potwierdzenie podaje jej wiek w godzinach i ostrzega o opóźnionym dostarczeniu. Dodanie środków nie wznawia automatycznie wstrzymanej kampanii.
Aby przed wznowieniem przez API sprawdzić wiadomość, pobierz kampanię i odczytaj jej odwołania started_at oraz przypiętą template. Pobierz szablon, używając template.id; scope: system oznacza szablon wbudowany. Jeśli odczyt szablonu zwraca 404, spróbuj pobrać jego przypiętą wersję po ID, ponieważ opublikowane wersje szablonów obszaru roboczego można odczytać także po usunięciu szablonu. W przypadku szablonu obszaru roboczego pobierz tę wersję szablonu, podając template.id jako template_ref i template.version_id jako version_id. Sprawdź temat i treść w template.language albo w default_language tej wersji, jeśli nie wybrano języka. Odczyt tej treści wymaga email_management:read; jeśli nie masz tego uprawnienia, poproś o sprawdzenie uprawnioną osobę z zespołu. Odczyt szablonów wbudowanych pokazuje bieżącą treść katalogu. Kampanie z zamrożoną treścią ją zachowują, ale starsze kampanie mogą po wznowieniu ponownie odczytać katalog. Ani bieżący odczyt, ani wcześniejsza wiadomość same w sobie nie dowodzą, co otrzymają pozostali odbiorcy. Pozostaw kampanię wstrzymaną, chyba że możesz zweryfikować tę treść.
Wznowienie przez API i SDK wymagają confirm: true dla tak starej kampanii. W CLI najpierw sprawdź kampanię, a potem przekaż --yes do bird email broadcasts resume, aby potwierdzić opóźnione dostarczenie. CLI bez tej flagi zwraca ostrzeżenie i nie pyta interaktywnie. Narzędzie wznawiania MCP również używa confirm: true; poproś osobę zlecającą wysyłkę o potwierdzenie, że wiadomość jest nadal aktualna.
Wywołania programowe mogą zawsze przekazać confirm: true, także przed upływem 24 godzin, jeśli aplikacja już zdecydowała o kontynuowaniu dostarczania. Nie pomija to sprawdzania salda, limitu wysyłki, uprawnień ani limitu równoczesnych kampanii.
Wybór Brand jest dostępny w wersji zapoznawczej. Kampania zachowuje wybrany brand_id, gdy czeka na środki, jest wstrzymana lub zostaje wznowiona. Preferencje zgód dla jej Brand oraz zabezpieczenia całego obszaru roboczego nadal obowiązują. Brand nie można zarchiwizować, dopóki kampania się nie zakończy lub jej anulowanie nie zostanie ukończone.
Wznowienie zachowuje zapisane odwołania do szablonu i listę odbiorców. Odbiorcy, do których wiadomość została już wysłana, nie otrzymają jej ponownie. Aktualne suppresje i preferencje zgody obowiązują zgodnie z kategorią kampanii: rezygnacja z wiadomości marketingowych nie blokuje kampanii transakcyjnych. Wznowienie nie zużywa kolejnej kampanii z miesięcznego limitu. Konto nie może już być zablokowane z powodu niewystarczających środków, limit wysyłki musi pokrywać następną partię i musi być dostępne miejsce na równoczesną wysyłkę. Jeśli dzienny lub miesięczny limit wysyłki nadal blokuje partię, wznowienie zwraca 429, a kampania pozostaje wstrzymana. Spróbuj ponownie wznowić tę samą kampanię po zresetowaniu limitu lub jego zmianie. Obecnie zawieszony obszar roboczy zwraca 403 z E08024. Po ponownej aktywacji kampania zatwierdzona przed zawieszeniem nadal nie może zostać wznowiona: API zwraca 403 z E04102. Anuluj taką kampanię zamiast ponawiać próbę. Nie wysyłaj ponownie do całej grupy odbiorców bez wykluczenia odbiorców, do których już wysłano wiadomość. Wznowienie nie rezerwuje środków ani nie gwarantuje wysłania wszystkich pozostałych wiadomości. Jeśli po jawnym wznowieniu zabraknie środków, rozpocznie się nowy okres oczekiwania wynoszący 20 minut. Zamiast tego możesz anulować kampanię, jeśli jej wiadomość nie jest już przydatna.
Znajdź kampanię
Przeszukuj listę po tagu lub nazwie szablonu albo filtruj ją po statusie, grupie odbiorców lub zakresie dat. Zakres dat filtruje po dacie utworzenia każdej kampanii, a nie po dacie wysyłki, więc kampania zaplanowana w zeszłym tygodniu na wysyłkę za miesiąc nadal pojawia się w "Last 7 days."
Wyeksportuj bieżący widok jako CSV przyciskiem nad tabelą lub wywołaj Eksportuj kampanie jako CSV, który przyjmuje te same filtry. Powyżej 50 000 wierszy eksport jest odrzucany zamiast cicho obcinany. Zawęź filtry i spróbuj ponownie.
Status kampanii
Wkrótce: Opisane poniżej statusy waiting_for_funds i paused nie są jeszcze dostępne. Obecnie broadcast, któremu zabraknie środków, kończy się niepowodzeniem i nie zostaje wznowiony po doładowaniu.
Etap kampanii jest widoczny w filtrze Status:
| Etap | Gdzie jest kampania | Wartości status |
|---|---|---|
| Szkic | Zapisana bez zatwierdzenia do wysyłki | draft |
| Zaplanowana | Zatwierdzona z przyszłym czasem wysyłki, wciąż edytowalna | scheduled |
| Wysyłanie | W trakcie wysyłki, oczekiwania na środki lub anulowania | accepted, sending, waiting_for_funds, canceling |
| Wstrzymana | Zatrzymana z powodu braku środków, czeka na wznowienie przez Ciebie | paused |
| Zakończona | Zakończona: wysłana, anulowana lub nieudana | sent, canceled, failed |
Znacznik w każdym wierszu pokazuje dokładny status w ramach danego etapu. Tę samą wartość zwraca pole status w API.
Anuluj lub usuń
Anuluj zaplanowaną, wysyłaną, oczekującą lub wstrzymaną kampanię z jej strony szczegółów, za pomocą bird email broadcasts cancel lub przez Anuluj kampanię i metodę broadcasts.cancel SDK. Odbiorcy, do których kampania jeszcze nie dotarła, zostają pominięci, a wiadomości już w drodze nie da się cofnąć. Usuwanie działa wyłącznie na szkicach i jest nieodwracalne, przez te same trzy ścieżki: stronę szczegółów, bird email broadcasts delete lub Usuń kampanię.
Gdy kampania się nie powiedzie
Dashboard wyjaśnia przyczynę niepowodzenia i wskazuje, co sprawdzić dalej. W przypadku quota_exceeded pokazuje zapisany powód oraz wskazówki dotyczące limitów wysyłki i środków. Możesz też użyć Get a broadcast i odczytać failure_reason oraz failure_detail.
Konfiguracja wysyłki kampanii jest sprawdzana dopiero w momencie rozpoczęcia wysyłki. Jeśli domena nadawcza była zweryfikowana przy planowaniu, ale utraciła weryfikację przed wysyłką, kampania nie powiedzie się w tym momencie. Zweryfikuj domenę i wyślij kampanię ponownie.
failure_reason | Co się stało | Co zrobić |
|---|---|---|
content_invalid | Nie udało się przygotować broadcastu do wysyłki. Przyczyną częściej jest konfiguracja niż treść: niezweryfikowana domena wysyłkowa, brakujący lub nieopublikowany szablon, szablon z pętlą lub niedostępna pula IP | Napraw to, co wskazuje failure_detail, i wyślij ponownie |
empty_audience | Grupa odbiorców nie ma członków lub suppresje wykluczają wszystkich członków | Dodaj członków lub sprawdź suppresje |
audience_unavailable | Grupa odbiorców już nie istnieje | Przypisz kampanię do innej grupy odbiorców |
quota_exceeded | Wysyłka osiągnęła dzienny lub miesięczny limit e-maili, pułap nadwyżki, inny limit wysyłki lub zabrakło środków na saldzie | Sprawdź limit wysyłki i saldo. Na podstawie szczegółów API ustal, czy zarejestrowano brak środków na saldzie; w razie potrzeby dodaj środki albo poczekaj na reset limitu, zawęź grupę odbiorców lub przejrzyj plan |
insufficient_funds | Saldo obszaru roboczego nie pokryło kosztów wysyłki | Doładuj portfel |
internal_error | Coś poszło nie tak po naszej stronie | Spróbuj ponownie i zgłoś ticket do wsparcia, jeśli problem się powtarza |
workspace_suspended | Obszar roboczy został zawieszony, więc kampania przestała wysyłać wiadomości. Odbiorcy, do których jeszcze nie dotarła, nie otrzymają wiadomości, nawet po ponownej aktywacji obszaru roboczego | Skontaktuj się z pomocą techniczną w sprawie ponownej aktywacji obszaru roboczego. Karta Recipients pokazuje, do kogo dotarła wiadomość |
Kampanie i pojedyncze wysyłki korzystają ze wspólnego limitu e-maili organizacji. Dodanie środków nie uruchamia ponownie nieudanej kampanii. Przed utworzeniem kolejnej kampanii sprawdź, do których odbiorców nie wysłano wiadomości. Wyklucz odbiorców, których wiadomości zostały przyjęte do dostarczenia, w tym wiadomości wciąż odraczane przez serwer odbiorcy. Oczekiwanie i wstrzymanie będą dostępne wkrótce. Twarde limity wysyłki i ograniczenia płatności nadal obowiązują. Plany i cennik opisuje, co zawiera każdy plan.
Śledź dostarczanie
Po rozpoczęciu wysyłki karta Overview kampanii pokazuje liczbę odbiorców i wysłanych wiadomości, a następnie wskaźniki dostarczenia, otwarć, kliknięć, odrzuceń i skarg wraz z ich licznikami. Karta Recipients wymienia każdego odbiorcę wraz ze statusem dostarczenia, powodem niedostarczenia, czasem dostarczenia oraz otwarciami i kliknięciami. Pole wyszukiwania wymaga pełnego, poprawnego adresu e-mail; częściowy adres lub sama domena nie przechodzą walidacji, oznaczają pole jako nieprawidłowe i pozostawiają tabelę w dotychczasowym stanie. Przycisk nad tabelą eksportuje kartę jako CSV, a Eksportuj odbiorców kampanii jako CSV zwraca ten sam plik do klucza API; w obu przypadkach limit to 500 000 wierszy z takim samym zachowaniem odrzucania zamiast obcinania jak w eksporcie listy kampanii. Karta Events to surowy strumień zdarzeń kampanii, korzystający z typów zdarzeń opisanych w sekcji zdarzenia i webhooki.
Przetestuj kampanię
Umieść adres sandbox w grupie odbiorców, a wysyłka do tego kontaktu zostanie zasymulowana zamiast rzeczywiście zrealizowana: delivered@messagebird.dev zgłasza dostarczenie, bounce@messagebird.dev odrzucenie, a każdy z nich generuje te same zdarzenia i webhooki, co prawdziwy odbiorca. W ten sposób testujesz kampanię i handler odczytujący jej zdarzenia bez wysyłania wiadomości do kogokolwiek. Grupa odbiorców może łączyć kontakty sandbox i rzeczywiste; każdy kontakt otrzymuje własny wynik. Symulowany odbiorca nadal wlicza się do Twojego limitu wysyłki, więc test obejmuje ten sam limit co rzeczywista wysyłka.
Następne kroki
- Grupy odbiorców: listy odbiorców, do których kampania wysyła wiadomości
- Szablony e-mail: temat i treść, na które wskazuje kampania
- Metryki e-mail: widok na poziomie obszaru roboczego, do którego trafiają dane z kampanii
bird email broadcasts: jedno polecenie CLI na operację kampanii- Utwórz kampanię: dokumentacja API z pełnymi schematami żądań i odpowiedzi oraz przykładem kodu na każdy SDK
- Wysyłki e-mail: jedna wiadomość do całej Twojej grupy odbiorców: film pokazujący wysyłkę kampanii i odczyt jej wyników
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.