Salidas de macros de Studio

Objetivo

Inserte información/macros de Studio en la URL de salida.

Solución

Existen dos maneras de añadir información de Studio, como un ID de anuncio, a un anuncio:

• Utilizar macros de Studio en la URL de destino en la interfaz de usuario web de Studio

• Utilizar la API de Studio para obtener información de Studio, de modo que se compila una cadena de consulta o una URL completa en el código de creatividad. Después, se debe utilizar el método Enabler.exitQueryString(id, queryString).

Cuando utilice URL de salida dinámicas, la página de destino puede redireccionar a una URL diferente. Esto no lo controla Studio, sino el servidor de la página de destino.

Configurar

Antes de añadir macros de Studio a las salidas, consulte la información que se muestra en el siguiente cuadro sobre las macros disponibles y las llamadas de la API de Studio equivalentes: Si desea añadir parámetros de Studio a una URL de salida, asegúrese de que existe un método API de Studio correspondiente. Si no existe, no podrá insertar la información de Studio en la URL de salida.

Macros compatibles con Studio

Macro	Método de API de Studio	Parámetro de servidor de anuncios de Studio
%eadv!	Enabler.getParameter("adv");	ID de anunciante
%eaid!	Enabler.getDartAdId();	ID del anuncio
%ebuy!	Enabler.getParameter(“buy”);	ID de campaña
%ecid!	Enabler.getDartCreativeId();	ID de creatividad
%epid!	Enabler.getDartPageId();	ID de ubicación
%erid!	Enabler.getDartRenderingId();	ID de renderizado
%esid!	Enabler.getDartSiteId();	ID del sitio
%n	Ninguna API disponible	la prevención de almacenamiento en memoria caché,
%p	Ninguna API disponible	Coincidencia de patrones
%s	Enabler.getDartSiteName();	Nombre de sitio web

 

La información de Studio solo está disponible cuando la creatividad se publica en una etiqueta activa. Las macros de Studio devuelven 0 o valores de macro sin resolver cuando se obtiene una vista previa en Studio. Los métodos equivalentes de la API de Studio devuelven 0, nulo o "" cuando se obtiene una vista previa en Studio o se hacen pruebas locales.

Si la creatividad obtiene URL de salida de una fuente externa (XML o JSON) y las URL contienen valores de macro de Studio, debe sustituir los valores de macro del anuncio con los métodos de API de Studio correspondientes mediante la lógica de sustitución de cadena en el código de la creatividad. Utilice la tabla que aparece anteriormente para consultar qué macro corresponde a qué método de la API de Studio. No codifique valores fijos de macro de Studio en el código fuente de la creatividad.

Si se codifican valores de macro de Studio, estos valores nunca se sustituirán con los parámetros del servidor de anuncios de Studio correspondientes en una etiqueta activa. Además, si los valores de macro de Studio se codifican, existirá la posibilidad de que la URL active un bloqueador de ventanas emergentes en los navegadores Internet Explorer cuando un usuario haga clic a través de la creatividad. Las URL de salida codificadas en la creatividad no se pueden sobrescribir en la interfaz de usuario web de Studio ni en DCM.

Ejemplo

Utilizar macros de Studio en la URL de destino en Studio

Pegue la URL de la página de destino que contiene los datos de la macro de Studio en el campo URL de destino de la pestaña Eventos > Salidas de Studio.

URL de redireccionamiento de terceros de muestra
Las macros se muestran resaltadas en rojo en este ejemplo.

http://yourdomain.com/clk?aAgencyId=01&aSource=adsrv&aTrackDataExt=
123456;%epid!;%eaid!;%ecid!&migRandom=%n&aTrackFmtExt=client;io;ad;crtv&
aUnencodedDest=http://yourdomain.com

Utilizar parámetros de Studio en el código de la creatividad y, a continuación, introducir la URL base en Studio

1. En lugar de utilizar el método Enabler.exit() en su código, sustituya la salida a la que desea añadir parámetros por Enabler.exitQueryString(). Este método le permitirá establecer una URL base en Studio y añadir parámetros a dicha URL base en el código de la creatividad.
2. Añada los métodos de API de Studio que correspondan a cada uno de los parámetros de Studio en el segundo parámetro del método exitQueryString. Los métodos disponibles se indican en el SDK de HTML5 de Studio (busque la página de “getDart” para ir directamente a la lista). Este ejemplo corresponde a un código JavaScript para creatividades HTML5:

   
   var adIdVar = Enabler.getDartAdId();
   var siteIdVar = Enabler.getDartSiteId();
   
   function exitHandler() {
     Enabler.exitQueryString("my exit", "adid=" + adIdVar + "&siteid=" + siteIdVar);
   }
   
   exitBtn.addEventListener('click', exitHandler, false);

3. Añada la URL base en el campo URL de destino en la pestaña Eventos > Salidas.

   Por ejemplo, si se emplea http://yourdomain.com/ como la URL base, la URL resultante en la que haga clic en anuncio podría ser como la siguiente cuando el anuncio se encuentra en una etiqueta activa:
   
   http://yourdomain.com/?adid=123456789&siteid=12345