Las MACROS son comandos que se utilizan para ser remplazados por nuestra plataforma  por valores dinámicos al momento de enviar los datos de un anuncio al explorador de internet del usuario. Este documento lista todas las disponibles en E-Planning.

Contenido

¿Qué uso puedo darles  a las MACROS?

El uso de las MACROS es para la inserción automática de valores que dinámicamente definen su valor dependiendo del contexto donde se esta mostrando una publicidad, brindando identificadores de un anuncio, urls de conteo, entre otros.

↑ Regresar a la tabla de contenido ↑

¿En dónde puedo utilizar las MACROS?

Las Macros pueden utilizarse en los siguientes casos:

• Anuncio a partir de Template
• Tags  de terceros
• Anuncios Dinámicos DCO
• URL de conteo de impresiones
• URL de Conteo de Clicks
• URL de Destino
• pixels de conversion de terceros
  

↑ Regresar a la tabla de contenido ↑

¿Cuáles son las macros disponibles actualmente?

Las macros disponibles actualmente dependen del caso de uso. A continuación, detallaremos cada uno de ellos.

↑ Regresar a la tabla de contenido ↑

Macros disponibles en tags de terceros y anuncios a partir de templates

$AD_ID

Si dentro de un tag de terceros escribimos el texto $AD_ID, al momento de mostrarse el tag este texto sera reemplazado automáticamente por el id del anuncio que E-Planning le asigno al momento de crearlo.

$CAMPAIGN_ID

Si dentro de un tag de terceros escribimos el texto $CAMPAIGN_ID,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por el id de la pauta de E-Planning en la que el anuncio mostrado esta cargado.

$CLIENT_IP

Si dentro de un tag de terceros escribimos el texto $CLIENT_IP,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por la ip del usuario que esta viendo el anuncio en ese momento.

$DOCUMENT_URL

Si dentro de un tag de terceros escribimos el texto $DOCUMENT_URL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por la url completa de la pagina donde este anuncio esta mostrándose (incluyendo protocolo ruta  y parámetros) .

$ENC_DOCUMENT_URL

Si dentro de un tag de terceros escribimos el texto $ENC_DOCUMENT_URL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por la url completa y  encodeada en codigo URI de la pagina donde este anuncio esta mostrándose (incluyendo protocolo ruta  y parámetros) .

$ENC_IMPTRACKURL

Si dentro de un tag de terceros escribimos el texto $ENC_IMPTRACKURL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por una url de conteo encodeada en código URI. Y la impresion del tag no se contabilizara hasta que esta url se llame.

$ENC_LINKURL

Si dentro de un tag de terceros escribimos el texto $ENC_LINKURL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por una url encodeada en código URI que al requerirse contabiliza un click en la pieza y redirige al destino de click definido al cargarla en E-Planning

$IMPTRACKURL

Si dentro de un tag de terceros escribimos el texto $IMPTRACKURL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por una url de conteo. Y la impresion del tag no se contabilizara hasta que esta url se llame.

$LINKURL

Si dentro de un tag de terceros escribimos el texto $LINKURL,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por una url  que al requerirse contabiliza un click en la pieza y redirige al destino del click definido al cargarla en E-Planning.

$RANDOM

Si dentro de un tag de terceros escribimos el texto $RANDOM,   al momento de mostrarse el tag este texto  sera reemplazado automáticamente por un numero aleatorio de 10 digitos que sera diferente cada vez .

$SITE_ID

Si dentro de un tag de terceros escribimos el texto $SITE_ID,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por el id del sitio donde se este mostrando. El id es definido en E-Planning al momento de crear el sitio.

$SPACE_ID

Si dentro de un tag de terceros escribimos el texto $SPACE_ID,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por el id del espacio donde se este mostrando. El id es definido en E-Planning al momento de crear el espacio.

$UAGENT

Si dentro de un tag de terceros escribimos el texto $UAGENT,   al momento de mostrarse el tag este texto sera reemplazado automáticamente por el user agent que el explorador del usuario defina.

$KW_<keyword>

Si dentro de un tag de terceros escribimos el texto $KW_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que NO sea de tipo tabla de datos, al momento de mostrarse el tag este texto sera reemplazado automáticamente por el valor que esa keyword tiene al momento de realizarse la impresión.

