Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Esta página contiene una página web de ejemplo que muestra cómo se pueden implementar las funciones de etiqueta de vendedor (AST) de Microsoft Advertising en el encabezado y el cuerpo de una página de cliente de ejemplo.
Nota:
Como parte de nuestra transición continua para mejorar el rendimiento y alinearnos con los servicios de Microsoft, estamos migrando el producto AST de Xandr CDN a Microsoft CDN.
Este cambio garantiza que sigue recibiendo actualizaciones críticas, incluido el cumplimiento de estándares de privacidad en constante evolución, como las directivas de Fledge y CMP.
Para asegurarse de que recibe las actualizaciones y mejoras más recientes del producto AST, incluidas las características de privacidad esenciales, siga estos pasos para actualizar las páginas web con las nuevas direcciones URL de Microsoft CDN:
- Dominio normal:https://adsdk.microsoft.com/ast/ast.js
- Dominio sin cookies:https://adsdk.bing.net/ast/ast.js
Si usa una directiva de seguridad de contenido (CSP), asegúrese de que se agregan los siguientes dominios a la lista de permitidos:
adsdk.microsoft.com
-
adsdk.bing.net
(si procede)
Para obtener más información, consulte la Referencia de api de AST.
Importante
Más allá del cambio de red CDN, hemos actualizado recientemente el código de instalación de ejemplo que carga el ast.js
archivo. Ahora se recomienda incluir una crossOrigin
propiedad en el elemento de script que carga la biblioteca de JavaScript. Le rogamos que incluya este código adicional para ayudar a AST a capturar errores del lado cliente relacionados con el script de AST.
Paso 1: Crear el objeto APN y cargar la biblioteca de JavaScript de Xandr
En la línea 5, configuramos un objeto AST vacío. En la línea 7, creamos una cola de funciones en ese objeto que nos permite insertar funciones en esa cola con la información sobre las etiquetas y poder solicitar ofertas desde el servidor de anuncios Xandr. En las líneas 10 a 15, cargamos de forma asincrónica la biblioteca de subastas del lado cliente desde la red CDN de Xandr. Si el script existe, lo procesamos; De lo contrario, se coloca en la cola.
Nota:
Este código se puede pegar directamente en la página web; no se requieren cambios adicionales para desarrolladores. Puede separar el código en head
y body
como se muestra a continuación o, si no tiene acceso a la página head
, puede colocar la etiqueta completa en un bloque de código en .body
Advertencia
La implementación de la etiqueta de AST en un archivo Javascript externo u otras personalizaciones para la implementación de este código podría dar lugar a resultados no deseados o a la pérdida de funcionalidad, y requerirá la acción del cliente para probar y usar características en futuras versiones de AST. Es posible que Xandr no pueda solucionar problemas o soporte técnico en esta instancia.
<html>
<head>
<script type="text/javascript">
//create empty apntag object if it doesn't exist
var apntag = apntag || {};
//create a queue on the apntag object
apntag.anq = apntag.anq || [];
//load ast.js - async
(function() {
var d = document, e = d.createElement('script'), p = d.getElementsByTagName('head')[0];
e.type = 'text/javascript'; e.async = true;
e.crossOrigin = 'anonymous';
e.src = 'https://adsdk.microsoft.com/ast/ast.js';
p.insertBefore(e, p.firstChild);
})();
Paso 2: Establecer opciones de página globales
Ahora se establecen las opciones de página globales con la setPageOpts
función . Aquí, establecemos el identificador de miembro en 958
y definimos los parámetros de destino de toda la página.
member
es necesario en o setPageOpts
defineTag
(vea a continuación). En este ejemplo se usa la edad y el género.
//push commands to loading queue, to allow for async loading
apntag.anq.push(function() {
//set global page options
apntag.setPageOpts({
member: 958,
keywords: {
'artist': 'Prince',
'genre': ['rock', 'pop']
},
user: {
age: 26,
gender: 1
}
});
Paso 3: Definir etiquetas de anuncios
A continuación, definimos todas las ubicaciones de anuncios que queremos en esta página mediante la defineTag
función . Aquí se especifica lo siguiente para cada ubicación:
member
: puede invalidar la opción de página global con el identificador de miembro para esta ubicación (opcional; debe estar presente si no se especifica ensetPageOpts
)invCode
: el código de selección de ubicación de esta ubicación. (invCode
OtagId
obligatorio)tagId
: el identificador de selección de ubicación de esta ubicación (invCode
OtagId
obligatorio)sizes
: si usa varios tamaños, el primer elemento de la lista es el tamaño de ubicación y otros tamaños son tamaños de promoción.targetId
: cualquier cadena única; debe corresponder a un identificador únicodiv
en el cuerpo de la página.Otras opciones disponibles; consulte la referencia de la API de AST.
//define ad tags apntag.defineTag({ invCode: 'ABC1234', sizes: [728,90], targetId: 'apn_ad_slot_1' }); apntag.defineTag({ tagId: 123456, sizes: [[300,250],[300,600]], targetId: 'apn_ad_slot_2' });
Paso 4: Cargar etiquetas
En cuanto se definan todas las etiquetas, llame a la loadTags
función . Esta función envía solicitudes de anuncios para las etiquetas de una llamada de anuncio de forma asincrónica.
//start loading tags
apntag.loadTags();
});
</script>
</head>
Paso 5: Definir la ubicación de las ubicaciones
En el cuerpo de la página, especifique la ubicación de cada ubicación mediante div
etiquetas que corresponden a los targetId
elementos de cada una de las defineTag
llamadas. Use la showTag
función para indicar que la ubicación está lista para recibir un anuncio. Una vez llamada a esta función, la impresión se marcará como transacda y se considerará una "impresión" con fines contables.
Nota:
AST administra todos los elementos DOM dentro de la etiqueta de marcador de posición div
de anuncio mediante programación. Dado que estos elementos pueden cambiar, no acceda directamente a ninguno de los elementos; use solo las funciones de AST integradas, como refresh
. Acceder directamente a estos elementos puede dar lugar a un comportamiento inesperado, como anuncios que aparecen en la ubicación incorrecta de la página, anuncios duplicados o espacios en blanco.
<body>
<div id='apn_ad_slot_1'>
<script type="text/javascript">
apntag.anq.push(function() {
//signal to script that this DOM element has been loaded and is ready to be populated with an ad
apntag.showTag('apn_ad_slot_1');
});
</script>
</div>
<br>
<div id='apn_ad_slot_2'>
<script type="text/javascript">
apntag.anq.push(function() {
apntag.showTag('apn_ad_slot_2');
});
</script>
</div>
</body>
</html>