DocumentaciónGuía para desarrolladores de Target

adobe.target.applyOffers(options) - at.js 2.x

Última actualización: 20 de julio de 2024
  • Temas:

Creado para:

  • Desarrollador

Esta función permite aplicar más de una oferta recuperada por adobe.target.getOffers().

NOTA
Esta función se introdujo en at.js 2.x. Esta función no está disponible para la versión 1 de at.js.x.
ClaveTipo¿Requerido?Descripción
selectorCadenaNoElemento HTML o selector de CSS utilizado para identificar el elemento HTML donde Target debería colocar el contenido de la oferta. Si no se proporciona un selector, Target supone que el elemento HTML que se va a utilizar es el HEAD HTML.
RespuestaObjetoSíObjeto de respuesta de getOffers().
Consulte la tabla Solicitudes a continuación.

Respuesta

NOTA
Consulte la documentación de la API de envío para obtener información sobre los tipos aceptables para todos los campos enumerados a continuación.
Nombre del campoDescripción
Respuesta > Captura previa > Vistas > Opciones > ContenidoTenga en cuenta que el contenido de la “opción” no está bien definido y depende directamente del tipo de opción o de la estructura de la plantilla.
Respuesta > Captura previa > Vistas > Opciones > TipoTipo de opción. Refleja el tipo de campo “contenido”. El tipo compatible es acciones.
Respuesta > Captura previa > Vistas > EstadoUn token de estado de vista opaca que debería reenviarse con la notificación de visualización de la vista.
Respuesta > Captura previa > Vistas > Opciones > responseTokensContiene el mapa de responseTokens que se recopiló cuando se estaba procesando la opción actual.
Respuesta > Captura previa > Vistas > Analytics > CargaAnalytics carga para la integración de cliente que debería enviarse a Analytics después de aplicar la vista.
Respuesta > Captura previa > Vistas > SeguimientoEl objeto que contiene todos los datos de seguimiento de la llamada de captura previa por vista.
El objeto de seguimiento también incluye una versión para el seguimiento.
El objeto de seguimiento también incluye detalles de la vista actual.
Respuesta > Captura previa > Vistas > Opciones > eventTokenEl registro de eventos se realiza por opción. Para cada opción aplicada, el token de evento respectivo debe agregarse a la lista de tokens de notificación. Tenga en cuenta que una Vista está compuesta de varias opciones. Si se han aplicado y visto todas las opciones, es necesario incluir todos los eventTokens en la notificación.
Respuesta > Captura previa > Vistas > NombreEl nombre de vista legible en lenguaje natural.
Respuesta > Captura previa > Vistas > MétricasInformes de métricas que deben verse y, a continuación, notificar a Target. Actualmente, solo es compatible la métrica de clic. Si se produce un clic en el elemento, el eventTokens adecuado debe recopilarse y debe enviarse una notificación.
Respuesta > Captura previa > Vistas > ClaveLa clave o huella digital que identifica la vista.
Respuesta > Captura previa > Vistas > IDID de la vista.
Respuesta > Notificaciones > IDID de notificación.
Respuesta > Notificaciones > Eventos > TipoEl tipo de notificación, clic o visualización.
Respuesta > Notificaciones > Eventos > SeguimientoEl seguimiento del evento de notificación.
Respuesta > Notificaciones > Eventos > TokenEl token que se envió con el evento de notificación.
Respuesta > Notificaciones > Eventos > Marca de tiempoLa marca de tiempo que se envió con el evento de notificación.
Respuesta > Notificaciones > Eventos > errorCodeSi la notificación falla, el código indica el motivo del error.
Respuesta > Notificaciones > EventosLos eventos que se registraron o que no se registraron para la notificación actual.
Respuesta > NotificacionesIndica las notificaciones registradas o fallidas.
Respuesta > Ejecutar > mboxes > mbox > SeguimientoEl objeto que contiene todos los datos de seguimiento de la solicitud de mbox individual.
Respuesta > Ejecutar > mboxes > mbox > responseTokensContiene el mapa de responseTokens para la ejecución de una solicitud de mbox específica.
Respuesta > Ejecutar > mboxes > mbox > Opción > ContenidoTenga en cuenta que el contenido de la “opción” no está bien definido y depende directamente del tipo de opción o de la estructura de la plantilla.
Respuesta > Ejecutar > mboxes > mbox > Opción > TipoTipo de opción. Refleja el tipo de campo “contenido”. Los tipos compatibles son: HTML, redireccionamiento, JSON y dinámico.
Respuesta > Ejecutar > mboxes > mbox > OpcionesOpción de respuesta.
Respuesta > Ejecutar > mboxes > mbox > Métricas > eventTokenToken de evento de clic.
Respuesta > Ejecutar > mboxes > mbox > Métricas > Tipo“click”
Respuesta > Ejecutar > mboxes > mbox > MétricasContiene la lista de métricas clickThrough.
Respuesta > Ejecutar > mboxes > mbox > mboxEl nombre del mbox.
Respuesta > Ejecutar > mboxes > mbox > ÍndiceIndica que la respuesta es para mbox con este índice de la solicitud.
Respuesta > Ejecutar > mboxes > mbox > Analytics > CargaAnalytics carga para la integración de cliente que debería enviarse a Analytics después de aplicar el mbox. (Consulte la sección Campañas habilitadas para A4T).
Respuesta > Ejecutar > mboxesLista de mboxes ejecutados.
Respuesta > Ejecutar > pageLoad > Opciones > ContenidoTenga en cuenta que el contenido de la “opción” no está bien definido y depende directamente del tipo de opción o de la estructura de la plantilla.
Respuesta > Ejecutar > pageLoad > Opciones > TipoTipo de opción. Refleja el tipo de campo “contenido”. Los tipos compatibles son: HTML, redireccionamiento, JSON, dinámico y acciones.
Respuesta > Ejecutar > pageLoad > OpcionesOpciones que no se agrupan por vistas (target-global-mbox y opciones de actividades con vistas no agrupadas por vistas).
Respuesta > Ejecutar > pageLoad > MétricasMétricas de clic que no están configuradas para pertenecer a una vista específica.
Respuesta > Ejecutar > pageLoad > SeguimientoEl objeto que contiene todos los datos de seguimiento de la solicitud pageLoad.
Respuesta > Ejecutar > pageLoad > Analytics > CargaAnalytics carga para la integración de cliente que debería enviarse a Analytics después de aplicar el contenido de carga de página. (Consulte la sección Campañas habilitadas para A4T).

Ejemplo de llamada de applyOffers()

adobe.target.applyOffers({response:{
  "execute": {
    "pageLoad": {
      "options": [{
        "type": "html",
        "content": "page-load"
      },
      {
        "type": "actions",
        "content": [{
          "type": "setHtml",
          "content": "<h1>Container 1</h1>",
          "selector": "#container1",
          "cssSelector": "#container1"
        },
        {
          "type": "setHtml",
          "content": "<h3>Container 3</h3>",
          "selector": "#container3",
          "cssSelector": "#container3"
        }]
      }],


      "metrics": [{
        "type": "click",
        "selector": "#container1",
        "eventToken": "page-load-click-metric"
      }]
    }
  }
}});

Llamadas de ejemplo de Promise encadenada con getOffers() y applyOffers(), porque estas funciones están basadas en Promise

adobe.target.getOffers({...})
.then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));

Para obtener más ejemplos sobre cómo usar getOffers(), consulte la documentación de getOffers

Ejemplo de solicitud de carga de página

adobe.target.getOffers({
    request: {
        execute: {
            pageLoad: {}
        }
    }
}).
then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3