Erreichen

Grow

Manage

Automate

Erreichen

Grow

Manage

Automate

G

G

M

M

Lookup-Tabellen

Wie man Lookup-Tabellen verwendet

Übersicht

Übersicht

Übersicht

Die Lookup Tables sind eine Möglichkeit, Daten zu speichern, die Sie dann in Templates, Flows und Journeys verwenden können. Erstellen Sie Ihre Lookup Tables über das Dashboard und referenzieren Sie anschließend dynamisch Daten in diesen Tabellen.

Lookup Tables in Bird speichern und zentralisieren Datenreferenzen, die beim Erstellen von E-Mail-Vorlagen mithilfe der Liquid-Templating-Sprache in HTML nachgeschlagen werden können.

Zum Beispiel können die Flaggen aller Länder, Abkürzungen oder Währungen zentral als Lookup Table gespeichert und aktualisiert werden. Jedes Mal, wenn es beim Erstellen einer E-Mail verwendet wird, kann es aus diesem Lookup Table referenziert werden.

Wichtige Einschränkungen:

  • Jede Tabelle kann bis zu 10 separate Datenelemente enthalten.

  • Jedes Element kann bis zu etwa 300 kB Daten enthalten.

Erstellen Sie eine Lookup-Tabelle

Gehen Sie zu Inhalt > Nachschlagetabellen und klicken Sie auf Erstellen.

  • Geben Sie einen Anzeigenamen ein

  • Geben Sie ein Slug ohne Leerzeichen ein



Der Slug wird verwendet, um auf diese Tabelle zu verweisen und darf nur alphanumerische Zeichen enthalten. Beachten Sie, dass dieser Slug in der E-Mail-Vorlagenreferenzierung verwendet wird

  • Klicken Sie auf Speichern



Erstellen eines Elements in einer Tabelle

Klicken Sie auf die von Ihnen erstellte Tabelle

Wählen Sie im erscheinenden Kontextmenü „Anzeigen“



Jedes Element in einer Tabelle ist im Wesentlichen ein JSON-Dokument. Das bedeutet, dass Sie eine Baumstruktur von Schlüsseln und Werten aufbauen können, wobei die Werte selbst Text, Zahlen, Booleans, Arrays oder Objekte sein können. Sie können entweder ein JSON-Dokument direkt unter Verwendung der JSON-Syntax eingeben oder einen UI-Editor verwenden, um das JSON-Dokument zu erstellen.

JSON-Editor

  • Sobald Sie gespeichert haben, sehen Sie einen JSON-Editor. Sie können je nach Vorliebe entweder den Text- oder UI-Editor auswählen.

  • Aktualisieren Sie die Nachschlagetabelle mit einer JSON-Struktur.

Hinzufügen eines Elements

Um ein Element in einer JSON für die Organisation hinzuzufügen, klicken Sie im linken Bereich auf +Element hinzufügen.

  • Geben Sie oben einen Namen ein

  • Klicken Sie auf die Schaltfläche Element hinzufügen

  • Sobald erstellt, können Sie das erstellte Element im linken Bereich sehen.

Schreiben Sie das JSON

Verwenden Sie das JSON-Format, um die Struktur eines Objekts und Schlüssel-Wert-Paare unten zu definieren:

Zum Beispiel ein JSON, das den Ländernamen und die lokale Währung basierend auf der Länderkürzel angibt

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Sie können auch den UI-Editor verwenden, um die JSON-Struktur zu definieren.


Gehen Sie zu Inhalt > Nachschlagetabellen und klicken Sie auf Erstellen.

  • Geben Sie einen Anzeigenamen ein

  • Geben Sie ein Slug ohne Leerzeichen ein



Der Slug wird verwendet, um auf diese Tabelle zu verweisen und darf nur alphanumerische Zeichen enthalten. Beachten Sie, dass dieser Slug in der E-Mail-Vorlagenreferenzierung verwendet wird

  • Klicken Sie auf Speichern



Erstellen eines Elements in einer Tabelle

Klicken Sie auf die von Ihnen erstellte Tabelle

Wählen Sie im erscheinenden Kontextmenü „Anzeigen“



Jedes Element in einer Tabelle ist im Wesentlichen ein JSON-Dokument. Das bedeutet, dass Sie eine Baumstruktur von Schlüsseln und Werten aufbauen können, wobei die Werte selbst Text, Zahlen, Booleans, Arrays oder Objekte sein können. Sie können entweder ein JSON-Dokument direkt unter Verwendung der JSON-Syntax eingeben oder einen UI-Editor verwenden, um das JSON-Dokument zu erstellen.

