Helpers gs-helpers

Standaardwaarde voor alternatieven default-value

De Default Fallback Value helper wordt gebruikt om een standaardreservewaarde terug te keren als een attribuut leeg of ongeldig is. Dit mechanisme werkt voor Profielkenmerken en Reisgebeurtenissen.

Syntaxis

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

In dit voorbeeld wordt de waarde there weergegeven als het firstName -kenmerk van dit profiel leeg of null is.

Voorwaarden if-function

De hulpfunctie if wordt gebruikt om een voorwaardelijk blok te definiëren.
Als de uitdrukkingsevaluatie waar terugkeert, wordt het blok teruggegeven anders wordt het overgeslagen.

Syntaxis

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

Na de hulpfunctie if kunt u een instructie else invoeren om een codeblok op te geven dat moet worden uitgevoerd als dezelfde voorwaarde false is.
De instructie elseif geeft een nieuwe voorwaarde op die moet worden getest als de eerste instructie false retourneert.

Formaat

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

Voorbeelden

Tenzij unless

De hulpfunctie unless wordt gebruikt om een voorwaardelijk blok te definiëren. Als de evaluatie van de expressie false retourneert, wordt het blok gerenderd als dit tegengesteld is aan de if helper.

Syntaxis

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

Voorbeeld

Enige inhoud renderen op basis van extensie e-mailadres:

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

Elk each

De hulpfunctie each wordt gebruikt om een array te doorlopen.
De syntaxis van de hulplijn is {{#each ArrayName}} YourContent {{/each}}
Wij kunnen naar de individuele seriepunten verwijzen door het sleutelwoord dit binnen het blok te gebruiken. De index van het element van de array kan worden gerenderd met {{@index}} .

Syntaxis

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

Voorbeeld

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

Voorbeeld

Een lijst met producten weergeven die deze gebruiker in zijn winkelwagentje heeft:

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

Met with

De with helper wordt gebruikt om het evaluatietoken van malplaatje-deel te veranderen.

Syntaxis

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

De hulpfunctie with is nuttig om ook een sneltoetsvariabele te definiëren.

Voorbeeld

Wordt gebruikt met voor het aliasing van lange variabelenamen naar kortere namen:

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

Laat let

Met de functie let kan een expressie worden opgeslagen als een variabele die later in een query moet worden gebruikt.

Syntaxis

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

Voorbeeld

In het volgende voorbeeld kunt u de totale som van prijzen voor producten in de winkelwagen berekenen met prijzen tussen 100 en 1000.

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

Metagegevens van uitvoering execution-metadata

Met de executionMetadata -hulpfunctie kunt u op dynamische wijze aangepaste sleutel-waardeparen vastleggen en opslaan in de context van de berichtuitvoering.

Syntaxis

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

In deze syntaxis verwijst key naar de naam van de metagegevens en is value de metagegevens die moeten worden voortgezet.

Gebruiksscenario

Met deze functie kunt u contextafhankelijke informatie toevoegen aan elke native actie van uw campagnes of reizen. Op deze manier kunt u contextgegevens voor levering in realtime naar externe systemen exporteren voor verschillende doeleinden, zoals reeksspatiëring, analyse, personalisatie en downstreamverwerking.

U kunt bijvoorbeeld de functie Metagegevens uitvoeren gebruiken om een specifieke id toe te voegen aan elke levering die naar elk profiel wordt verzonden. Deze informatie wordt tijdens runtime gegenereerd en de verrijkte metagegevens voor uitvoering kunnen vervolgens worden geëxporteerd voor afstemming op een extern rapportageplatform.

hoe het werkt

Selecteer een element uit de inhoud van uw kanaal in een campagne of een rit en voeg, met de personalisatie-editor, de executionMetadata -hulplijn toe aan dit element.

Tijdens runtime wordt de metagegevenswaarde toegevoegd aan de bestaande Message Feedback Event Dataset met het volgende schema:

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

Beperking

Er is een bovengrens van 2kb op de belangrijkste waardeparen per actie.

Als de limiet van 2 kB wordt overschreden, wordt het bericht nog steeds geleverd, maar een van de sleutelwaardeparen kan worden afgekapt.

Voorbeeld

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

In dit voorbeeld, uitgaande van profile.person.name.firstName = "Alex", is de resulterende entiteit:

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