$ENC_KW_<keyword>

Si dentro de un tag de terceros escribimos el texto $ENC_KW_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que NO sea de tipo tabla de datos, al momento de mostrarse el tag este texto sera reemplazado automáticamente por el valor que esa keyword tiene al momento de realizarse la impresión en código URI.

$KWT_<keyword>

Si dentro de un tag de terceros escribimos el texto $KWT_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que sea de tipo tabla de datos, al momento de mostrarse el tag este texto sera reemplazado automáticamente por el valor de la tabla de datos correspondiente al indice que esa keyword tiene al momento de realizarse la impresión.

$ENC_KWT_<keyword>

Si dentro de un tag de terceros escribimos el texto $ENC_KWT_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que sea de tipo tabla de datos, al momento de mostrarse el tag este texto sera reemplazado automáticamente por el valor de la tabla de datos correspondiente al indice que esa keyword tiene al momento de realizarse la impresión en código URI.

Macros extra disponibles en los casos Rich Media de tags de terceros y anuncios a partir de templates

En  los casos Rich Media de los tags de terceros y anuncios a partir de templates, están disponibles TODAS las macros disponibles en tags de terceros y anuncios a partir de templates estandar(No Rich Media). Pero ademas, se incorporan las siguientes:

$RM_AD_BEGINNING

Al escribir dentro del tag de tercero o código del template el texto $RM_AD_BEGINNING, este texto sera reemplazado automáticamente por una url que al requerirse indicara al adserver que debe considerar que el anuncio pudo iniciar sus funciones sin inconvenientes. Dado que por definición, una impresión Rich Media se corresponde con el inicio de reproducción de una pieza, la impresión se contabilizara recién en el momento en que este llamado se realice. Ademas, siendo que este llamado indica el correcto inicio de funciones, hasta que no se realice se ignoraran todas las métricas de eventos Rich Media de la pieza.

$RM_COMPLETED_AD

Al escribir dentro del tag de tercero o código del template el texto $RM_COMPLETED_AD, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la métrica Rich Media Anuncio completo (el anuncio finalizó su reproducción)

$RM_START_AD

Al escribir dentro del tag de tercero o código del template el texto $RM_START_AD, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la métrica Rich Media Anuncio encendido (el anuncio comenzó su reproducción)

$RM_PLAY_VIDEO

Al escribir dentro del tag de tercero o código del template el texto $RM_PLAY_VIDEO, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la métrica Rich Media Reproducir video (el video del anuncio comenzó su reproducción)

$RM_STOP_VIDEO

Al escribir dentro del tag de tercero o código del template el texto $RM_STOP_VIDEO, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la métrica Rich Media Detener video (el video del anuncio detuvo su reproducción)

$RM_RESTART_AD

Al escribir dentro del tag de tercero o codigo del template el texto $RM_RESTART_AD, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Reiniciar Anuncio  (El anuncio reinició su reproducción)

$RM_STOP_AUDIO

Al escribir dentro del tag de tercero o codigo del template el texto $RM_STOP_AUDIO, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Detener audio (El audio del anuncio detuvo su reproducción)

$RM_PLAY_AUDIO

Al escribir dentro del tag de tercero o codigo del template el texto $RM_PLAY_AUDIO, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Reproducir audio (El audio del anuncio comenzó su reproducción)

$RM_CLOSE_AD

Al escribir dentro del tag de tercero o codigo del template el texto $RM_CLOSE_AD, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Cerrar anuncio (El anuncio fue cerrado)

$RM_EXPAND_BANNER_AREA

Al escribir dentro del tag de tercero o codigo del template el texto $RM_EXPAND_BANNER_AREA, este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Desplegar un área del banner (El anuncio fue desplegado)

$RM_SHRINK_BANNER_AREA

Al escribir dentro del tag de tercero o codigo del template el texto $RM_SHRINK_BANNER_AREA este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Replegar un área del banner (El anuncio fue replegado)

$RM_DELAYS_IN_VIDEO

