Usted está aquí:
Funciones de dimensiones calculadas
Marketing Cloud Intelligence proporciona funciones básicas que puede usar para crear dimensiones calculadas dinámicas.
Las funciones se dividen en estas categorías:
- Funciones numéricas
- Funciones de texto
- Funciones de fecha
- Funciones de agregación
- Funciones lógicas
- Conversión de tipo
- Funciones de contenido
En estas tablas, se resumen las funciones disponibles para crear dimensiones calculadas.
Funciones numéricas
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| ABS | ABS(number) | Devuelve el valor absoluto de un número. |
| CEILING | CEILING(número, significancia) | Redondea el número hacia arriba, en dirección contraria a cero, al múltiplo significativo más cercano. |
| FLOOR | FLOOR(número, significancia) | Redondea el número hacia abajo, en dirección de cero, al múltiplo significativo más cercano. |
| RAND | RAND() | Da un número aleatorio entre 0 y 1. |
| ROUND | ROUND(number) | Redondea un número al entero más próximo. |
| ROUND | ROUND(número, cantidad_de_dígitos) | Redondea un número a una cantidad de dígitos especificada. |
Funciones de texto
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| CHAR | CHAR(número) | Devuelve un carácter especificado por un número. |
| COALESCE | COALESCE([valor1, valor2, ...]) | Devuelve el primer valor desde la lista que no está vacía. |
| CODE | CODE(texto) | Devuelve un código numérico correspondiente al primer carácter de una cadena de texto. |
| COUNT_CHAR | COUNT_CHAR(text, charToCount) | Cuenta cuántas veces aparece un carácter específico en un texto. |
| EXTRACT | EXTRACT(text, delimiter, position) | Extrae del texto indicado la subcadena situada en la posición indicada tras haberse dividido con el delimitador indicado. Por ejemplo, EXTRACT(‘a,b,c’,’_’,1) devuelve “b”. |
| FIND | FIND(findText, withinText) | Devuelve la posición inicial de texto_a_buscar en dentro_de_texto. Devuelve -1 si withinText no contiene findText. |
| FUZZYMATCH | FUZZYMATCH(valueToMatch, array, threshold) | Busca una cadena en una matriz de valores que son posibles coincidencias utilizando algoritmos de detección de duplicados que calculan la similitud de dos transmisiones de datos. Devuelve la cadena coincidente de la matriz si hay una coincidencia o, si no se encuentra ninguna coincidencia, devuelve una cadena vacía. Por ejemplo, FUZZYMATCH(“ABC Company”,{“ABC Company Inc”,“Apple Inc”,“IBM Company”},0.8) devuelve “ABC Company Inc”. El parámetro del umbral debe ser un valor entre 0 y 1. Un umbral de 1 significa que debe ser una coincidencia exacta. |
| GET_EXCHANGE_RATE | GET_EXCHANGE_RATE(fecha, de_ISO, a_ISO) | Devuelve el tipo de cambio correspondiente a las divisas y la fecha indicadas. La variable “fecha” de la fórmula puede ser un campo de fecha asignado o una función de fecha. Por ejemplo:
donde [Día] es un campo de fecha asignado,
donde FECHA('AAAA','MM','DD') es una función de fecha.
donde AYER() es una función de fecha. |
| INDEXOF | INDEXOF(matriz, texto_a_buscar) | Busca el elemento especificado en la matriz y devuelve su posición. Si no lo encuentra, devuelve -1. Si el elemento aparece varias veces, la función INDEXOF indica la posición de la primera vez que aparece. Por ejemplo, INDEXOF(csv['fila'], 'ID de campaña') == 0 devolverá verdadero si se encuentra “ID de campaña” en la primera celda. Nota: El primer elemento tiene la posición 0, el segundo la posición 1 y así sucesivamente. |
| ISEMPTY | ISEMPTY(valor) | Indica si el valor está vacío o no. |
| LEFT | LEFT(texto, cantidad_de_caracteres) | Devuelve el número solicitado de caracteres desde la izquierda. |
| LEN | LEN(text) | Devuelve el número de caracteres del texto especificado |
| LOWER | LOWER(texto) | Convierte todas las letras mayúsculas de una cadena en letras minúsculas. |
| MATCH | MATCH(valor_coincidente, matriz) | Busca un elemento especificado en una matriz de valores y devuelve un resultado booleano. Por ejemplo, MATCH(1,{1,2,3}) devuelve verdadero si el valor “1” existe en la matriz. |
| PROPER | PROPER(texto) | Pone en mayúsculas la primera legra de una cadena de texto y cualquier otra letra en el texto que sigue cualquier carácter que no sea una letra. Pone las demás letras en minúsculas. |
| REPLACE | REPLACE(cadena_origen, patrón, cadena_destino) | Sustituye todas las coincidencias de un patrón (una expresión regular, o Regex) de la cadena de origen por la cadena de destino. Por ejemplo, REPLACE('Mis-mejores-deseos', '-', ' ') devuelve “Mis mejores deseos”. En otro ejemplo, REPLACE('Déjalo Ser','\\s','-') devuelve “Déjalo-Ser”. |
| RIGHT | RIGHT(texto, cantidad_de_caracteres) | Devuelve el número solicitado de caracteres desde la derecha. |
| SELECT | SELECT(sourceStr, pattern) | Selecciona la primera coincidencia del patrón (una expresión regular, o Regex) en la cadena de origen. Por ejemplo, SELECT('Hola B wow E Adiós', 'B(.*?)E') devuelve “B wow E”. |
| SEMTIMEN | SEMTIMEN(texto) | Extrae una opinión positiva, neutra o negativa del texto dado. |
| SPLIT | SPLIT(text, delimiter) | Divide una cadena de texto en una matriz usando un carácter como delimitador. Devuelve una matriz unidimensional basada en cero que mantiene las partes de la cadena de texto original. Por ejemplo, SPLIT('a,b,c', ',') devuelve una matriz con tres elementos. |
| SUBSTITUTE | SUBSTITUTE(texto,texto_antiguo,texto_nuevo) | Sustituye nuevoTexto por textoAnterior en una cadena de texto. Utilice SUBSTITUTE cuando desee sustituir texto específico en una cadena de texto. |
| SUBSTRING | SUBSTRING(text,beginIndex,endIndex) | Devuelve la subcadena del texto que empieza en índice_inicial (incluido) y finaliza en índice_final (excluido). |
| TRIM | TRIM(text) | Elimina todos los espacios del texto excepto los espacios únicos entre palabras. |
| UPPER | UPPER(text) | Convierte todas las letras en minúsculas de la cadena de texto especificada en mayúsculas. |
| URL_DECODE | URL_DECODE(texto) | Descodifica una cadena application/x-www-form-urlencoded empleando un esquema de codificación UTF-8. |
| URL_ENCODE | URL_ENCODE(texto) | Traduce un texto a un formato application/x-www-form-urlencoded empleando un esquema de codificación UTF-8. |
| VALUE_FROM_JSON | VALUE_FROM_JSON(cadena JSON, clave) | Devuelve el valor de una clave dada presente en una cadena JSON. Si la clave no está presente o la cadena JSON está vacía, devuelve una cadena vacía. |
Funciones de fecha
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| DATE | DATE(año, mes) | Devuelve el primer día del mes indicado del año indicado. |
| DATE | DATE(year, month, day) | Devuelve la fecha que representa los argumentos especificados. |
| DATEADD | DATEADD(interval, number, date) | Devuelve la fecha después de agregar un intervalo de fechas o un período específicos. El intervalo debe ser 'aaaa' (año), 't' (trimestre), 'm' (mes), 'd' (día), 'ss' (semana), 'h' (hora), 'n' (minuto), o 's' (segundo). |
| DATEDIFF | DATEDIFF(intervalo,fecha_inicial,fecha_final) | Devuelve el número de unidades de tiempo especificadas en el intervalo entre fecha_inicial y fecha_final. Los argumentos FechaInicio y FechaFinalización deben ser objetos de fecha o cadenas de fecha en formato estándar. El intervalo debe ser 'aaaa' (año), 't' (trimestre), 'm' (mes), 'd' (día), 'ss' (semana), 'h' (hora), 'n' (minuto), o 's' (segundo). |
| DAYPRECISION | DAYPRECISION(date) | Devuelve la fecha indicada con una precisión de un día, lo que significa que los valores de horas, minutos y segundos son 0. Por ejemplo, la fecha '12-jun-2012 16:34' se convierte a '12-jun-2012 00:00'. |
| DAYSBETWEEN | DAYSBETWEEN(startDate, endDate) | Devuelve el número de días entre startDate y endDate especificadas. Los argumentos deben ser objetos de fecha o cadenas de fecha en formato estándar. |
| DAYSINMONTH | DAYSINMONTH(fecha) | Devuelve el número de días en un mes especificado. |
| NETWORKDAYS | NETWORKDAYS(startDate, endDate) | Devuelve el número de días laborables entre dos fechas, excluyendo los fines de semana. Los argumentos deben ser objetos de fecha o cadenas de fecha en formato estándar. |
| NOW | NOW() | Devuelve la fecha y hora del sistema actual. |
| SETHOUR | SETHOUR(date, hour) | Devuelve la fecha especificada con la hora especificada, donde la hora es un valor numérico entre 0 y 23. |
| HOY | TODAY() | Devuelve la fecha actual del sistema. |
| TOSECONDS | TOSECONDS(duration) | Devuelve el número de segundos representados por la cadena de duración especificada, con el formato HH:mm:ss/HH:mm:ss.SSS. |
| AYER | YESTERDAY() | Devuelve la fecha de ayer del sistema. |
Funciones de agregación
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| GROUPCONCAT | GROUPCONCAT(dimensión_agrupada, dimensión_clave, separador) | Concatena los valores de dimensión_agrupada por el valor de dimensión_clave y usa la cadena del separador entre los dos valores agrupados. Este proceso se hace solo una vez por cada valor; si un mismo valor se repite, no se vuelve a concatenar. Por ejemplo, GROUPCONCAT({nombre de compras de medios}, {nombre de campaña}, ',') da como resultado todos los nombres de compras de medios concatenados (sin repeticiones) correspondientes a cada campaña. |
Funciones lógicas
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| Y | AND(condition1, condition2) | AND lógico, comprueba si ambas condiciones son verdaderas. |
| IF | IF(condición,resultado_si_verdadero,resultado_si_falso) | Devuelve el segundo argumento si el primero es verdadero y el tercero si no lo es. |
| IFERROR | IFERROR(alguna_expresión, número) | Devuelve alguna_expresión si es un número válido; de lo contrario, devuelve un número. |
| NOT | NOT(condition) | NOT lógico, invierte la lógica de su argumento, verdadero se convierte en falso y viceversa. |
| O | OR(condición) | La regla lógica OR verifica si alguna de las dos condiciones es verdadera. |
Funciones de conversión de tipo
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| COMPRESS | COMPRESS(valor1) | Comprime una cadena empleando gzip y la devuelve en base64. |
| DECODE_BASE64 | DECODE_BASE64(valor1) | Descodifica una cadena base64. |
| DOUBLE | DOUBLE(valor1) | Convierte una cadena en un doble. |
| ENCODE_BASE64 | ENCODE_BASE64(valor1) | Codifica una cadena a base64. |
| FORMATDATE | FORMATDATE(date, pattern) | Devuelve la representación de cadena de la fecha especificada según el patrón suministrado. Por ejemplo, 'aaaa-MM-dd' --> 2014-02-25, 'dd MMM-aaaa' --> 25 feb-2014, etc. |
| FORMATDATE_DEFAULT | FORMATDATE_DEFAULT(fecha) | Devuelve la fecha especificada con la representación de cadena predeterminada de Marketing Cloud Intelligence (aaaa-MM-dd HH:mm:ss.S). |
| MD5 | MD5(stringToHash) | Devuelve un hash MD5 de la cadena especificada. |
| NÚMERO | NUMBER(value1) | Convierte una cadena en un número. |
| PARSEDATE | PARSEDATE(dateString, pattern) | Devuelve el objeto especificado por la dateString empleando el patrón especificado. Por ejemplo, '2014-02-25' ---> 'aaaa-MM-dd', '25 feb-2014' ---> 'dd MMM-aaaa', etc. |
| SHA256 | SHA256(stringToHash) | Devuelve el hash SHA256 de la cadena especificada. |
| STRIP_HTML | STRIP_HTML(valor1) | Quita HTML de una cadena. |
| UNCOMPRESS | UNCOMPRESS(value1) | Descomprime una cadena base64 mediante gzip. |
Funciones contextuales
| NOMBRE DE LA FUNCIÓN | SINTAXIS | DESCRIPCIÓN |
|---|---|---|
| CONTEXT_DIMENSION_CONTAINS | CONTEXT_DIMENSIONS_CONTAIN(dimensión) | Devuelve el valor “true” si la dimensión indicada está incluida en la consulta. |
| CONTEXT_DIMENSION_EQUALS | CONTEXT_DIMENSIONS_EQUALS(dimensión) | Devuelve el valor “true” si las dimensiones indicadas coinciden exactamente con las dimensiones contextuales. Introduzca todas las dimensiones pertinentes; el orden no es importante. |
| FilterEndDate | FilterEndDate() | Devuelve la fecha final del filtro de la consulta. |
| FilterStartDate | FilterStartDate() | Devuelve la fecha inicial del filtro de la consulta. |
| GET_ENV | GET_ENV(nombre_de_variable) | Devuelve el valor de la variable de entorno dada. Los valores posibles de nombre_de_variable son: WORKSPACE_ID |
| QUERY_DIMENSIONS_CONTAIN | QUERY_DIMENSIONS_CONTAIN(dimensión) | Devuelve el valor “true” si la dimensión indicada es una de las dimensiones de la consulta. |
| QUERY_DIMENSIONS_EQUAL | QUERY_DIMENSIONS_EQUAL([dimensiones]) | Devuelve el valor “true” si las dimensiones indicadas coinciden exactamente con las dimensiones de la consulta. Introduzca todas las dimensiones relevantes; el orden no es importante. |
¿Resolvió este artículo su problema?
¡Háganos saber cómo podemos mejorar!
