Show Menu
TEMAS×

adobe.target.getOffers(options): at.js 2.x

Esta función le permite recuperar varias ofertas pasando varios mboxes. Además, se pueden recuperar varias ofertas para todas las vistas de actividades activas.
Esta función se introdujo en at.js 2.x. Esta función no está disponible para la at.js versión 1. x .
Clave
Tipo
¿Requerido?
Descripción
consumerId
Cadena
No
Si no se proporciona, el valor predeterminado es el mbox global del cliente. Esta clave se utiliza para generar el ID de datos suplementario utilizado para la integración de A4T. Esta clave es una cadena única por visitante.
de eventos
Objeto
Consulte la tabla Solicitudes a continuación.
timeout
Número
No
Tiempo de espera de solicitud. Si no se especifica, se usará el tiempo de espera predeterminado en at.js.

Solicitud

Nombre del campo
¿Requerido?
Limitaciones
Descripción
solicitud > id
No
Uno de tntId , thirdPartyId o marketingCloudVisitorId es obligatorio.
Solicitud > ID > thirdPartyId
No
Tamaño máximo = 128
Solicitud > experiencecloud
No
Solicitud > experiencecloud > analytics
No
Integración de Adobe Analytics
Solicitud > experiencecloud > analytics > registro
No
Se debe implementar lo siguiente en la página:
  • Servicio de ID de visitante
  • Appmeasurement. js