Al escribir dentro del tag de tercero o codigo del template el texto $RM_DELAYS_IN_VIDEO este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Anuncio con demoras (Se encontraron demoras en la carga multimedia del anuncio)

$RM_AD_NOT_FOUND

Al escribir dentro del tag de tercero o codigo del template el texto $RM_AD_NOT_FOUND este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Anuncio no encontrado (No se encontró el contenido multimedia del anuncio)

$RM_OPEN_FULL_SCREEN

Al escribir dentro del tag de tercero o codigo del template el texto $RM_OPEN_FULL_SCREEN este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Abrir pantalla completa (El anuncio entró en la modalidad pantalla completa)

$RM_EXIT_FULL_SCREEN

Al escribir dentro del tag de tercero o codigo del template el texto $RM_EXIT_FULL_SCREEN este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Salir de pantalla completa (El anuncio salió de la modalidad pantalla completa)

$RM_SKIP_AD

Al escribir dentro del tag de tercero o codigo del template el texto $RM_SKIP_AD este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Saltear anuncio (El anuncio fue salteado)

$RM_PROGRESS_FIRST_QUARTILE

Al escribir dentro del tag de tercero o codigo del template el texto $RM_PROGRESS_FIRST_QUARTILE este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Primer cuartil (25%) (El anuncio llegó  a reproducir el 25% de su duración total)

$RM_PROGRESS_MIDPOINT

Al escribir dentro del tag de tercero o codigo del template el texto $RM_PROGRESS_MIDPOINT este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Mitad (50%) (El anuncio llegó  a reproducir el 50% de su duración total)

$RM_PROGRESS_THIRD_QUARTILE

Al escribir dentro del tag de tercero o codigo del template el texto $RM_PROGRESS_THIRD_QUARTILE este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Tercer cuartil (75%) (El anuncio llegó  a reproducir el 75% de su duración total)

$RM_CUSTOM_ACTION_<n>

Al escribir dentro del tag de tercero o codigo del template el texto $RM_CUSTOM_ACTION_<n>, siendo <n> un numero entre el 0 y el 9 inclusive,  este texto sera reemplazado automáticamente por una url que al requerirse contabilizara en la pieza la metrica Rich Media Acción custom <n> (El anuncio
efectuo la interacción personalizada enesima). Las acciones personalizadas se utilizan para poder contabilizar eventos de interaccion del usuario en las piezas que no estan contemplados en las metricas Rich Media estandar. Esto permite incorporar a las piezas hasta 10 metricas de eventos adicionales.

Macros disponibles en URL de conteo de impresiones, URL de conteo de Clicks, y URL de  destino

$ad_id

Si dentro de una url de contabilización escribimos el texto $ad_id,al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el id del anuncio que E-Planning le asigno al momento de crearlo.

$campaign_id

Si dentro de una url de contabilización escribimos el texto $campaign_id, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el id de la pauta de E-Planning en la que el anuncio mostrado esta cargado.

$client_ip

Si dentro de una url de contabilización escribimos el texto $client_ip, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por la ip desde donde se solicito la url.

$document_url

Si dentro de una url de contabilización escribimos el texto $document_url, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por la url completa desde donde se solicito la url con la macro al adserver.

$enc_document_url

Si dentro de una url de contabilización escribimos el texto $enc_document_url, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por la url  y  encodeada en codigo URI desde donde se solicito la url con la macro al adserver.

$random

Si dentro de una url de contabilización escribimos el texto $random, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente porun numero aleatorio de 18 decimales entre 0 y 1 que sera diferente cada vez.

$site_id

Si dentro de una url de contabilización escribimos el texto $site_id, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el id del sitio donde se este mostrando. El id es definido en E-Planning al momento de crear el sitio.

$order_id

Si dentro de una url de contabilización escribimos el texto $order_id, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el id de la orden a la que se corresponde la pauta del anuncio. El id es definido en E-Planning al momento de crear la orden.

$space_id

Si dentro de una url de contabilización escribimos el texto $space_id, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el id del espacio donde se este mostrando. El id es definido en E-Planning al momento de crear el espacio.

$uagent

Si dentro de una url de contabilización escribimos el texto $uagent, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el user agent que el explorador del usuario defina, en codigo URI. 

