Jak dodać niestandardowy kanał internetowy w wiadomości e-mail?

Czego się dowiesz

Dowiedz się, jak dodać i używać niestandardowego kanału internetowego w wiadomości e-mail. Niestandardowy kanał internetowy umożliwia dynamiczne wypełnianie kanału danych z zewnętrznego adresu URL w wiadomości e-mail Klaviyo. Przed wysłaniem wiadomości e-mail Klaviyo wysyła żądanie HTTP do adresu URL i pobiera dane. Zawartość kanału internetowego jest następnie dostępna do wykorzystania w Twojej wiadomości e-mail.

Potęga kanałów internetowych polega na tym, że pozwalają one na korzystanie z jednego szablonu i dynamiczne pobieranie treści, przy czym wystarczy, że będziesz aktualizować kanał, a Klaviyo zapewni, że świeża zawartość z Twojego kanału zostanie wypełniona w każdej wysyłce.

W tym artykule omówimy dodawanie i korzystanie z niestandardowego kanału internetowego w kampaniach i sekwencji.

Kilka słów na początek

Pierwszym krokiem do dodania dynamicznej treści zewnętrznej do dowolnej wiadomości e-mail w Klaviyo jest utworzenie źródła feedu. Twój kanał musi: 

• Bądź hostowany pod dostępnym adresem URL w formacie JSON lub XML.
• Rozmiar 3,3 MB lub mniejszy
• Nie używaj przekierowującego adresu URL 

Klaviyo wykona żądanie HTTP do podanego przez Ciebie adresu URL i pobierze dane Twojego kanału. Ze względu na to, że sekwencja e-mail wysyła się w sposób ciągły, Klaviyo będzie aktualizować zawartość Twojego kanału poprzez okresowe odpytywanie adresu URL kanału w celu pobrania odświeżonej zawartości zgodnie z jednym z poniższych harmonogramów: 

• 15-minutowe odświeżyć
  Klaviyo będzie próbować odświeżyć Twój kanał co 15 minut. Aby to osiągnąć, twój kanał musi załadować się w ciągu pięciu sekund i zwrócić pomyślną odpowiedź.

• Odświeżyć w nocy
  Jeśli powrót Twojego kanału trwa dłużej niż pięć sekund, po trzech godzinach prób zaczniemy próbować aktualizować Twój kanał co noc. W przypadku trwającego nocnego odświeżyć, twój kanał musi załadować się w mniej niż 30 sekund. 

Jeśli nie będziemy w stanie załadować Twojego kanału w ciągu 30 sekund przez trzy noce z rzędu, nie będziesz mógł korzystać z tego kanału w swoich wiadomościach e-mail. sekwencja e-mail polegająca na tym kanale przestanie być wysyłana, a kampania i sekwencja e-mail nie będą wysyłane, dopóki kanał nie zostanie usunięty lub nie zostanie rozwiązany problem z Twoim kanałem.

Gdy otrzymamy odpowiedź z błędem, nie będziemy w stanie uzyskać dostępu do zawartości Twojego kanału. Będziemy postępować zgodnie z powyższym schematem i ponawiać próby przez maksymalnie trzy dni. W międzyczasie wiadomości e-mail nie będą wysyłane.

Jeśli będziemy mieli problemy z dostępem do Twojego kanału internetowego, otrzymasz powiadomienia w aplikacji i e-mail. Łatwym krokiem w rozwiązywaniu problemów jest dwukrotne sprawdzenie wymagań żywieniowych i upewnienie się, że odpowiadają one parametrom opisanym powyżej. 

Jeśli dokonasz zmian w kanale - na przykład zmniejszysz rozmiar, aby przyspieszyć czas przesyłania lub naprawisz błąd powodujący reakcję na błąd - i chcesz, aby Klaviyo podjął próbę nowego odświeżenia, przejdź do kanału w zakładce Dane Kanały i kliknij przycisk Aktualizacja Dane Kanał. Przetestujemy i ponownie zweryfikujemy Twój kanał. Jeśli Twój kanał jest prawidłowy i zwróci odpowiedź w odpowiednim czasie, wznowimy próby aktualizowania Twoich treści. Jest to dobry krok do rozwiązania, jeśli masz problemy z dostępem do kanału internetowego, nawet jeśli nie wprowadziłeś żadnych zmian.

Filtry Django

Pomagamy używać filtrów Django dla zmiennych, które wstawiasz. Poniżej znajduje się kilka często używanych filtrów, a więcej informacji znajdziesz w naszym przewodniku na temat używania filtrów do dostosowywania zmiennych oraz w Glosariuszu filtrów zmiennych.

Ogranicz podsumowanie postu do X liczby słów

Jeśli chcesz zamieścić krótkie podsumowanie wpisu na blogu pod jego tytułem (a Twój kanał udostępnia tekst podsumowania), możesz użyć filtra Obetnij.

Na przykład, aby ograniczyć podsumowanie artykułu do 250 znaków, możesz użyć:

{{ item.summary|truncatechars:250 }}

Dodaj niestandardowy kanał internetowy

Skonfiguruj swój kanał

