Hjälpmedel gs-helpers

Standardvärde för reserv default-value

Hjälpprogrammet Default Fallback Value används för att returnera ett standardreservvärde om ett attribut är tomt eller null. Den här mekanismen fungerar för profilattribut och resthändelser.

Syntax

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

I det här exemplet visas värdet there om attributet firstName för den här profilen är tomt eller null.

Villkor if-function

Hjälpprogrammet if används för att definiera ett villkorsblock.
Om uttrycksutvärderingen returnerar true återges blocket, i annat fall hoppas det över.

Syntax

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

Efter hjälpen för if kan du ange en else-sats för att ange ett kodblock som ska köras, om samma villkor är falskt.
Programsatsen elseif anger ett nytt villkor som ska testas om den första programsatsen returnerar false.

Format

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

Exempel

Om unless

Hjälpprogrammet unless används för att definiera ett villkorsblock. Om uttrycksutvärderingen returnerar false återges blocket som motsatt if-hjälpen.

Syntax

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

Exempel

Återge innehåll baserat på e-postadresstillägg:

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

Varje each

Hjälpprogrammet each används för att iterera över en array.
Den hjälpandes syntax är {{#each ArrayName}} YourContent {{/each}}
Vi kan referera till de enskilda arrayobjekten genom att använda nyckelordet this inuti blocket. Index för arrayelementet kan återges med {{@index}}.

Syntax

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

Exempel

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

Exempel

Visa en lista över produkter som den här användaren har i kundvagnen:

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

Med with

Hjälpprogrammet with används för att ändra utvärderingstoken för malldel.

Syntax

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

Hjälpprogrammet with är också användbart för att definiera en genvägsvariabel.

Exempel

Använd med för att skapa alias för långa variabelnamn för kortare:

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

Låt let

Funktionen let tillåter att ett uttryck lagras som en variabel som kan användas senare i en fråga.

Syntax

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

Exempel

I följande exempel kan du beräkna den totala summan av priserna för produkter i vagnen med priser mellan 100 och 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}}

Körningsmetadata execution-metadata

Hjälpprogrammet executionMetadata gör att du kan hämta och lagra anpassade nyckelvärdepar dynamiskt i meddelandekörningskontexten.

Syntax

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

I den här syntaxen refererar key till metadatanamnet och value är de metadata som ska bevaras.

Användningsfall

Med den här funktionen kan ni lägga till sammanhangsbaserad information till alla inbyggda åtgärder från era kampanjer eller resor. På så sätt kan ni exportera sammanhangsbaserade data i realtid till externa system för olika syften, som spårning, analys, personalisering och nedladdning.

Du kan till exempel använda hjälpen för metadata för körning för att lägga till ett specifikt ID för varje leverans som skickas till varje profil. Den här informationen genereras under körningen och de inbyggda körningsmetadata som sedan kan exporteras för avstämning i efterföljande led med en extern rapporteringsplattform.

Så här fungerar det

Välj ett element från ditt kanalinnehåll i en kampanj eller resa och lägg till executionMetadata-hjälpen i det här elementet med hjälp av anpassningsredigeraren.

Vid körning läggs metadatavärdet till i befintliga Message Feedback Event Dataset med följande schemaläggning:

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

Begränsning

Det finns en övre gräns på 2 kB för nyckelvärdepar per åtgärd.

Om gränsen på 2 kB överskrids levereras meddelandet fortfarande, men något av nyckelvärdeparen kan trunkeras.

Exempel

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

I det här exemplet är den resulterande entiteten profile.person.name.firstName = "Alex":

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