$kw_<keyword>

Si dentro de una url de contabilización escribimos el texto $kw_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que NO sea de tipo tabla de datos, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el valor que esa keyword tiene al solicitarse dicha url.

$enc_kw_<keyword>

Si dentro de una url de contabilización escribimos el texto $enc_kw_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que NO sea de tipo tabla de datos, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el valor que esa keyword tiene al solicitarse dicha url en código URI.

$kwt_<keyword>

Si dentro de una url de contabilización escribimos el texto $kwt_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que sea de tipo tabla de datos, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente porel valor de la tabla de datos correspondiente al indice que esa keyword tiene al solicitarse dicha url.

$enc_kwt_<keyword>

Si dentro de una url de contabilización escribimos el texto $kwt_ seguido inmediatamente por el identificador de una keyword definida en E-Planning que sea de tipo tabla de datos, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente porel valor de la tabla de datos correspondiente al indice que esa keyword tiene al solicitarse dicha url en código URI.

$ccid

Si dentro de una url de contabilización escribimos el texto $ccid, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por un id unico definido por E-Planning que identifica la combinacion anuncio-pauta-espacio.

$nccid

Si dentro de una url de contabilización escribimos el texto $nccid, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por un id personalizado por el usuario que refiera a un valor de ccid. (Id único de E-Planning que identifica la combinación anuncio-pauta-espacio)

$country

Si dentro de una url de contabilización escribimos el texto $country, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el codigo de pais ISO 3166-1 respectivo del país desde donde se solicito la url.

$network

Si dentro de una url de contabilización escribimos el texto $network, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por el nombre del proveedor de servicios (Carrier) que el usuario este utilizando al momento de solicitar la url, en código URI.

$uid

Si dentro de una url de contabilización escribimos el texto $uid, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por un id unico definido por E-Planning que identifica el usuario.

$click_id

Si dentro de una url de contabilización escribimos el texto $click_id, al momento de servirse esta url por el adserver, este texto dentro de la url sera reemplazado automáticamente por un id unico definido por E-Planning que identifica la combinacion usuario-click.

Macros disponibles en pixels de conversión de terceros

$ptv

Si dentro de una url de un pixel de conversion de terceros escribimos el texto $ptv al momento de llamarse esta conversion, este texto dentro de la url sera reemplazado automáticamente por el valor que se haya enviado bajo el parametro ptv en el click asociado a dicha conversion.

Macros disponibles en Anuncios Dinamicos DCO

$PBRAND

Si dentro de una url de un Anuncio Dinamico DCO escribimos $PBRAND, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la marca del producto correspondiente a esa url.

$LC_PBRAND

Si dentro de una url de un Anuncio Dinamico DCO escribimos $LC_PBRAND, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la marca del producto correspondiente a esa url, pero reescrita en minusculas y sin espacios.

$PNAME

Si dentro de una url de un Anuncio Dinamico DCO escribimos $PNAME, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la nombre del producto correspondiente a esa url.

$LC_PNAME

Si dentro de una url de un Anuncio Dinamico DCO escribimos $LC_PNAME, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por el nombre del producto correspondiente a esa url, pero reescrito en minusculas y sin espacios.

$PCATEGORY

Si dentro de una url de un Anuncio Dinámico DCO escribimos $PCATEGORY, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la categoria del producto correspondiente a esa url.

$LC_PCATEGORY

Si dentro de una url de un Anuncio Dinamico DCO escribimos $LC_PCATEGORY, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la categoria del producto correspondiente a esa url, pero reescrito en minusculas y sin espacios.

$PCATEGORY<n>

Si dentro de una url de un Anuncio Dinamico DCO escribimos $PCATEGORY seguido inmediatamente por un numero entero <n>, al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la  subcategoria enesima del producto correspondiente a esa url.

$LC_PCATEGORY<n>

Si dentro de una url de un Anuncio Dinamico DCO escribimos $LC_PCATEGORY seguido inmediatamente por un numero entero <n>, , al momento de mostrarse el anuncio este texto sera reemplazado automáticamente por la subcategoria  enesima del producto correspondiente a esa url, pero reescrito en minusculas y sin espacios.

Contenido