DocumentaciónGuía para desarrolladores de Target

adobe.target.sendNotifications(options)

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

Creado para:

  • Desarrollador

Esta función envía una notificación a Target edge cuando se procesa una experiencia sin usar adobe.target.applyOffer() o adobe.target.applyOffers().

NOTA
Esta función se ha introducido en at.js 2.1.0 y estará disponible para todas las versiones posteriores a 2.1.0.
ClaveTipo¿Requerido?Descripción
consumerIdCadenaNoSi 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.
SolicitudObjetoSíConsulte la tabla Solicitudes a continuación.
timeoutNúmeroNoTiempo de espera de la solicitud. Si no se especifica, se usará el tiempo de espera predeterminado en at.js.

Solicitud

Nombre del campoTipo¿Requerido?LimitaciónDescripción
Request > notificationsMatriz de objetosSíNotificaciones para el contenido mostrado, selectores en los que se hizo clic y/o vistas o mboxes visitados.
Request > notifications > addressObjetoNo
Request > notifications > address > urlCadenaNoURL desde la cual se activó la notificación.
Request > notifications > address > referringUrlCadenaNoDirección URL de referencia desde la que se activó la notificación.
Request > notifications > parametersCadenaNo

Los parámetros siguientes no están permitidos en los parámetros:

  • orderId
  • orderTotal
  • productPurchasedIds

Tenga en cuenta lo siguiente:

  • Límite máximo de 50 parámetros.
  • El nombre del parámetro no debe estar en blanco.
  • Longitud máxima del parámetro 128.
  • El nombre del parámetro no debe comenzar con “perfil”.
  • Longitud máxima del valor del parámetro 5000.
Request > notifications > profileParametersCadenaNo

Los parámetros siguientes no están permitidos en los parámetros:

  • orderId
  • orderTotal
  • productPurchasedIds

Tenga en cuenta lo siguiente:

  • Límite máximo de 50 parámetros.
  • El nombre del parámetro no debe estar en blanco.
  • Longitud máxima del parámetro 128.
  • El nombre del parámetro no debe comenzar con “perfil”.
  • Longitud máxima del valor del parámetro 5000.
Request > notifications > orderObjetoNoObjeto que describe los detalles del pedido.

Request > notifications > order

id

CadenaNo<= 250 caracteres.ID de pedido.

Request > notifications > order

total

CadenaNo>= 0Total de pedido.

Request > notifications > order

purchasedProductIds

Matriz de cadenaNo
  • No se permiten valores en blanco.
  • La longitud máxima de la ID de producto es 50.
  • Los ID de producto, separados por comas y concatenados, no deben superar los 250.
Ordenar ID de productos.
Request > notifications > productObjetoNo
Request > notifications > product > idCadenaNo<= 128 caracteres; no puede estar en blanco.ID del producto.
Request > notifications > product > categoryIdCadenaNo<= 128 caracteres; no puede estar en blanco.ID de categoría.
Request > notifications > idCadenaSí<= 200 caracteres.La ID de notificación se devolverá en respuesta e indicará que la notificación se ha procesado correctamente.
Request > notifications > impressionIdCadenaNo<= 128 caracteres.La ID de impresión se utiliza para unir (vincular) la notificación actual con una notificación anterior o ejecutar la solicitud. Si ambas coinciden, la segunda y las demás solicitudes posteriores no generarán una impresión nueva para la actividad o experiencia.
Solicitud > notificaciones > tipoCadenaSíSe admite "clic" o "visualización".Tipo de notificación.
Request > notifications > timestampNúmero<int64>SíMarca de tiempo de la notificación en milisegundos transcurridos desde UNIX epoch.
Request > notifications > tokensMatriz de cadenaSíLista de tokens para el contenido mostrado o selectores en los que se hizo clic, según el tipo de notificación.
Request > notifications > mboxObjetoNoNotificaciones para el mbox.

Request > notifications > mbox

name

CadenaNo

No se permiten valores en blanco.

Caracteres permitidos: Consulte la nota que sigue esta tabla.

nombre de mbox.

Request > notifications > mbox

state

CadenaNoToken de estado de mbox.
Request > notifications > viewObjetoNo

Request > notifications > view

id

Número entero <int64>NoVer id. ID que se asignó a la vista cuando la vista se creó mediante la API de visualización.

Request > notifications > view

name

CadenaNo<= 128 caracteres.Nombre de la vista.

Request > notifications > view

key

CadenaNo<= 512 caracteres.Ver clave. La clave que se configuró con la vista a través de la API.

Request > notifications > view

state

CadenaNoVer token de estado.

Nota: los siguientes caracteres son no se permiten para Request > notifications > mbox > name:

- '-, ./=`:;&!@#$%^&*()+|?~[]{}'

Llamada sendNotifications() después de procesar mboxes de recuperación previa

function createTokens(options) {
  return options.map(e => e.eventToken);
}

function createNotification(mbox, type, tokens) {
  const id = 11111; // here we should use a random ID like UUID
  const timestamp = Date.now();
  const { name, state, parameters, profileParameters, order, product } = mbox;
  const result = {
    id,
    type,
    timestamp,
    parameters,
    profileParameters,
    order,
    product
  };

  result.mbox = { name, state };
  result.tokens = tokens;

  return result;
}

adobe.target.getOffers({
  request: {
    prefetch: {
      mboxes: [
        {
          index: 0,
          name: "a1-serverside-ab"
        }
      ]
    }
  }
})
.then(response => {
  const mboxes = response.prefetch.mboxes;
  const notifications = mboxes.map(mbox => {
    const type = "display";
    const tokens = createTokens(mbox.options);

    return createNotification(mbox, type, tokens);
  });

  adobe.target.sendNotifications({
    request: { notifications }
  });
})
NOTE
Si está usando Adobe Analytics, getOffers() solo con recuperación previa y sendNotifications(), la solicitud Analytics debe activarse después de que se ejecute sendNotifications(). El propósito de esto es garantizar que el SDID generado por sendNotifications() coincida con el SDID enviado a Analytics y Target.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3