MARKETING CLOUD / AMPSCRIPT
AMPscript
Personalización, lookups, y los modismos de AMPscript que sobreviven a un hand-off. Anclado al tipo de lógica de email que se publica todos los días.
Fundamento · 2
Nota de producción
Gotchas de MC AMPscript: lo que sobrevive un hand-off
AMPscript parece un lenguaje de template simple. La realidad a escala son tres sintaxis distintas para variables, tres chequeos de NULL que significan cosas distintas, una API de lookup que falla en silencio, y un preview que no renderea el mismo code path que el envío. Diez gotchas anclados a la próxima persona heredando tu email.
Marco de decisión
AMPscript de Marketing Cloud: Style Guide
Las reglas opinionadas que Cleon aplica a cada bloque AMPscript que entrega en Marketing Cloud — naming, formato, comentarios, patrones a preferir, anti-patrones a rechazar — destiladas de los gotchas y las páginas de referencia en un solo documento de disciplina. Espeja las Style Guides de SQL y SSJS.
Referencia · 9
Referencia
Basics — fundamentos de Marketing Cloud AMPscript
Dónde corre AMPscript en Marketing Cloud, las tres formas de sintaxis (bloque, función inline, interpolación de campo), las categorías de funciones de un vistazo, y el árbol de decisión para cuándo elegir AMPscript vs SSJS vs SQL.
Referencia
Funciones de string — referencia de Marketing Cloud AMPscript
Las operaciones de string disponibles en AMPscript — cada función con la indexación invertida (1-based, no 0-based), el comportamiento de replace-all-por-default, y el set chico de helpers de formato. Dónde diverge de SSJS y SQL, más los patrones que Cleon entrega.
Referencia
Funciones de fecha — referencia de Marketing Cloud AMPscript
La superficie de fecha de AMPscript — Now / DateAdd / DateDiff / DatePart / FormatDate / DateParse. La trampa de timezone (el reloj de sistema de MC es CST independientemente de donde esté el tenant), la inestabilidad del math de meses, y los patrones que sobreviven a escala.
Referencia
Funciones de math — referencia de Marketing Cloud AMPscript
La superficie de math de AMPscript — seis funciones, sin operadores, coerción silenciosa de string a número. El comportamiento de divide-por-cero cambia entre tenants, el math de plata tiene trampas de floating point, y 'abc' se vuelve 0 sin warning. Los patrones que sobreviven a escala.
Referencia
Funciones de validación — referencia de Marketing Cloud AMPscript
La superficie de validación de AMPscript — Empty / IsNull / IsEmailAddress / IsPhoneNumber / IsNumeric. Útil para ramificación en render time, peligrosa como sustituto de calidad de data upstream. Los patrones que sobreviven a escala.
Referencia
Funciones de Data Extension — referencia de Marketing Cloud AMPscript
Las funciones de read y write de DE — Lookup, LookupRows, LookupOrderedRows, Row, Field, RowCount, InsertData, UpdateData, UpsertData, ClaimRow. La superficie más safety-critical del lenguaje: los writes pueden fallar en silencio, los lookups pueden truncar en 2000, y un par de argumentos mal alineado aterriza el valor equivocado en la columna equivocada.
Referencia
Funciones de Subscriber + Profile — referencia de Marketing Cloud AMPscript
AttributeValue, _subscriberKey, _emailaddress, _jobid, _messagecontext, y el resto del contexto que AMPscript hereda del send que lo rodea. Qué devuelve cada uno, cuándo está disponible, y la diferencia entre Subscriber Attributes, columnas de DE, y variables locales.
Referencia
Funciones de Cloud-write — referencia de Marketing Cloud AMPscript
El puente de AMPscript hacia Sales/Service Cloud — UpdateSingleSalesforceObject, CreateSalesforceObject, RetrieveSalesforceObjects. La superficie de mayores stakes del lenguaje: los writes son inline, devuelven 1/0 sin tirar, y pueden pegar a registros CRM de producción reales desde un preview si te olvidás el gate de messagecontext.
Referencia
Funciones de Encoding + Hashing — referencia de Marketing Cloud AMPscript
URLEncode, Base64Encode/Decode, HTMLEncode, el wrapper de tracking RedirectTo, más hashes SHA1/SHA256/SHA512/MD5 y encriptación simétrica. Cada función va con una forma de falla de producción — escape de URL equivocado rompe links de tracking, HTMLEncode faltante abre XSS en CloudPages, MD5 usado como seguridad en vez de como tracking key.
Cómo hacerlo · 3
Cómo hacerlo
Debugging de blancos en render time
Un email salió, los destinatarios ven 'Hola, ' con un blanco donde debería ir el primer nombre. El Send muestra Completed. El Lookup de AMPscript devolvió NULL sin tirar. Cinco queries contra el DE de audiencia y cualquier DE de log que encuentran cuál de los tres culpables habituales es el bug realmente.
Cómo hacerlo
Debugging de mismatch preview-vs-send
El email rendereó bien en el preview de Email Studio, salió, y la versión enviada real es distinta. Seis checkpoints que reproducen la divergencia determinísticamente antes de que dispare el próximo send — variables de contexto, gates de _messagecontext, formateo de locale, lógica time-sensitive, drift de data de Lookup, y el único diagnóstico verdaderamente concluyente: un test send real.
Cómo hacerlo
Debugging de fallas silenciosas de Cloud-write
Un Cloud-write de AMPscript reportó success en render time. El email salió. Días después, el equipo de ventas nota que los registros de Salesforce que el email debía actualizar están desactualizados. UpdateSingleSalesforceObject devolvió 0 en silencio — y 0 significa siete cosas distintas. Cinco queries contra de_log_sf_writes que separan las siete.