Helper gs-helpers

Standardwert für Fallback default-value

Der Helper Default Fallback Value wird verwendet, um einen standardmäßigen Fallback-Wert zurückzugeben, wenn ein Attribut leer oder null ist. Dieser Mechanismus funktioniert für Profilattribute und Journey-Ereignisse.

Syntax

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

In diesem Beispiel wird der Wert there angezeigt, wenn das Attribut firstName dieses Profils leer oder null ist.

Bedingungen if-function

Der Helper if wird zum Definieren eines bedingten Blocks verwendet.
Wenn die Auswertung des Ausdrucks „true“ zurückgibt, wird der Block dargestellt, andernfalls wird er übersprungen.

Syntax

{%#if contains(profile.personalEmail.address, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

Nach dem Helper if können Sie eine else-Anweisung einfügen, um einen Code-Block auszuführen, wenn die Auswertung „false“ zurückgibt.
Die elseif-Anweisung gibt eine weitere Bedingung an, die geprüft wird, wenn die erste Anweisung „false“ zurückgibt.

Format

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

Beispiele

Außer unless

Der Helper unless wird zum Definieren eines bedingten Blocks verwendet. Im Gegensatz zum Helper if wird der Block gerendert, wenn die Auswertung des Ausdrucks „false“ zurückgibt.

Syntax

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

Beispiel

Darstellung von Inhalt je nach E-Mail-Adressenerweiterung:

{%#unless endsWith(profile.personalEmail.address, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content
{%/unless%}

Jeweils each

Der Helper each wird verwendet, um die Elemente eines Arrays zu verarbeiten.
Die Syntax des Helpers ist {{#each ArrayName}} YourContent {{/each}}
Die einzelnen Array-Elemente werden durch die Verwendung des Keywords this innerhalb des Blocks referenziert. Der Index des Array-Elements kann mithilfe von {{@index}} gerendert werden.

Syntax

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

Beispiel

{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

Beispiel

So wird eine Liste von Produkten dargestellt, die dieser Benutzer in den Warenkorb gelegt hat:

{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

Mit with

Der Helper with wird verwendet, um das Auswertungs-Token des Vorlagenteils zu ändern.

Syntax

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

Der Helper with ist auch nützlich, um die Kurzform einer Variable zu definieren.

Beispiel

Verwenden Sie „with“ zur Definition eines kurzen Aliasnamens für einen langen Variablennamen:

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

Zulassen let

Die let-Funktion ermöglicht das Speichern eines Ausdrucks als Variable, die später in einer Abfrage verwendet werden kann.

Syntax

{% let variable = expression %} {{variable}}

Beispiel

Im folgenden Beispiel können Sie die Gesamtsumme der Preise für Produkte im Warenkorb mit Preisen zwischen 100 und 1000 berechnen.

{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}

Ausführungsmetadaten execution-metadata

Der executionMetadata-Helper ermöglicht die dynamische Erfassung und Speicherung benutzerdefinierter Schlüssel-Wert-Paare im Ausführungskontext der Nachricht.

Syntax

{{executionMetadata key="your_key" value="your_value"}}

In dieser Syntax bezieht sich key auf den Namen der Metadaten und value sind die Metadaten, die beibehalten werden sollen.

Anwendungsfall

Mit dieser Funktion können Sie kontextuelle Informationen an beliebige native Aktionen Ihrer Kampagnen oder Journey anhängen. Dadurch können Sie kontextuelle Versanddaten in Echtzeit für verschiedene Zwecke wie Tracking, Analyse, Personalisierung und nachgelagerte Verarbeitung in externe Systeme exportieren.

Sie können beispielsweise den Helper Ausführungsmetadaten verwenden, um eine bestimmte ID an jeden Versand anzuhängen, der an jedes Profil gesendet wird. Diese Informationen werden zur Laufzeit generiert, und die angereicherten Ausführungsmetadaten können dann zur nachgelagerten Abstimmung mit einer externen Reporting-Plattform exportiert werden.

Funktionsweise

Wählen Sie in einer Kampagne oder auf einer Journey ein beliebiges Element aus Ihrem Kanalinhalt aus und fügen Sie mithilfe des Personalisierungseditors den executionMetadata Helper zu diesem Element hinzu.

Zur Laufzeit wird der Metadatenwert dem vorhandenen Nachrichten-Feedback-Ereignisdatensatz“ hinzugefügt wobei das folgende Schema hinzugefügt wird:

"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}

Einschränkung

Für die Schlüssel-Wert-Paare pro Aktion gibt es eine Obergrenze von 2 KB.

Wenn das 2KB-Limit überschritten wird, wird die Nachricht weiterhin zugestellt, aber jedes der Schlüssel-Wert-Paare kann abgeschnitten werden.

Beispiel

{{executionMetadata key="firstName" value=profile.person.name.firstName}}

In diesem Beispiel wird unter der Annahme profile.person.name.firstName = „Alex“, die resultierende Entität:

{
  "key": "firstName",
  "value": "Alex"
}