Zasięg

Grow

Manage

Automate

Zasięg

Grow

Manage

Automate

G

G

M

M

Tabele wyszukiwania

Jak korzystać z tabel wyszukiwania

Przegląd

Przegląd

Przegląd

Tabele wyszukiwania są sposobem na przechowywanie danych, które można następnie wykorzystać w Szablonach, Przepływach i Podróżach. Twórz swoje Tabele wyszukiwania za pośrednictwem panelu sterowania, a następnie dynamicznie odwołuj się do danych w tych tabelach.

Tabele wyszukiwania w Bird przechowują i centralizują odniesienia do danych, które można wyszukać podczas tworzenia szablonów e-maili przy użyciu języka szablonowego Liquid w HTML.

Na przykład, flagi każdego kraju, skróty lub waluty mogą być przechowywane i aktualizowane centralnie jako tabela wyszukiwania. Za każdym razem, gdy jest używana do tworzenia e-maila, można się do niej odwołać z tej tabeli wyszukiwania.

Ważne ograniczenia:

  • Każda tabela może przechowywać do 10 oddzielnych elementów danych.

  • Każdy element może zawierać do około 300kB danych.

Utwórz Lookup Table

Przejdź do Zawartość > Tabele wyszukiwania i kliknij Utwórz.

  • Wpisz nazwę wyświetlania

  • Wpisz slug bez spacji



Slug jest używany do odniesienia się do tej tabeli i może zawierać tylko znaki alfanumeryczne. Zwróć uwagę, że ten slug jest używany w odniesieniu do szablonu e-maila.

  • Kliknij Zapisz



Tworzenie elementu w tabeli

Kliknij na tabelę, którą stworzyłeś

Z menu kontekstowego, które się pojawi, wybierz „Podgląd”



Każdy element w tabeli jest w zasadzie dokumentem JSON. Oznacza to, że możesz tworzyć strukturę drzewa kluczy i wartości, gdzie wartości mogą być tekstem, liczbami, wartościami boolean, tablicami lub samymi obiektami. Możesz bezpośrednio wprowadzić dokument JSON, używając składni JSON lub użyć edytora UI do skonstruowania dokumentu JSON.

Edytor JSON

  • Po zapisaniu zobaczysz edytor JSON. Możesz wybrać edytor tekstowy lub edytor UI w zależności od preferencji.

  • Zaktualizuj tabelę wyszukiwania, używając struktury JSON.

Dodawanie elementu

Aby dodać element w JSON do organizacji, kliknij +Dodaj element na lewym panelu.

  • Wpisz nazwę na górze

  • Kliknij przycisk Dodaj element

  • Po utworzeniu możesz zobaczyć utworzony element na lewym panelu.

Napisz JSON

Użyj formatu JSON, aby zdefiniować dowolną strukturę obiektu i pary klucz-wartość poniżej:

Na przykład, JSON, który podaje nazwę kraju i lokalną walutę na podstawie skrótu kraju

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Możesz także użyć edytora UI do zdefiniowania struktury JSON.


Przejdź do Zawartość > Tabele wyszukiwania i kliknij Utwórz.

  • Wpisz nazwę wyświetlania

  • Wpisz slug bez spacji



Slug jest używany do odniesienia się do tej tabeli i może zawierać tylko znaki alfanumeryczne. Zwróć uwagę, że ten slug jest używany w odniesieniu do szablonu e-maila.

  • Kliknij Zapisz



Tworzenie elementu w tabeli

Kliknij na tabelę, którą stworzyłeś

Z menu kontekstowego, które się pojawi, wybierz „Podgląd”



Każdy element w tabeli jest w zasadzie dokumentem JSON. Oznacza to, że możesz tworzyć strukturę drzewa kluczy i wartości, gdzie wartości mogą być tekstem, liczbami, wartościami boolean, tablicami lub samymi obiektami. Możesz bezpośrednio wprowadzić dokument JSON, używając składni JSON lub użyć edytora UI do skonstruowania dokumentu JSON.

Edytor JSON

  • Po zapisaniu zobaczysz edytor JSON. Możesz wybrać edytor tekstowy lub edytor UI w zależności od preferencji.

  • Zaktualizuj tabelę wyszukiwania, używając struktury JSON.

Dodawanie elementu

Aby dodać element w JSON do organizacji, kliknij +Dodaj element na lewym panelu.

  • Wpisz nazwę na górze

  • Kliknij przycisk Dodaj element

  • Po utworzeniu możesz zobaczyć utworzony element na lewym panelu.

Napisz JSON

Użyj formatu JSON, aby zdefiniować dowolną strukturę obiektu i pary klucz-wartość poniżej:

Na przykład, JSON, który podaje nazwę kraju i lokalną walutę na podstawie skrótu kraju

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Możesz także użyć edytora UI do zdefiniowania struktury JSON.


Przejdź do Zawartość > Tabele wyszukiwania i kliknij Utwórz.

  • Wpisz nazwę wyświetlania

  • Wpisz slug bez spacji



Slug jest używany do odniesienia się do tej tabeli i może zawierać tylko znaki alfanumeryczne. Zwróć uwagę, że ten slug jest używany w odniesieniu do szablonu e-maila.

  • Kliknij Zapisz



Tworzenie elementu w tabeli

Kliknij na tabelę, którą stworzyłeś

Z menu kontekstowego, które się pojawi, wybierz „Podgląd”