JSON-Editor

  • Sobald Sie gespeichert haben, sehen Sie einen JSON-Editor. Sie können je nach Vorliebe entweder den Text- oder UI-Editor auswählen.

  • Aktualisieren Sie die Nachschlagetabelle mit einer JSON-Struktur.

Hinzufügen eines Elements

Um ein Element in einer JSON für die Organisation hinzuzufügen, klicken Sie im linken Bereich auf +Element hinzufügen.

  • Geben Sie oben einen Namen ein

  • Klicken Sie auf die Schaltfläche Element hinzufügen

  • Sobald erstellt, können Sie das erstellte Element im linken Bereich sehen.

Schreiben Sie das JSON

Verwenden Sie das JSON-Format, um die Struktur eines Objekts und Schlüssel-Wert-Paare unten zu definieren:

Zum Beispiel ein JSON, das den Ländernamen und die lokale Währung basierend auf der Länderkürzel angibt

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Sie können auch den UI-Editor verwenden, um die JSON-Struktur zu definieren.


Gehen Sie zu Inhalt > Nachschlagetabellen und klicken Sie auf Erstellen.

  • Geben Sie einen Anzeigenamen ein

  • Geben Sie ein Slug ohne Leerzeichen ein



Der Slug wird verwendet, um auf diese Tabelle zu verweisen und darf nur alphanumerische Zeichen enthalten. Beachten Sie, dass dieser Slug in der E-Mail-Vorlagenreferenzierung verwendet wird

  • Klicken Sie auf Speichern



Erstellen eines Elements in einer Tabelle

Klicken Sie auf die von Ihnen erstellte Tabelle

Wählen Sie im erscheinenden Kontextmenü „Anzeigen“



Jedes Element in einer Tabelle ist im Wesentlichen ein JSON-Dokument. Das bedeutet, dass Sie eine Baumstruktur von Schlüsseln und Werten aufbauen können, wobei die Werte selbst Text, Zahlen, Booleans, Arrays oder Objekte sein können. Sie können entweder ein JSON-Dokument direkt unter Verwendung der JSON-Syntax eingeben oder einen UI-Editor verwenden, um das JSON-Dokument zu erstellen.

JSON-Editor

  • Sobald Sie gespeichert haben, sehen Sie einen JSON-Editor. Sie können je nach Vorliebe entweder den Text- oder UI-Editor auswählen.

  • Aktualisieren Sie die Nachschlagetabelle mit einer JSON-Struktur.

Hinzufügen eines Elements

Um ein Element in einer JSON für die Organisation hinzuzufügen, klicken Sie im linken Bereich auf +Element hinzufügen.

  • Geben Sie oben einen Namen ein

  • Klicken Sie auf die Schaltfläche Element hinzufügen

  • Sobald erstellt, können Sie das erstellte Element im linken Bereich sehen.

Schreiben Sie das JSON

Verwenden Sie das JSON-Format, um die Struktur eines Objekts und Schlüssel-Wert-Paare unten zu definieren:

Zum Beispiel ein JSON, das den Ländernamen und die lokale Währung basierend auf der Länderkürzel angibt

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Sie können auch den UI-Editor verwenden, um die JSON-Struktur zu definieren.


Verwenden Sie Lookup Table in E-Mail-Vorlage


Um eine Nachschlagetabelle in einer E-Mail-Vorlage zu verwenden, können Sie die folgende Liquid-Syntax in Ihre HTML-Vorlage oder in ein HTML-Element einfügen, das in einem Drag-and-Drop-Builder verwendet wird:

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

{{variable_name.key_name}}

Hier,

  • variable_name ist ein beliebiger Name, den Sie definieren können

  • lookup-table-slug ist der Slug, den Sie bei der Erstellung der Nachschlagetabelle vergeben haben

  • item-name ist der Name des Elements, das Sie erstellt haben

  • object-value ist der Wert, den Sie für das JSON-Element angegeben haben

  • key_name ist der Name des Schlüssels im Schlüssel-Wert-Paar, das unter item-value definiert ist

Zum Beispiel,

Um die lokale Währung eines definierten Landes darzustellen, können wir die folgende Syntax verwenden

  • variable_name hier ist als Währung definiert (ein beliebiger Name, den der Benutzer definieren kann)

  • lookup-table-slug hier ist country-flags wie bei der Erstellung der Nachschlagetabelle definiert

  • item-name ist das Land, wie zuvor erstellt und im linken Bereich angezeigt

  • object-value ist AD, was der im JSON definierte Wert ist. Beachten Sie, dass dies auch eine Variable sein kann

  • key_name ist die local_currency, die im JSON definiert ist

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

{{currency.local_currency}}

Wenn die obige Syntax im HTML-Block des E-Mail-Vorlagen-Editors verwendet wird, wird der Wert der local_currency wie unter dem AD Objekt unter dem Element country in der Nachschlagetabelle country-flags gespeichert dargestellt

