Tablice Lookup to sposób, w jaki możesz przechowywać dane, których następnie możesz używać w Szablonach, Przepływach i Podróżach. Utwórz swoje tablice Lookup za pomocą panelu, a następnie dynamicznie odwołuj się do danych w tych tabelach.
Tablice Lookup w Bird przechowują i centralizują odniesienia danych, które mogą być wyszukiwane podczas tworzenia szablonów e-mailowych z użyciem języka szablonów Liquid w HTML.
Na przykład, flagi każdego kraju, skróty lub waluta mogą być przechowywane i aktualizowane centralnie jako tabela wyszukiwania. Za każdym razem, gdy jest używana do budowy e-maila, może być odwoływana z tej tabeli wyszukiwania.
Ważne ograniczenia:
Każda tabela może mieć do 10 oddzielnych pozycji danych przechowywanych w niej.
Każdy element może zawierać do około 300kB danych.
Utwórz tabelę wyszukiwania
Użyj tabeli wyszukiwania w szablonie e-mail
Aby użyć tabeli wyszukiwania w szablonie wiadomości e-mail, możesz dodać następującą składnię liquid do swojego szablonu HTML lub do elementu HTML używanego w kreatorze przeciągnij i upuść:
Tutaj,
variable_name to dowolna nazwa, którą możesz zdefiniować
lookup-table-slug to slug, który nadałeś podczas tworzenia tabeli wyszukiwania
item-name to nazwa elementu, który utworzyłeś
object-value to wartość, którą nadałeś elementowi JSON
key_name to nazwa klucza w parze klucz-wartość zdefiniowanej w elemencie wartości
Na przykład,
Aby renderować lokalną walutę określonego kraju, możemy użyć poniższej składni
variable_name tutaj jest zdefiniowane jako waluta (dowolna nazwa, którą użytkownik może zdefiniować)
lookup-table-slug tutaj to country-flags zdefiniowane podczas tworzenia tabeli wyszukiwania
item-name to country utworzone wcześniej i pokazane w lewym panelu
object-value to AD, co jest wartością zdefiniowaną w JSON. Zwróć uwagę, że to może być również zmienna
key_name to local_currency, która jest zdefiniowana w JSON
Gdy jest używana w kreatorze szablonów e-mailowych w bloku HTML, powyższa składnia wygeneruje wartość local_currency przechowywaną pod AD w obiekcie podmiotowym w tabeli wyszukiwania country-flags
Możesz przełączyć się na sekcję podglądu, aby zobaczyć wartość wyjściową wyświetlaną dynamicznie w szablonie e-maila. Poniżej pokazuje EUR jako wartość pobraną z tabeli wyszukiwania.
Używanie tabel wyszukiwania w przepływach
Możesz przeglądać tabele wyszukiwania w Przepływach, aby ponownie używać centralnie zdefiniowanych danych.
Aby użyć tabeli wyszukiwania, najpierw stwórz ją zgodnie z opisem powyżej.
Przejdź do Przepływy > Przepływy
Utwórz początkowy przepływ, używając dowolnego rodzaju wyzwalacza.
Dodaj nowy Wykonaj wyszukiwanie krok do swojego przepływu. Kliknij na Dodaj nowe działanie i wybierz je z grupy Tabele wyszukiwania lub wyszukaj je, korzystając z możliwości wyszukiwania po prawej stronie:
Zostanie wyświetlony ekran konfiguracji, na którym możesz wybrać tabelę do odczytu i skonfigurować sposób, w jaki chcesz przeprowadzić to wyszukiwanie:
Zobaczysz trzy komponenty, które możesz skonfigurować:
Slug tabeli wyszukiwania wskazuje, którą tabelę chcesz przeglądać. Klikając w to pole, Przepływy pokażą dostępne tabele wyszukiwania:
Wyszukiwanie pozwala określić, co pobrać, a Ty możesz użyć różnych dostępnych zmiennych do skonstruowania tego klucza wyszukiwania. Domyślnie operacja zwraca wartość, na którą wskazuje twój wskaźnik, jako wartość na poziomie głównym, ale jeśli chcesz utworzyć obiekt danych — możesz użyć możliwości Jako, aby wczytać go do określonej właściwości:
Zamień pozwala zastąpić zmienne w zwracanych wynikach wyszukiwania albo statyczną wartością, albo wartością zdefiniowaną gdzieś w twojej tabeli wyszukiwania. Następujący przykład zastąpi tekst
{{ MyVariableName }}w dowolnym elemencie zwróconym przez działanie wyszukiwania wartością, którą znajdzie pod kluczemreplacements.<locale>.MyVariableName:
Klikając przycisk Test, możesz zobaczyć wynikowe dane:
Konfiguracja, z której tabeli odczytać, jest wymagana i musisz dodać przynajmniej jedno Wyszukiwanie działanie. Nie musisz dodawać żadnych działań Zamień.
