Ayudantes gs-helpers

Valor de reserva predeterminado default-value

El asistente Default Fallback Value se usa para devolver un valor de reserva predeterminado si un atributo está vacío o es nulo. Este mecanismo funciona para atributos de perfil y eventos de Recorrido.

Sintaxis

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

En este ejemplo, el valor there se muestra si el atributo firstName de este perfil está vacío o es nulo.

Condiciones if-function

El asistente if se usa para definir un bloque condicional.
Si la evaluación de la expresión devuelve true, se procesa el bloque; de lo contrario, se omite.

Sintaxis

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

Después del asistente if, puede escribir una instrucción else para especificar un bloque de código que se va a ejecutar, si la misma condición es falsa.
La instrucción elseif especificará una nueva condición para comprobar si la primera instrucción devuelve el valor "False".

Formato

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

Ejemplos

Unless unless

El asistente unless se usa para definir un bloque condicional. Por oposición al asistente if, si la evaluación de la expresión devuelve false, se procesará el bloque.

Sintaxis

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

Ejemplo

Procese contenido en función de la extensión de dirección de correo electrónico:

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

Cada each

El asistente each se usa para iterar en una matriz.
La sintaxis del asistente es {{#each ArrayName}} YourContent {{/each}}
Podemos hacer referencia a los elementos de matriz individuales usando la palabra clave this dentro del bloque. El índice del elemento de la matriz se puede representar con {{@index}}.

Sintaxis

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

Ejemplo

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

Ejemplo

Procese una lista de productos que este usuario tiene en el carro de compras:

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

Con with

El asistente with se usa para cambiar el token de evaluación de la plantilla-parte.

Sintaxis

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

El ayudante with también resulta útil para definir una variable de acceso directo.

Ejemplo

Use con para asignar nombres de variables largos a otros más cortos:

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

Let let

La función let permite almacenar una expresión como variable para usarla posteriormente en una consulta.

Sintaxis

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

Ejemplo

El siguiente ejemplo permite calcular la suma total de los precios de los productos del carro de compras con precios entre 100 y 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}}

Metadatos de ejecución execution-metadata

El asistente executionMetadata permite capturar y almacenar dinámicamente pares de clave-valor personalizados en el contexto de ejecución del mensaje.

Sintaxis

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

En esta sintaxis, key hace referencia al nombre de los metadatos y value son los metadatos que se van a conservar.

Caso de uso

Con esta función, puede anexar información contextual a cualquier acción nativa desde sus campañas o recorridos. Esto permite exportar datos contextuales de envío en tiempo real a sistemas externos para varios fines, como seguimiento, análisis, personalización y procesamiento descendente.

Por ejemplo, puede utilizar el asistente de Metadatos de ejecución para anexar un ID específico a cada entrega enviada a cada perfil. Esta información se genera durante el tiempo de ejecución y los metadatos de ejecución enriquecidos se pueden exportar para la reconciliación de flujo descendente con una plataforma de informes externa.

Funcionamiento

Seleccione cualquier elemento del contenido del canal dentro de una campaña o un recorrido y, con el editor de personalización, agregue el asistente de executionMetadata a este elemento.

Durante el tiempo de ejecución, el valor de los metadatos se agrega al Conjunto de datos de evento de comentarios de mensajes existente con la siguiente adición de esquema:

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

Limitaciones

Hay un límite superior de 2 kb en los pares de valor clave por acción. Si se supera el límite de 2 KB, el mensaje se envía, pero cualquiera de los pares de valor clave se puede truncar.

No se capturan metadatos para perfiles excluidos de la acción. Cuando se excluye a un perfil de la recepción de un mensaje, no se crea ninguna entrada de metadatos para ese perfil en el conjunto de datos.

Ejemplo

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

En este ejemplo, suponiendo profile.person.name.firstName = "Alex", la entidad resultante es:

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

Cifrar url-parameter-encryption-helper

La función Encrypt le permite cifrar cualquier valor de expresión en el momento del procesamiento (normalmente un atributo de perfil, un token o incluso una estructura JSON estructurada que genere en la expresión) antes de escribirlo en un parámetro de consulta en el seguimiento de vínculos o páginas de aterrizaje.

Los valores que aparecerían como texto sin formato en la dirección URL (incluida la PII u otros datos confidenciales) no se pueden leer cuando se inspecciona o reenvía el vínculo. Solo se cifran los valores que ajuste con este asistente; el resto de la dirección URL no se modifica.

Ejemplo de uso

Este asistente le permite proteger datos de perfil confidenciales (PII) antes de incluirlos en la salida procesada.

Requisitos previos

Un administrador debe crear al menos una clave activa en el registro de claves a nivel de zona protegida. Aprenda a crear y administrar claves

Sintaxis

{{encrypt dataPath keyName="keyName" version="version" result="variableName"}}

Uso

Este asistente cifra los datos confidenciales y almacena el resultado en una variable de plantilla.

Puede aplicar el asistente a un parámetro, a varios o a todos los parámetros de un vínculo, según el diseño de la URL y las restricciones de longitud.

Ejemplos

Mecanismos de protección