Sie können zum Vorschaubereich wechseln, um den dynamisch im E-Mail-Template angezeigten Ausgabe Wert zu sehen. Unten wird EUR als der Wert angezeigt, der aus der Nachschlagetabelle abgerufen wurde.

Verwendung von Lookup-Tabellen in Flows

Sie können Nachschlagetabellen in Flows lesen, um zentral definierte Daten wiederzuverwenden.

Um eine Nachschlagetabelle zu verwenden, erstellen Sie zuerst eine, wie oben beschrieben.

  1. Navigieren Sie zu Workflows > Flows

  2. Erstellen Sie einen initialen Flow mit einem Trigger-Typ Ihrer Wahl.

Fügen Sie Ihrem Flow einen neuen Perform Lookup-Schritt hinzu. Klicken Sie auf Add New Action und wählen Sie entweder aus der Gruppe Lookup Tables oder suchen Sie danach mit der Suchfunktion auf der rechten Seite:



Es wird Ihnen ein Konfigurationsbildschirm angezeigt, auf dem Sie die Tabelle auswählen können, aus der gelesen werden soll, und konfigurieren können, wie genau Sie dieses Lookup durchführen möchten:



Sie sehen drei Komponenten, die Sie konfigurieren können:

  1. Lookup Table Slug zeigt an, welche Tabelle Sie betrachten möchten. Durch Klicken in dieses Feld zeigt Flows Ihnen die verfügbaren Nachschlagetabellen:

  1. Lookup ermöglicht Ihnen zu bestimmen, was abgerufen werden soll, und Sie können die verschiedenen Ihnen zur Verfügung stehenden Variablen verwenden, um diesen Lookup-Schlüssel zu erstellen. Die Standardoperation besteht darin, den Wert zurückzugeben, auf den Ihr Look-up hinweist, als Root-Level-Wert. Aber wenn Sie ein Datenobjekt erstellen möchten, können Sie die As-Funktionalität verwenden, um es in eine bestimmte Eigenschaft zu laden:

  1. Replace ermöglicht es Ihnen, Variablen in einem zurückgegebenen Lookup-Ergebnis entweder durch einen statischen Wert oder durch einen Wert zu ersetzen, der irgendwo in Ihrer Nachschlagetabelle definiert ist. Das folgende Beispiel würde den Text {{ MyVariableName }} in jedem mit der Lookup-Aktion zurückgegebenen Element durch den Wert ersetzen, den es unter dem Schlüssel replacements.<locale>.MyVariableName findet:

Mit einem Klick auf die Test-Schaltfläche können Sie dann die resultierenden Daten sehen:


Das Konfigurieren, aus welcher Tabelle gelesen werden soll, ist erforderlich, und Sie müssen mindestens eine Lookup-Aktion hinzufügen. Es ist nicht erforderlich, Replace-Aktionen hinzuzufügen.


Lassen Sie uns Sie mit einem Bird-Experten verbinden.
Erleben Sie die volle Macht des Bird in 30 Minuten.

Durch die Übermittlung stimmen Sie zu, dass Bird Sie bezüglich unserer Produkte und Dienstleistungen kontaktieren darf.

Sie können sich jederzeit abmelden. Weitere Informationen zur Datenverarbeitung finden Sie in Birds Datenschutzerklärung.

Unternehmen

Newsletter

Bleiben Sie mit Bird auf dem Laufenden durch wöchentliche Updates in Ihrem Posteingang.

Lassen Sie uns Sie mit einem Bird-Experten verbinden.
Erleben Sie die volle Macht des Bird in 30 Minuten.

Durch die Übermittlung stimmen Sie zu, dass Bird Sie bezüglich unserer Produkte und Dienstleistungen kontaktieren darf.

Sie können sich jederzeit abmelden. Weitere Informationen zur Datenverarbeitung finden Sie in Birds Datenschutzerklärung.

Unternehmen

Newsletter

Bleiben Sie mit Bird auf dem Laufenden durch wöchentliche Updates in Ihrem Posteingang.

Lassen Sie uns Sie mit einem Bird-Experten verbinden.
Erleben Sie die volle Macht des Bird in 30 Minuten.

Durch die Übermittlung stimmen Sie zu, dass Bird Sie bezüglich unserer Produkte und Dienstleistungen kontaktieren darf.

Sie können sich jederzeit abmelden. Weitere Informationen zur Datenverarbeitung finden Sie in Birds Datenschutzerklärung.

R

Erreichen

G

Grow

M

Manage

A

Automate

Unternehmen

Newsletter

Bleiben Sie mit Bird auf dem Laufenden durch wöchentliche Updates in Ihrem Posteingang.