Lookup-Tabellen
Wie man Lookup-Tabellen verwendet
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
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:
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
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.
Navigieren Sie zu Workflows > Flows
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:
Lookup Table Slug zeigt an, welche Tabelle Sie betrachten möchten. Durch Klicken in dieses Feld zeigt Flows Ihnen die verfügbaren Nachschlagetabellen:
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:
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üsselreplacements.<locale>.MyVariableNamefindet:
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.