Każdy element w tabeli jest w zasadzie dokumentem JSON. Oznacza to, że możesz tworzyć strukturę drzewa kluczy i wartości, gdzie wartości mogą być tekstem, liczbami, wartościami boolean, tablicami lub samymi obiektami. Możesz bezpośrednio wprowadzić dokument JSON, używając składni JSON lub użyć edytora UI do skonstruowania dokumentu JSON.

Edytor JSON

  • Po zapisaniu zobaczysz edytor JSON. Możesz wybrać edytor tekstowy lub edytor UI w zależności od preferencji.

  • Zaktualizuj tabelę wyszukiwania, używając struktury JSON.

Dodawanie elementu

Aby dodać element w JSON do organizacji, kliknij +Dodaj element na lewym panelu.

  • Wpisz nazwę na górze

  • Kliknij przycisk Dodaj element

  • Po utworzeniu możesz zobaczyć utworzony element na lewym panelu.

Napisz JSON

Użyj formatu JSON, aby zdefiniować dowolną strukturę obiektu i pary klucz-wartość poniżej:

Na przykład, JSON, który podaje nazwę kraju i lokalną walutę na podstawie skrótu kraju

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Możesz także użyć edytora UI do zdefiniowania struktury JSON.


Użyj Tabeli Lookup w Szablonie Email


Aby użyć tabeli wyszukiwania w szablonie 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ść:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

Tutaj,

  • variable_name jest dowolną nazwą, którą możesz zdefiniować

  • lookup-table-slug to identyfikator nadany podczas tworzenia tabeli wyszukiwania

  • item-name to nazwa elementu, który stworzyłeś

  • object-value to wartość, którą nadałeś dla elementu JSON

  • key_name to nazwa klucza w parze klucz-wartość zdefiniowanej pod item-value

Na przykład,

Aby wyrenderować lokalną walutę zdefiniowanego kraju, możemy użyć poniższej składni

  • variable_name tutaj jest zdefiniowane jako currency (dowolna nazwa, którą użytkownik może zdefiniować)

  • lookup-table-slug tutaj to country-flags zgodnie z definicją podczas tworzenia tabeli wyszukiwania

  • item-name to country stworzony wcześniej i pokazany w lewym panelu

  • object-value to AD, które jest wartością zdefiniowaną w JSON. Zauważ, że to może także być zmienna

  • key_name to local_currency, które jest zdefiniowane w JSON

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

Kiedy używane w kreatorze szablonów e-mail w bloku HTML, powyższa składnia wyrenderuje wartość local_currency jak przechowywana pod obiektem AD pod elementem country w tabeli wyszukiwania country-flags

Możesz przełączyć się na sekcję podglądu, aby zobaczyć dynamicznie wyświetlaną wartość w szablonie e-mail. Poniżej pokazuje wartość EUR pobraną z tabeli wyszukiwania.

Używanie tabel wyszukiwania w Flows

Możesz odczytywać tabele wyszukiwania w Flows, aby ponownie użyć centralnie zdefiniowanych danych.

Aby użyć tabeli wyszukiwania, najpierw utwórz ją, jak opisano powyżej.

  1. Przejdź do Workflows > Flows

  2. Utwórz początkowy przepływ, używając wybranego przez siebie typu wyzwalacza.

Dodaj nowy krok Perform Lookup do swojego przepływu. Kliknij Add New Action i wybierz go z grupy Lookup Tables lub wyszukaj go za pomocą funkcji wyszukiwania po prawej stronie:



Zobaczysz ekran konfiguracji, na którym możesz wybrać tabelę do odczytu i skonfigurować, jak dokładnie chcesz wykonać to wyszukiwanie:



Zobaczysz trzy komponenty, które możesz skonfigurować:

  1. Lookup Table Slug wskazuje, którą tabelę chcesz przejrzeć. Klikając w to pole, Flows pokaże dostępne tabele wyszukiwania:

  1. Lookup pozwala określić, co odzyskać i możesz używać różnych dostępnych zmiennych do skonstruowania tego klucza wyszukiwania. Domyślną operacją jest zwrócenie wartości, do której odnosi się Twoje wyszukiwanie, jako wartości na poziomie głównym, ale jeśli chcesz stworzyć obiekt danych - możesz skorzystać z funkcji As, aby załadować go do konkretnej właściwości:

  1. Replace pozwala zastąpić zmienne w zwróconych wynikach wyszukiwania wartością statyczną lub wartością zdefiniowaną w tabeli wyszukiwania. Następujący przykład zastąpi tekst {{ MyVariableName }} w każdym elemencie zwróconym za pomocą akcji Lookup wartością, którą znajdzie pod kluczem replacements.<locale>.MyVariableName:

Po kliknięciu przycisku Test zobaczysz dane wynikowe:


Konfigurowanie, którą tabelę odczytać, jest wymagane i musisz dodać co najmniej jedną akcję Lookup. Nie musisz dodawać żadnych akcji Replace.


Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.

Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.

Połączmy Cię z ekspertem Bird.
Zobacz pełną moc Bird w 30 minut.

Przesyłając, zgadzasz się, że Bird może kontaktować się z Tobą w sprawie naszych produktów i usług.

Możesz zrezygnować z subskrypcji w dowolnym momencie. Zobacz Privacy Statement firmy Bird, aby uzyskać szczegóły dotyczące przetwarzania danych.

R

Reach

G

Grow

M

Manage

A

Automate

Company

Biuletyn

Bądź na bieżąco z Bird dzięki cotygodniowym aktualizacjom do Twojej skrzynki odbiorczej.