Implementación Target sin un administrador de etiquetas

Información sobre la implementación Adobe Target sin usar un administrador de etiquetas o etiquetas en Adobe Experience Platform.

NOTE
Etiquetas en Adobe Experience Platform son el método preferido para implementar Target y la biblioteca at.js. La siguiente información no es aplicable cuando se utilizan etiquetas en Adobe Experience Platform para implementar Target.

Para acceder a la página Implementación, haga clic en Administration > Implementación.

Puede especificar la siguiente configuración en esta página:

  • Detalles de cuenta
  • Métodos de implementación
  • API de perfil
  • Herramientas de depuración
  • Privacidad
NOTE
En lugar de definir la configuración en la biblioteca at.js de, puede anular la configuración de Target IU Standard/Premium o mediante las API de REST. Para obtener más información, consulte targetGlobalSettings().

Detalles de cuenta

Puede ver los siguientes detalles de la cuenta. Esta configuración no se puede cambiar.

Configuración
Descripción
Código de cliente
El código de cliente es una secuencia de caracteres específica del cliente que a menudo se requiere al usar las API de Target.
ID de organización de IMS
Este ID vincula la implementación con su cuenta de Adobe Experience Cloud.
Toma de decisiones en el dispositivo

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.

Incluya todas las actividades cualificadas de toma de decisiones en el dispositivo existentes en el artefacto

(Condicional) Esta opción se muestra si habilita la toma de decisiones en el dispositivo.

Deslice el botón de alternancia a la posición "Activado" si desea que todos los elementos activos Target actividades que cumplen los requisitos para que la toma de decisiones en el dispositivo se incluya 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

NOTE
Esta configuración se aplica a todos los Target Bibliotecas .js. Después de realizar cambios en la sección Métodos de implementación, debe descargar la biblioteca y actualizarla en la implementación.
Configuración
Descripción
Carga de página habilitada (mBox global de Auto-Create)
Seleccione si quiere incrustar la llamada de mbox global en el archivo at.js para que se active automáticamente cada vez que se cargue la página.
Mbox 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.

Tiempo de espera (segundos)

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 de at.js utiliza la configuración de tiempo de espera de XMLHttpRequest. El tiempo de espera empieza cuando una solicitud se activa y se detiene cuando Target obtiene una respuesta del servidor. Para obtener más información, consulte XMLHttpRequest.timeout en la red de desarrolladores de Mozilla.

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 la actividad, ya que la recopilación de datos se realizará a partir del límite 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: Las características de visitorApiTimeout garantizan que Target no tenga que esperar 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í.

Duración del perfil

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 modificar la opción Duración del perfil, póngase en contacto con Client Care.

Método de implementación principal

NOTE
Adobe Target admite at.js 1.x y at.js 2.x. Actualice a la actualización más reciente de cualquiera de las versiones principales de at.js para asegurarse de que dispone de una versión compatible.

Para descargar la versión de at.js que desee, haga clic en la Descargar botón.

Para editar la configuración de at.js, haga clic en Editar junto a la versión de at.js que desee.

WARNING
Antes de cambiar esta configuración predeterminada, consulte con Atención al cliente para que no afecte a su implementación actual.

Además de la configuración explicada anteriormente, también está disponible la siguiente configuración específica de at.js:

Configuración
Descripción
Entre Dominios
Para at.js v1.x, especifique si las capacidades entre dominios son 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 ambos, seleccionando enabled (los exploradores establecen cookies de origen y de terceros). En la versión 2.10 y posteriores de at.js, especifique si las capacidades entre dominios son enabled (los exploradores establecen cookies de origen y de terceros) o disabled (los exploradores no establecen cookies de terceros).
Encabezado de biblioteca personalizado
Añada código de JavaScript personalizado para incluirlo en la parte superior de la biblioteca.
Pie de biblioteca personalizado
Añada código de JavaScript personalizado para incluirlo en la parte inferior de la biblioteca.

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 API de perfil.

Herramientas de depuración

Generar un token de autorización para utilizar la función avanzada Target herramientas de depuración. Clic Generar nuevo token de autenticación.

Generar nuevo token de autenticación

Privacidad

Esta configuración le permite utilizar 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.