1. Kliknij nazwę swojej firmy w lewym dolnym rogu strony Klaviyo.
2. Kliknij Ustawienia.
3. Kliknij przycisk Inne.
   
4. Kliknij opcję Kanały internetowe.
5. Kliknij Dodaj kanał internetowy.
   
6. Wypełnij pola kanału internetowego w następujący sposób:
   • Nazwa kanału
     Później użyjesz tego identyfikatora w szablonie, aby uzyskać dostęp do zawartości kanału. Nadaj swojemu kanałowi krótką, opisową nazwę. Zalecamy nazywanie kanałów wielbłądzimi literami (np. "MyDataFeed") lub wielkimi literami ze spacjami zastąpionymi podkreślnikami (np. "MY_DATA_FEED"). Spacje nie są dozwolone w nazwach kanałów. 
   • Adres URL kanału
     Punkt końcowy Klaviyo używany do pobierania zawartości kanału (tj. adresu URL skonfigurowanego wcześniej kanału JSON lub XML). Jeśli Twój kanał zawiera prywatne informacje, zdecydowanie zalecamy korzystanie z adresu URL HTTPS i dołączenie parametru nonce zapytania w celu zabezpieczenia Twojego kanału.
   • Metoda żądania
     Określ metodę HTTP, która będzie używana do żądania kanału. Jeśli nie masz pewności, którą opcję wybrać, wybierz GET. 
   • Typ zawartości
     Format kanału (JSON lub XML). Jeśli to możliwe, zalecamy korzystanie z JSON. W przypadku kanałów XML kanał zostanie przekonwertowany na JSON.
7. Po wypełnieniu wszystkich pól kliknij przycisk Dodaj kanał internetowy. Podejmiemy próbę sprawdzenia adresu URL kanału i zweryfikujemy, czy działa on prawidłowo. Jeśli napotkamy błąd, zobaczysz komunikat o błędzie i nie będziesz mógł zapisać nowego kanału, dopóki problem nie zostanie rozwiązany.
   • Chcesz to wypróbować, ale nie masz własnego adresu URL kanału internetowego? Skorzystaj z naszego. Skopiuj poniższy adres URL dla Centrum Pomocy Klaviyo do pola Feed URL i wypróbuj go na własnym koncie Klaviyo:

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. Klaviyo weryfikuje Twój kanał i pokazuje wszelkie potencjalne błędy. Po zatwierdzeniu zobaczysz swój kanał w Klaviyo i będzie on gotowy do użycia w wiadomościach e-mail.
   

Wyświetl podgląd swojego kanału

Przydatne jest wyświetlenie podglądu kanału internetowego przed dodaniem go do wiadomości e-mail. Aby wyświetlić podgląd kanału:

1. Na stronie kanałów internetowych znajdź swój kanał. 
2. Kliknij trzy kropki, a następnie wybierz Edytuj. 
   
3. Na stronie szczegółów kanału kliknij przycisk Podgląd. 

Podczas podglądu kanału zobaczysz jego zawartość lub komunikat o błędzie, jeśli nie możemy załadować kanału. 

Jeśli twój kanał jest tablicą JSON, automatycznie przeanalizujemy i wyświetlimy każdy wiersz osobno. Jeśli jest to coś innego, najprawdopodobniej słownik JSON, pokażemy cały słownik.

Jeśli aktywnie rozwijasz swój kanał, użyj przycisku odświeżyć, aby pobrać najnowszą wersję swojego kanału. Strona podglądu kanału pokazuje cały kanał. Jeśli Twój kanał jest duży, wyświetlenie jego zawartości może zająć kilka sekund. Pamiętaj, że jeśli zapytanie o kanał trwa ponad 30 sekund, wpłynie to na wydajność wszystkich wiadomości e-mail opartych na tym kanale.

Po dodaniu kanału internetowego i wyświetleniu podglądu jego zawartości możesz użyć go w wiadomości e-mail.

Użyj kanału internetowego w wiadomości e-mail

W przypadku kampanie, Klaviyo będzie pobierać każdy kanał raz na wysłanie i sklep zwróconą zawartość. Nawet jeśli wysyłasz do tysięcy odbiorców, Klaviyo nie wykona tysięcy żądań do twoich serwerów.

Wypełnij zawartość kanału w szablonie

W naszym przykładowym kanale internetowym z poprzedniej sekcji mamy tablicę artykułów, w której każdy wpis zawiera nazwę, adres URL, identyfikator artykułu i inne informacje. Po dodaniu kanału do wiadomości e-mail jest on dostępny za pośrednictwem zmiennej kanałów:

{{ feeds }}

Na przykład, dla powyższego kanału JSON, możemy teraz odwoływać się lub wyświetlać zawartość kanału artykułów, włączając tę składnię do naszego szablonu:

{{ feeds.Klaviyo_Help_Center }}

Przeanalizujmy przykład, w którym iterujemy po wszystkich wpisach w tablicy, wyświetlając określone zmienne. Jako przykładu użyjemy kanału Klaviyo Blog i będziemy iterować po Images.

