Implementar Target sin un administrador de etiquetas
Información acerca de la implementación de Adobe Target sin usar un administrador de etiquetas o etiquetas en Adobe Experience Platform.
Para acceder a la página Implementación, haga clic en Administration > Implementation.
Puede especificar la siguiente configuración en esta página:
- Detalles de la cuenta
- Métodos de implementación
- API de perfil
- Herramientas de depuración
- Privacidad
Detalles de la cuenta
Puede ver los siguientes detalles de la cuenta. Esta configuración no se puede cambiar.
Para habilitar la toma de decisiones en el dispositivo, deslice el conmutador a la posición "activado".
La toma de decisiones en el dispositivo le permite almacenar en caché sus campañas A/B y de segmentación de experiencias (XT) en su servidor y realizar la toma de decisiones en memoria con una latencia cercana a cero. Para obtener más información, consulte Introducción a la toma de decisiones en el dispositivo.
(Condicional) Esta opción se muestra si habilita la toma de decisiones en el dispositivo.
Deslice el conmutador a la posición "Activado" si desea que todas sus actividades activas de Target que cumplen los requisitos para la toma de decisiones en el dispositivo se incluyan automáticamente en el artefacto.
Si deja esta opción desactivada, debe volver a crear y activar cualquier actividad de toma de decisiones en el dispositivo para que se incluya en el artefacto de reglas generadas.
Métodos de implementación
En el panel Métodos de implementación se pueden configurar los siguientes ajustes:
Configuración global
Seleccione un nombre para el mbox global. De forma predeterminada, este nombre es target-global-mbox.
Pueden utilizarse caracteres especiales, incluido el símbolo &, en los nombres de mbox con at.js.
Si Target no responde con contenido dentro del periodo definido, se agota el tiempo de espera de la llamada del servidor y se muestra el contenido predeterminado. Se siguen realizando llamadas adicionales durante la sesión del visitante. El valor predeterminado es de 5 segundos.
La biblioteca at.js utiliza la configuración de tiempo de espera de XMLHttpRequest
. El tiempo de espera comienza cuando se activa la solicitud y se detiene cuando Target obtiene una respuesta del servidor. Para obtener más información, consulte XMLHttpRequest.timeout en Mozilla Developer Network.
Si el tiempo de espera especificado se agota antes de recibir una respuesta, se mostrará el contenido predeterminado y el visitante se podrá contar como un participante de una actividad, ya que la recopilación de datos se realizará en el perímetro de Target. Si la solicitud alcanza el límite de Target, se contará al visitante.
Considere los siguientes puntos a la hora de configurar el tiempo de espera:
- Si el valor es demasiado bajo, los usuarios podrían ver el contenido predeterminado la mayor parte del tiempo, aunque se cuente al visitante como un participante de la actividad.
- Si el valor es demasiado alto, los visitantes podrían ver áreas negras en la página web o páginas en blanco si oculta el cuerpo durante periodos muy largos.
Para comprender mejor cómo funcionan los tiempos de respuesta de mbox, consulte la ficha Red en las herramientas para desarrolladores de su navegador. También puede utilizar herramientas de supervisión del rendimiento web de terceros, como Catchpoint.
Nota: La configuración de visitorApiTimeout garantiza que Target no espere a la respuesta de la API del visitante durante demasiado tiempo. Esta configuración y la configuración Tiempo de espera para at.js descrita no se afectan entre sí.
Esta opción determina durante cuánto tiempo se almacenan los perfiles de los visitantes. De forma predeterminada, los perfiles se almacenan durante dos semanas. Esta configuración se puede aumentar hasta 90 días.
Para cambiar la configuración de Duración del perfil, comuníquese con Atención al cliente.
Método de implementación principal
Para descargar la versión de at.js que desee, haga clic en el botón Descargar correspondiente.
Para editar la configuración de at.js, haga clic en Edit junto a la versión de at.js que desee.
Además de la configuración explicada anteriormente, también está disponible la siguiente configuración específica de at.js:
disabled
(los exploradores establecen cookies solo en su dominio (cookies de origen), x only
(los exploradores establecen cookies solo en el dominio de Target) o ambas, seleccionando enabled
(los exploradores establecen cookies de origen y de terceros). En at.js v2.10 y versiones posteriores, especifique si las funcionalidades entre dominios son enabled
(los exploradores establecen cookies de origen y de terceros) o disabled
(los exploradores no establecen cookies de terceros).API de perfil
Habilite o deshabilite la autenticación para actualizaciones en lote mediante API y genere un token de autenticación de perfil.
Para obtener más información, consulte Configuración de la API del perfil.
Herramientas de depuración
Genere un token de autorización para usar las herramientas de depuración avanzadas Target. Haga clic en Generate New Authentication Token.
Privacidad
Esta configuración le permite usar Target de conformidad con las leyes aplicables sobre privacidad de datos.
Elija la configuración que desee en la lista desplegable Proteger dirección IP del visitante:
- Ofuscación del último octeto
- Confusión de IP completa
- Ninguna
Para obtener más información, consulte Privacidad.
Descargar at.js
Instrucciones para descargar la biblioteca mediante la interfaz Target o la API de descarga.
Descargar at.js mediante la interfaz Target
Para descargar at.js desde la interfaz Target:
- Haga clic en Administration > Implementation.
- En la sección Métodos de implementación, haga clic en el botón Download junto a la versión de at.js que desee.
Descargar at.js mediante la API de descarga de Target
Para descargar at.js mediante la API de.
-
Obtenga el código de cliente.
Su código de cliente está disponible en la parte superior de la página Administration > Implementation de la interfaz Target.
-
Obtenga su número de administrador.
Cargue esta dirección URL:
code language-none https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
Reemplace
client code
con el código de cliente del paso 1.El resultado de cargar esta dirección URL debería parecerse al siguiente ejemplo:
code language-none { "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" }
En este ejemplo, “6” es el número del administrador.
-
Descargar at.js.
Cargue esta dirección URL con la siguiente estructura. Al cargar esta URL, se inicia la descarga del archivo at.js personalizado.
code language-none https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
- Reemplace
admin number
con su número de administrador. - Reemplace
client code
con el código de cliente del paso 1. - Reemplace
version number
por el número de versión de at.js deseado (por ejemplo, 2.2).
- Reemplace
Implementación de at.js
at.js debe implementarse en el elemento <head>
de cada página de su sitio web.
Una implementación típica de Target que no usa un administrador de etiquetas, como las etiquetas en Adobe Experience Platform, tiene este aspecto:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Title of the Page</title>
<!--Preconnect and DNS-Prefetch to improve page load time-->
<link rel="preconnect" href="//<client code>.tt.omtrdc.net">
<link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
<!--/Preconnect and DNS-Prefetch-->
<!--Data Layer to enable rich data collection and targeting-->
<script>
var digitalData = {
"page": {
"pageInfo": {
"pageName": "Home"
}
}
};
</script>
<!--/Data Layer-->
<!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
<script>
targetPageParams = function() {
return {
"a": 1,
"b": 2,
"pageName": digitalData.page.pageInfo.pageName,
"profile": {
"age": 26,
"country": {
"city": "San Francisco"
}
}
};
};
</script>
<!--/targetPageParams()-->
<!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
<script src="jquery-3.3.1.min.js"></script>
<!--/jQuery-->
<!--Target's JavaScript SDK, at.js-->
<script src="at.js"></script>
<!--/at.js-->
</head>
<body>
The default content of the page
</body>
</html>
Tenga en cuenta las siguientes notas importantes:
- Debe usarse el tipo de documento HTML5 (por ejemplo,
<!doctype html>
). Los tipos de documento no admitidos o anteriores podrían ocasionar que Target no pueda realizar una solicitud. - Conexión previa y Recuperación previa son opciones que pueden ayudar a que sus páginas web se carguen más rápido. Si usa estas configuraciones, asegúrese de reemplazar
<client code>
por su propio código de cliente, que puede obtener de la página Administration > Implementation. - Si tiene una capa de datos es óptimo definir la mayor cantidad posible en el
<head>
de sus páginas antes de que se cargue at.js. Esta ubicación proporciona la máxima capacidad para utilizar esta información en Target para la personalización. - Las funciones especiales de Target, como
targetPageParams()
,targetPageParamsAll()
, proveedores de datos ytargetGlobalSettings()
deben definirse después de la capa de datos y antes de que se cargue at.js. Alternativamente, estas funciones podrían guardarse en la sección Encabezado de biblioteca de la página Editar configuración de at.js y guardarse como parte de la propia biblioteca de at.js. Para obtener más información sobre estas funciones, consulte funciones de at.js. - Si usa las bibliotecas de ayuda de JavaScript, como jQuery, inclúyalas antes de Target para poder usar su sintaxis y sus métodos al crear experiencias de Target.
- Incluya at.js en el
<head>
de sus páginas.
Seguimiento de conversiones
El mbox de confirmación de pedido registra los detalles de los pedidos que se realizan en su sitio web y permite generar informes según los ingresos y los pedidos. El mbox de confirmación de pedido también puede realizar algoritmos de recomendaciones, como “Las personas que compraron el producto X también han comprado el producto Y”.
-
En la página de detalles del pedido, inserte el script de mbox siguiendo el modelo que aparece a continuación.
-
Reemplace las PALABRAS EN MAYÚSCULAS por valores dinámicos o estáticos del catálogo.
note tip TIP También puede pasar información de pedidos a cualquier mbox (no necesita llamarse orderConfirmPage
). De igual modo, es posible pasar información de pedido a varios mbox dentro de la misma campaña.code language-none <script type="text/javascript"> adobe.target.trackEvent({ "mbox": "orderConfirmPage", "params":{ "orderId": "ORDER ID FROM YOUR ORDER PAGE", "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE", "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3" } }); </script>
El mbox de confirmación de pedido utiliza los siguientes parámetros:
Valor único para identificar un pedido de recuento de conversión.
El orderId
debe ser único. Los pedidos duplicados se ignoran en los informes.
Valor monetario de la compra.
No pase el símbolo de moneda. Use un punto (no una coma) para indicar valores decimales.
Lista de ID de productos comprados en el pedido, separados por comas.
Estos ID de producto se muestran en el informe de auditoría para admitir análisis de informes adicionales.