NOTE
La opción Compatibilidad con navegadores anteriores estaba disponible en la versión 0.9.3 (y anteriores) de at.js. Esta opción se ha eliminado de la versión 0.9.4 de at.js. Para saber cuáles con los exploradores compatibles con at.js, consulte Exploradores compatibles
Los navegadores anteriores son navegadores más viejos que no admiten completamente CORS (Uso compartido de recursos de origen cruzado). Algunos de estos navegadores son: Internet Explorer antes de la versión 11 y Safari versión 6 y anteriores. Si se ha desactivado Compatibilidad con navegadores anteriores, Target no entregó contenido ni contó visitantes en informes en estos navegadores. Si esta opción estaba habilitada, se recomienda realizar el control de calidad en los exploradores más antiguos para garantizar una buena experiencia del cliente.

Descargar at.js

Instrucciones para descargar la biblioteca utilizando Target o la API de descarga.

NOTE
Adobe Experience Platform es el método preferido para implementar Target y la biblioteca at.js. La siguiente información no es aplicable cuando se utilizan etiquetas en Adobe Experience Platform para implementar Target.
Adobe Target admite at.js 1.x y at.js 2.x. Actualice a la actualización más reciente de cualquiera de las versiones principales de at.js para asegurarse de que dispone de una versión compatible. Para obtener información detallada sobre los cambios en cada versión de at.js, consulte Detalles de las versiones de at.js.

Descargue at.js con el Target interfaz

Para descargar at.js desde Target interfaz:

  1. Haga clic en Administración > Implementación.
  2. En la sección Implementation Methods, haga clic en Descargar junto a la versión de at.js que desee.

Descargue at.js con el Target API de descarga

Para descargar at.js con la API

  1. Obtenga el código de cliente.

    El código de cliente se encuentra disponible en la parte superior de la Administration > Implementación página de la Target interfaz.

  2. 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>
    

    Reemplazar 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.

  3. Descargar at.js.

    Cargue esta dirección URL con la siguiente estructura. Al cargar esta dirección 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>
    
    • Reemplazar admin number con su número de administrador.
    • Reemplazar client code con el código de cliente del paso 1.
    • Reemplazar version number con el número de versión de at.js deseado (por ejemplo, 2.2).
WARNING
El Target Team mantiene solo dos versiones de at.js: la actual y la penúltima. Actualice at.js cuando sea posible para garantizar que dispone de una versión compatible. Para obtener información detallada sobre los cambios en cada versión de at.js, consulte Detalles de las versiones de at.js.

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 no usar un administrador de etiquetas, como 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:

  • Doctype de HTML5 (por ejemplo, <!doctype html>) debe utilizarse. Los tipos de documento no compatibles o más antiguos podrían dar como resultado Target no poder 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 utiliza estas configuraciones, asegúrese de reemplazar <client code> con su propio código de cliente, que puede obtener de Administration > Implementación página.
  • 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 personalización.
  • Especial Target funciones, como targetPageParams(), targetPageParamsAll(), proveedores de datos y targetGlobalSettings() debe definirse después de la capa de datos y antes de que at.js cargue. 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 que Target para que pueda utilizar su sintaxis y sus métodos al crear Target experiencias.
  • 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”.

NOTE
Si los usuarios realizan compras en su sitio web, Adobe recomienda implementar un mbox de confirmación de pedido aunque use Analytics para Target (A4T) para sus informes.
  1. En la página de detalles del pedido, inserte el script de mbox siguiendo el modelo que aparece a continuación.

  2. 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>
    
NOTE
En el mbox de confirmación de pedido, utilice la delimitación por comas para separar varios ID de producto.

El mbox de confirmación de pedido utiliza los siguientes parámetros:

Parámetro
Descripción
orderId

Valor único para identificar un pedido de recuento de conversión.

El orderId debe ser único. Los pedidos duplicados se ignoran en los informes.

orderTotal

Valor monetario de la compra.

No pase el símbolo de moneda. Use un punto (no una coma) para indicar valores decimales.

productPurchasedId (opcional)

Lista de ID de productos comprados en el pedido, separados por comas.

Estos ID de productos se muestran en el informe de auditoría para admitir un análisis de informe adicional.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3