Se admiten los siguientes valores:
client_ side : Cuando se especifique, se devolverá una carga útil de Analytics al llamador que debe utilizarse para enviarse a Adobe Analytics mediante la API de inserción de datos.
server_ side : Este es el valor predeterminado en el que el back-backend de Target y Analytics usará el SDID para unir las llamadas con fines de informes.
Solicitud > Captura previa
No
Solicitud > Captura previa > Vistas
No
Recuento máximo 50
Nombre no en blanco
Longitud del nombre <= 128
Valor de longitud <= 5000
El nombre no debe empezar con “perfil”
Nombres no permitidos: “orderId”, “orderTotal”, “productPurchasedId”
Pase parámetros para utilizarlos para recuperar vistas relevantes en actividades activas.
Solicitud > Captura previa > Vistas > profileParameters
No
Recuento máximo 50
Nombre no en blanco
Longitud de nombre <= 128
Valor de longitud <= 5000
El nombre no debe empezar con “perfil”
Pase parámetros de perfil para utilizarlos para recuperar vistas relevantes en actividades activas.
Solicitud > Captura previa > Vistas > Producto
No
Solicitud > Captura previa > Vistas > Producto > Id.
No
Tamaño máximo
no vacío = 128
Pase los ID de producto para que se utilicen para recuperar vistas relevantes en actividades activas.
Solicitud > Captura previa > Vistas > Producto > categoryId
No
Tamaño máximo
no vacío = 128
Pase los ID de categoría de producto para que se utilicen para recuperar vistas relevantes en las actividades.
Solicitud > Captura previa > Vistas > Pedido
No
Solicitud > Captura previa > Vistas > Pedido > Id.
No
Longitud máxima = 250
Pase los ID de pedido para que se utilicen para recuperar vistas relevantes en actividades activas.
Solicitud > Captura previa > Vistas > Pedido > Total
No
Total >= 0
Pase los totales del pedido para que se utilicen para recuperar vistas relevantes en actividades activas.
Solicitud > Captura previa > Vistas > Pedido > purchasedProductIds
No
Valores no vacíos
Longitud máxima de cada valor 50
Longitud total del ID de producto concatenado y separado por una coma <= 250
Pase los ID de productos comprados para que se utilicen para recuperar vistas relevantes en actividades activas.
Solicitud > Ejecutar
No
Solicitud > Ejecutar > pageLoad
No
Solicitud > Ejecutar > pageLoad > Parámetros
No
Recuento máximo 50
Nombre no en blanco
Longitud del nombre <= 128
Valor de longitud <= 5000
El nombre no debe comenzar con “perfil”.
Nombres no permitidos: “orderId”, “orderTotal”, “productPurchasedId”
Recupere ofertas con parámetros especificados cuando se carga la página.
Solicitar > Ejecutar > pageLoad > profileParameters
No
Recuento máximo 50
Nombre no en blanco
Longitud del nombre <= 128
Valor de longitud <= 256
El nombre no debe comenzar con “perfil”.
Recupere ofertas con parámetros de perfil especificados cuando se carga la página.
Solicitar > Ejecutar > pageLoad > Producto
No
Solicitud > Ejecutar > pageLoad > Producto > Id.
No
Tamaño máximo
no vacío = 128
Recupere ofertas con ID de productos especificadas cuando se carga la página.
Solicitud > Ejecutar > pageLoad > Producto > categoryId
No
Tamaño máximo
no vacío = 128
Recupere ofertas con ID de categoría de productos especificadas cuando se carga la página.
Solicitar > Ejecutar > pageLoad >Pedido
No
Solicitar > Ejecutar > pageLoad > Pedido > ID
No
Longitud máxima = 250
Recupere ofertas con ID de pedidos especificados cuando se carga la página.
Solicitar > Ejecutar > pageLoad > Pedido > Total
No
>= 0
Recupere ofertas con totales de pedidos especificados cuando se carga la página.
Solicitud > Ejecutar > pageLoad > Pedido > purchasedProductIds
No
Valores no vacíos
Longitud máxima de cada valor 50
Longitud total del ID de producto concatenado y separado por una coma <= 250
Recupere ofertas con ID de productos comprados cuando se carga la página.
Solicitud > Ejecutar > mboxes
No
Tamaño máximo = 50
Sin elementos nulos
Solicitud > Ejecutar > mboxes > mbox
Tamaño máximo
Sin sufijo “-clicked”
no vacío = 250
Caracteres permitidos: '-, ._\/=:;&!@#$%^&*()_+|?~[]{}'
Nombre del mbox.
Solicitud > Ejecutar > mboxes > mbox > Índice
Sin
Único
>= 0
Tenga en cuenta que el índice no representa el orden en que se procesarán los mboxes. Al igual que en una página web con varios mboxes regionales, no se puede especificar el orden en que se procesarán.
Solicitud > Ejecutar > mboxes > mbox > Parámetros
No
Recuento máximo = 50
Nombre no en blanco
Longitud del nombre <= 128
Valor de longitud <= 5000
El nombre no debe comenzar con “perfil”.
Nombres no permitidos: “orderId”, “orderTotal”, “productPurchasedId”
Recupere ofertas para un mbox determinado con los parámetros especificados.
Solicitud > Ejecutar > mboxes > mbox > profileParameters
No
Recuento máximo = 50
Nombre no en blanco
Longitud del nombre <= 128
Valor de longitud <= 256
El nombre no debe comenzar con “perfil”.
Recupere ofertas para un mbox determinado con los parámetros de perfil especificados.
Solicitud > Ejecutar > mboxes > mbox > Producto
No
Solicitud > Ejecutar > mboxes > mbox > Producto > ID
No
Tamaño máximo
no vacío = 128
Recupere ofertas para un mbox determinado con los ID de producto especificados.
Solicitud > Ejecutar > mboxes > mbox > Producto > categoryId
No
Tamaño máximo
no vacío = 128
Recupere ofertas para un mbox determinado con los ID de categoría de producto especificados.
Solicitar > Ejecutar > mboxes > mbox > Pedido
No
Solicitud > Ejecutar > mboxes > mbox > Pedido > ID
No
Longitud máxima = 250
Recupere ofertas para un mbox determinado con los ID de pedidos especificados.
Solicitud > Ejecutar > mboxes > mbox > Pedido > Total
No
>= 0
Recupere ofertas para un mbox determinado con los totales de pedidos especificados.
Solicitud > Ejecutar > mboxes > mbox > Pedido > purchasedProductIds
No
Valores no vacíos
Longitud máxima de cada valor = 50
Longitud total de ID de productos concatenados y separados por comas <= 250
Recupere ofertas para un mbox determinado con los ID de pedido especificada del producto comprado.

