Adobe Target Bulk Profile Update API

Última actualización: 5 de mayo de 2025

Creado para:

  • Desarrollador

Adobe Target Bulk Profile Update API le permite actualizar los perfiles de usuario de varios visitantes de un sitio web de forma masiva mediante un archivo por lotes.

Con Bulk Profile Update API, puede enviar convenientemente datos detallados del perfil del visitante en forma de parámetros de perfil para muchos usuarios a Target desde cualquier origen externo. Las fuentes externas pueden incluir sistemas de administración de la relación con los clientes (CRM) o puntos de venta (POS), que normalmente no están disponibles en una página web.

VersiónEjemplo de URLFunciones
Versión 1http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdateSolo es compatible con la actualización de perfiles en lote.
Versión 2http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • Crear perfil si no se encuentra.
  • Actualización del estado por fila.
NOTE
Versión 2 (v2) de Bulk Profile Update API es la versión actual. Sin embargo, Target sigue siendo compatible con la versión 1 (v1).

Ventajas de la API de actualización de perfiles en lote

  • No hay ningún límite en la cantidad de atributos del perfil.
  • Los atributos de perfil enviados a través del sitio se pueden actualizar mediante la API y viceversa.

Advertencias

  • El tamaño del archivo en lote debe ser inferior a 50 MB. Además, el número total de filas no puede superar las 500 000 filas por carga.
  • Las actualizaciones suelen producirse en menos de una hora, pero pueden tardar hasta 24 horas en reflejarse.
  • No hay límite en el número o las filas que puede cargar durante un periodo de 24 horas en lotes posteriores. Sin embargo, el proceso de ingestión puede acelerarse durante el horario laboral para garantizar que otros procesos se ejecuten de forma eficaz.
  • Las llamadas de actualización por lotes v2 consecutivas sin llamadas de mbox intermedias para los mismos ID de terceros anulan las propiedades actualizadas en la primera llamada de actualización por lotes.
  • Adobe no garantiza que el 100% de los datos de perfil por lotes se incorporarán y conservarán en Target y, por lo tanto, estarán disponibles para su uso en la segmentación. En el diseño actual, existe la posibilidad de que un pequeño porcentaje de datos (hasta el 0,1 % de los lotes de producción grandes) no se incorpore o conserve.

Archivo por lotes

Para actualizar los datos de perfil de forma masiva, cree un archivo por lotes. El archivo por lotes es un archivo de texto con valores separados por comas similar al siguiente archivo de muestra.

\ batch=pcId,param1,param2,param3,param4\ 123,value1\ 124,value1,value4\ 125,value2\ 126,value1,value2,value3,value4\

NOTE
El parámetro batch= es obligatorio y debe especificarse al principio del archivo.

Hace referencia a este archivo en la llamada del POST a Target servidores para procesar el archivo. Al crear el archivo por lotes, tenga en cuenta lo siguiente:

  • La primera fila del archivo debe especificar encabezados de columna.
  • El primer encabezado debe ser un pcId o thirdPartyId. No se admite Marketing Cloud visitor ID. pcId es un visitorID generado por Target. thirdPartyId es un identificador especificado por la aplicación cliente, que se pasa a Target a través de una llamada de mbox como mbox3rdPartyId. Se debe hacer referencia a él aquí como thirdPartyId.
  • Los parámetros y valores especificados en el archivo por lotes deben estar codificados en URL mediante UTF-8 por motivos de seguridad. Los parámetros y valores se pueden reenviar a otros nodos perimetrales para su procesamiento mediante solicitudes HTTP.
  • Los parámetros sólo deben tener el formato paramName. Los parámetros se muestran en Target como profile.paramName.
  • Si usa Bulk Profile Update API v2, no es necesario especificar todos los valores de parámetro para cada pcId. Los perfiles se crean para cualquier pcId o mbox3rdPartyId que no se encuentre en Target. Si utiliza la versión 1, los perfiles no se crean para los pcIds o mbox3rdPartyIds que faltan.
  • El tamaño del archivo en lote debe ser inferior a 50 MB. Además, el número total de filas no debe superar los 500 000. Este límite garantiza que los servidores no se inunden con demasiadas solicitudes.
  • Puede enviar varios archivos. Sin embargo, la suma total de las filas de todos los archivos que envía en un día no debe superar un millón para cada cliente.
  • No hay restricciones en el número de atributos que se pueden cargar. Sin embargo, el tamaño total de los datos de perfil externos, que incluyen los atributos del cliente, la API del perfil, los parámetros de perfil In-Mbox y la salida del script de perfil, no debe superar los 64 KB.
  • Los parámetros y valores distinguen entre mayúsculas y minúsculas.