1. Przeciągnij nowy blok tekstowy do wiadomości e-mail i umieść go w miejscu, w którym ma być wyświetlany kanał internetowy.
2. Włącz funkcję Repeat blok/Content Repeat: kliknij w zakładkę Display Options bloku tekstowego, a następnie kliknij Create Repeat Rules.
3. W polu Repeat For wstaw feeds.YOUR_FEED_NAME, a następnie nazwę zmiennej (zmiennych) zawierającej tablicę, którą chcesz iterować.
   • W naszym przykładzie, ponieważ iterujemy również po wartości "articles", powtórzymy dla: feeds.Klaviyo_Help_Center.articles.
4. Twoje dane mogą być zagnieżdżone w szeregu zmiennych. Na przykład, twój kanał może mieć następującą strukturę: 

   rss: {
   ..... 
    kanał: { 
   ..... 
    item: { 
   .....}}}

   W tym przypadku użyjesz feeds.YOUR_FEED_NAME.rss.kanał.item jako Powtórzenie dla.

5. Jeśli chcesz, aby ten blok iterował tylko po określonej liczbie wpisów, użyj filtra "slice". Aby użyć tego filtra, dostosuj wartość Repeat For, dodając filtr na końcu:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   W tym przykładzie, |slice:':3' spowoduje wyświetlenie tylko trzech pierwszych wpisów. 
6. W polu Alias pozycji wstaw: pozycja
7. Po skonfigurowaniu funkcji Repeat blok/Content Repeat możesz wstawiać zmienne za pomocą aliasu "item".
8. Aby zidentyfikować i dodać zmienne, otwórz podgląd swojego kanału internetowego i odnieś się do sposobu, w jaki dane są skonstruowane. Wszelkie dane zagnieżdżone w tablicy używanej w polu Repeat for mogą być używane jako zmienne.
   W tym przykładzie wszystkie dane wyświetlane w tablicy artykułów są dostępne do wykorzystania w wiadomości e-mail:
   
9. W przypadku danych pierwszego poziomu po prostu dodaj element przed nazwą zmiennej pokazaną w danych. Na przykład użyj {{ item.title }} aby wyświetlić tytuł artykułu, lub {{ item.url }} aby wyświetlić adres URL artykułu. 
10. Aby uzyskać dostęp do danych zagnieżdżonych w zmiennych pierwszego poziomu, użyj notacji kropkowej (np, {{ item.images.thumbnail_url }}). Aby dowiedzieć się więcej o notacji kropek i znaczniku szablonu, przejdź do naszego przewodnika po znaczniku szablonu i składni zmiennych. 
11. Po wyświetleniu podglądu szablonu zauważysz, że funkcja Repeat blok/Content Repeat pozwoli temu prostemu blokowi tekstowemu na automatyczną iterację wszystkich wpisów w Twoim feedzie. Tylko zmienne określone przez Ciebie w bloku tekstowym będą wyświetlane dla każdego wpisu.
12. Jeśli wstawiasz obraz, pamiętaj, że musisz edytować pole kodu źródłowego bloku tekstowego i umieścić obraz w polu <img src> znacznik.
    

Dodałeś niestandardowy kanał internetowy do swojej poczty e-mail i możesz teraz dynamicznie wypełniać kanał danych z zewnętrznego adresu URL. 

Przetestuj lub zweryfikuj swój kanał

Jeśli otrzymasz wiadomość e-mail lub powiadomienie w aplikacji, że mamy problemy z dostępem do Twojego kanału internetowego:

1. Przejdź do swojego kanału i kliknij przycisk aktualizacji kanału.
2. Po zakończeniu walidacji możesz zobaczyć dwa rodzaje komunikatów o błędach:
   • Nieprawidłowa odpowiedź
     Jeśli otrzymamy odpowiedź o błędzie podczas próby wyszukania zawartości Twojego kanału, poinformujemy Cię o kodzie statusu błędu. Musisz rozwiązać problem powodujący ten błąd, zanim kanał będzie mógł być pomyślnie użyty w jakiejkolwiek wiadomości e-mail.
   • Problem z wydajnością
     Jeśli nie otrzymamy odpowiedzi z Twojego kanału w ciągu 30 sekund, spowoduje to opóźnienia w wysyłaniu. Mimo że w przeszłości mogłeś zapisać swój kanał, aby zmniejszyć ryzyko opóźnień w wysyłaniu, musisz rozwiązać problem z wydajnością kanału przed jego ponowną walidacją i pomyślnym zapisaniem.

W obu przypadkach, jeśli korzystasz z problematycznego kanału w ramach wysyłania, spowoduje to opóźnienia w wysyłaniu lub wiadomość e-mail może zostać całkowicie anulowana. Jeśli chodzi o sekwencję, prawdopodobnie nie wysyłasz również wiadomości e-mail.

Zalecamy usunięcie problematycznego kanału ze wszystkich wiadomości e-mail podczas rozwiązywania wszelkich zaległych problemów, aby zapobiec zakłóceniom w wysyłaniu.

Dodatkowe źródła

• Rozwiąż problemy z kanałem internetowym Instagrama w wiadomościach e-mail
• Jak używać feed produktowy i rekomendacje