Llame a getOffers() para todas las vistas

adobe.target.getOffers({
    prefetch: {
      views: []
    }
  }
});

Llame a getOffers() para recuperar las vistas más recientes con los parámetros pasado y de perfil

adobe.target.getOffers({
  request: {
    "prefetch": {
      "views": [
        {
          "parameters": {
            "ad": "1"
          },
          "profileParameters": {
            "age": 23
          }
        }
      ]
    }
  }
});

Llame a getOffers() para recuperar mboxes con parámetros y parámetros de perfil pasados.

adobe.target.getOffers({
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "first-mbox"
        },
        {
          index: 1,
          name: "second-mbox",
          parameters: {
            a: 1
          },
          profileParameters: {
            b: 2
          }
        }
      ]
    }
  }
});

Realice una llamada a getoffers () para recuperar la carga útil de Analytics desde el lado del cliente

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Respuesta :
{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

La carga útil se puede reenviar a Adobe Analytics a través de la API de inserción de datos .

Buscar y procesar datos de varios mboxes a través de getOffers() y applyOffers()

at.js 2.x le permite recuperar varios mboxes a través de la API de getOffers() . También puede buscar datos para varios mboxes y, después, utilizar applyOffers() para representar los datos en diferentes ubicaciones identificadas por un selector de CSS.
El siguiente ejemplo muestra una página HTML sencilla con at.js 2.x implementado:
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>at.js 2.x, multiple selectors and multiple mboxes</title>
  <script src="at.js"></script>
</head>
<body>
  <div id="container1">Default content 1</div>
  
  <div id="container2">Default content 2</div>

  <div id="container3">Default content 3</div>
</body>
</html>

Supongamos que tiene tres contenedores que desea modificar a través del contenido recibido de Target. Puede construir una sola solicitud para tres mboxes en los que cada uno tiene contenido que procesar en su respectivo contenedor.
La solicitud y el código de procesamiento pueden tener el siguiente aspecto:
adobe.target.getOffers({
  request: {
    prefetch: {
      mboxes: [
        {
          index: 0,
          name: "mbox1"
        },
        {
          index: 1,
          name: "mbox2"
        },
        {
          index: 2,
          name: "mbox3"
        }
      ]
    }
  }
})
.then(response => {
  // get all mboxes from response
  const mboxes = response.prefetch.mboxes;
  let count = 1;

  mboxes.forEach(el => {
    adobe.target.applyOffers({
      selector: "#container" + count,
      response: {
        prefetch: {
          mboxes: [el]
        }
      }
    });

    count += 1;
  });
});

En la sección request > prefetch > mboxes , hay tres mboxes diferentes. Si la solicitud se completó correctamente, recibe la respuesta de response > prefetch > mboxes para cada mbox. Una vez que tenga las respuestas y las ubicaciones que desee utilizar para la representación, puede invocar a applyOffers() para representar el contenido obtenido de Target. En este ejemplo tenemos la siguiente asignación:
  • mbox 1 > selector CSS #contenedor 1
  • mbox 2 > selector CSS #contenedor 2
  • mbox 3 > selector CSS #contenedor 3
Este ejemplo utiliza la variable de recuento para construir los selectores CSS. En una situación real, podría utilizar una asignación diferente entre el selector CSS y el mbox.
Tenga en cuenta que este ejemplo utiliza prefetch > mboxes , pero también puede utilizar execute > mboxes . Asegúrese de que, si utiliza la crga previa en getOffers() , también debe utilizar la carga previa en la invocación de applyOffers() .