Skip to main content
Build the future with Agentforce at TDX in San Francisco or on Salesforce+ on March 5–6. Register now.

Utilizar variables y funciones de búsqueda

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

  • Explicar variables y cómo se utilizan en AMPscript.
  • Identificar cuándo utilizar las funciones Lookup() y LookupRows().

Definición de variables

Anteriormente en este módulo, describimos variables en AMPscript como un marcador de posición para datos. Revisemos cómo funciona esto echando un vistazo a cómo funcionan los elementos de código juntos para definir y establecer variables.

Código Qué hace
VAR @cats
Define los marcadores de posición.
SET @cats = catbreed 
Definen un valor desde la extensión de datos que se puede enviar.
SET @cats = "tabby"
Establecen un valor específico o literal.
%%=v(@cats)=%%
AMPscript en línea utilizado en su contenido de email para devolver el valor.

Descompongamos estos elementos en un email que utiliza AMPscript.

Código de muestra con llamadas basadas en secciones de código.

1 . Inicie su código con %%[ para el bloque AMPscript y agregue comentarios opcionales acerca del código utilizando /* y */.

2 . Declare las variables a las que hará referencia en el mensaje mediante la estructura de VAR @createdname. Puede utilizar cualquier nombre de variable que desee. Para algunas personas resulta útil acortar el nombre de campo de una extensión de datos o presentar un nombre descriptivo reconocible. En este ejemplo, se utilizó VAR @memid, @fname, @lname, etc. Asegúrese de separar cada variable con una coma.

3 . A continuación, asigne las variables de acuerdo con el valor de campo de una extensión de datos que se puede enviar. Esto se hace mediante SET @name = ActualFieldName. Cuando establece esas variables, deben coincidir con sus variables declaradas desde el segundo paso. Una vez hecha la definición de los campos que utilizará, finalice el bloque con ]%%.

A continuación llega la parte divertida de redactar actualmente el contenido. 

4 . Este bloque de código muestra los datos en la extensión de datos para rellenar esta parte de contenido. El código %%= v(@fname) =%% es la instancia de AMPscript en línea con la que se extrae FirstName de la extensión de datos que se puede enviar identificada por SET @fname.

Nota

Si el campo de extensión de datos tiene un espacio, el nombre de campo debe estar entre corchetes. Ejemplo: SET @fname = [First Name]

Con un poco de CSS y formatos (y por supuesto datos en la extensión de datos correspondiente), este email se rellena así utilizando Vista previa y Prueba. 

Borrador de email con fotos y datos de muestra utilizando nombre, apellidos, código postal, preferencia de miembro y estado platinum.

Magnífico.

Nota

¿Problemas con la verificación de su código? Asegúrese de hacer referencia a los nombres de campo de extensión de datos exactos, echar un vistazo a sus comas y confirmar que cerró el bloque de código.  

Funciones de búsqueda

AMPscript se utiliza de forma bastante amplia para extraer datos de extensiones de datos utilizando Lookup() y LookupRows(). Estas son útiles cuando necesita obtener información desde extensiones de datos que no son las que está utilizando para el envío. De modo que por ejemplo, es posible que esté enviando una campaña a una extensión de datos segmentada de sus suscriptores principales, pero debe hace referencia a su extensión de datos de producto en su email para obtener su compra más reciente. Las funciones Lookup() y LookupRows() le permiten (lo adivinó) buscar datos en extensiones de datos específicas y devolver campos basándose en los valores que incluye en las funciones. Hagamos una revisión.


Lookup()
LookupRows()
Descripción
Devuelve criterios de coincidencia para un conjunto de fecha establecido en una tabla para un campo de datos.
Devuelve criterios de coincidencia para un conjunto de datos en una tabla, pero devuelve datos almacenados en varias columnas.
Muestra de código
%%= Lookup("LoyaltyLevelDE","LoyaltyLevel","MemberID", @memId)=%%
%%= LookupRows("FlightInfoDE","Flight", Flight,"Seat",Seat Number, "Boarding", BoardingGroup) =%%
Caso de uso de ejemplo
Compare el nivel de fidelidad en el registro del suscriptor con la tabla de fidelidad para mostrar el nivel apropiado en un email.
Compare el número de referencia de la reserva en la tabla del suscriptor con la tabla de reservas para mostrar número de vuelo, hora de vuelo, número de asiento, grupo de embarque.

Imagine que está horneando una tarta para el cumpleaños de su amigo. No hará recorridos separados a la tienda de comestibles ara buscar harina y luego azúcar y luego huevos. Del mismo modo, no tendría sentido utilizar Lookup() cuando puede obtener todos los ingredientes en un solo viaje utilizando LookupRows(). El uso de esta función crea eficiencia y ayuda con el desempeño.

Comprobación de conocimientos

¿Listo para revisar lo que aprendió? La comprobación de conocimientos a continuación no está puntuada; es solo una forma sencilla de examinarse. Para utilizarla, arrastre la función en la columna izquierda al objetivo coincidente a la derecha. Cuando finalice la comparación de todos los elementos, haga clic en Enviar para comprobar su trabajo.

¡Bien hecho! En la siguiente unidad iniciamos el Simulador de Trailhead para practicar utilizando AMPscript en la aplicación. 

Recursos

Comparta sus comentarios de Trailhead en la Ayuda de Salesforce.

Nos encantaría saber más sobre su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios en cualquier momento en el sitio de Ayuda de Salesforce.

Más información Continuar a Compartir comentarios